ColorDialog.CustomColors Eigenschaft

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Quelle:
ColorDialog.cs
Quelle:
ColorDialog.cs
Quelle:
ColorDialog.cs
Quelle:
ColorDialog.cs
Quelle:
ColorDialog.cs

Dient zum Abrufen oder Festlegen des Satzes von benutzerdefinierten Farben, die im Dialogfeld angezeigt werden.

public:
 property cli::array <int> ^ CustomColors { cli::array <int> ^ get(); void set(cli::array <int> ^ value); };
[System.ComponentModel.Browsable(false)]
public int[] CustomColors { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.CustomColors : int[] with get, set
Public Property CustomColors As Integer()

Eigenschaftswert

Int32[]

Eine Reihe von benutzerdefinierten Farben, die im Dialogfeld angezeigt werden. Der Standardwert ist null.

Attribute
BrowsableAttribute

Beispiele

Das folgende Codebeispiel zeigt, wie Sie ein Array vom Typ Int32 hinzufügen, das CustomColorsbenutzerdefinierte Farben darstellt. Dieses Beispiel erfordert, dass der Code innerhalb einer Form.

System::Windows::Forms::ColorDialog^ MyDialog = gcnew ColorDialog;

// Allows the user to select or edit a custom color.
MyDialog->AllowFullOpen = true;

// Assigns an array of custom colors to the CustomColors property
array<int>^temp0 = {6916092,15195440,16107657,1836924,3758726,12566463,7526079,7405793,6945974,241502,2296476,5130294,3102017,7324121,14993507,11730944};
MyDialog->CustomColors = temp0;

// Allows the user to get help. (The default is false.)
MyDialog->ShowHelp = true;

// Sets the initial color select to the current text color,
// so that if the user cancels out, the original color is restored.
MyDialog->Color = this->BackColor;
MyDialog->ShowDialog();
this->BackColor = MyDialog->Color;

System.Windows.Forms.ColorDialog MyDialog = new ColorDialog();
// Allows the user to select or edit a custom color.
MyDialog.AllowFullOpen = true ;
// Assigns an array of custom colors to the CustomColors property
MyDialog.CustomColors = new int[]{6916092, 15195440, 16107657, 1836924,
   3758726, 12566463, 7526079, 7405793, 6945974, 241502, 2296476, 5130294,
   3102017, 7324121, 14993507, 11730944,};

// Allows the user to get help. (The default is false.)
MyDialog.ShowHelp = true ;
// Sets the initial color select to the current text color,
// so that if the user cancels out, the original color is restored.
MyDialog.Color = this.BackColor;
MyDialog.ShowDialog();
this.BackColor =  MyDialog.Color;

Dim MyDialog = New ColorDialog()
' Allows the user to select or edit a custom color.
MyDialog.AllowFullOpen = True
' Assigns an array of custom colors to the CustomColors property.
MyDialog.CustomColors = New Integer() {6916092, 15195440, 16107657, 1836924, _
   3758726, 12566463, 7526079, 7405793, 6945974, 241502, 2296476, 5130294, _
   3102017, 7324121, 14993507, 11730944}

' Allows the user to get help. (The default is false.)
MyDialog.ShowHelp = True
' Sets the initial color select to the current text color,
' so that if the user cancels out, the original color is restored.
MyDialog.Color = Me.BackColor
MyDialog.ShowDialog()
Me.BackColor = MyDialog.Color

Hinweise

Benutzer können einen eigenen Satz von benutzerdefinierten Farben erstellen. Diese Farben sind in einer Int32 Mischung aus den BGR-Werten (Blau, Grün, Rot) enthalten, die zum Erstellen der Farbe erforderlich sind. Weitere Informationen zur Struktur dieser Daten finden Sie unter Color.

Benutzerdefinierte Farben können nur definiert werden, wenn AllowFullOpen sie auf true.

Gilt für:

Weitere Informationen