ColorDialog.CustomColors Свойство

Определение

Возвращает или задает набор настраиваемых цветов, отображаемых в диалоговом окне.

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

Значение свойства

Int32[]

Набор настраиваемых цветов, отображаемых диалоговым окном. Значение по умолчанию — null.

Атрибуты

Примеры

В следующем примере кода показано, как добавить массив типа Int32 , представляющего настраиваемые CustomColorsцвета. В этом примере требуется, чтобы код выполнялся из элемента 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

Комментарии

Пользователи могут создавать собственный набор пользовательских цветов. Эти цвета содержатся в Int32 составе значений BGR (синий, зеленый, красный), необходимых для создания цвета. Дополнительные сведения о структуре этих данных см. в разделе Color.

Пользовательские цвета можно определить только в том случае, если AllowFullOpen задано значение true.

Применяется к

См. также раздел