ColorDialog.CustomColors Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece el conjunto de colores personalizados que se muestran en el cuadro de diálogo.

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()

Valor de propiedad

Int32[]

Conjunto de colores personalizados mostrados en el cuadro de diálogo. El valor predeterminado es null.

Atributos

BrowsableAttribute

Ejemplos

En el ejemplo de código siguiente se muestra cómo agregar una matriz de tipo Int32 que representa colores personalizados a CustomColors. En este ejemplo se requiere que el código se ejecute desde dentro de .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

Comentarios

Los usuarios pueden crear su propio conjunto de colores personalizados. Estos colores están contenidos en un Int32 compuesto por los valores BGR (azul, verde, rojo) necesarios para crear el color. Para obtener más información sobre la estructura de estos datos, vea Color.

Los colores personalizados solo se pueden definir si AllowFullOpen se establece en true.

Consulte también

• AnyColor