ColorDialog Класс

Определение

Пространство имен:: System.Windows.Forms

Сборка:: System.Windows.Forms.dll

Исходный код:: ColorDialog.cs

Исходный код:: ColorDialog.cs

Исходный код:: ColorDialog.cs

Исходный код:: ColorDialog.cs

Исходный код:: ColorDialog.cs

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет общее диалоговое окно, отображающее доступные цвета вместе с элементами управления, которые позволяют пользователю определять пользовательские цвета.

public ref class ColorDialog : System::Windows::Forms::CommonDialog

public class ColorDialog : System.Windows.Forms.CommonDialog

type ColorDialog = class
    inherit CommonDialog

Public Class ColorDialog
Inherits CommonDialog

Наследование: Object

MarshalByRefObject

Component

CommonDialog
ColorDialog

Примеры

В следующем примере показано создание нового ColorDialog. В этом примере требуется, чтобы метод вызывался из существующей формы, имеющей и TextBox помещенной на нееButton.

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      ColorDialog^ MyDialog = gcnew ColorDialog;
      // Keeps the user from selecting a custom color.
      MyDialog->AllowFullOpen = false;
      // Allows the user to get help. (The default is false.)
      MyDialog->ShowHelp = true;
      // Sets the initial color select to the current text color.
      MyDialog->Color = textBox1->ForeColor;
      
      // Update the text box color if the user clicks OK 
      if ( MyDialog->ShowDialog() == ::System::Windows::Forms::DialogResult::OK )
      {
         textBox1->ForeColor = MyDialog->Color;
      }
   }

private void button1_Click(object sender, System.EventArgs e)
 {
    ColorDialog MyDialog = new ColorDialog();
    // Keeps the user from selecting a custom color.
    MyDialog.AllowFullOpen = false ;
    // Allows the user to get help. (The default is false.)
    MyDialog.ShowHelp = true ;
    // Sets the initial color select to the current text color.
    MyDialog.Color = textBox1.ForeColor ;
    
    // Update the text box color if the user clicks OK 
    if (MyDialog.ShowDialog() == DialogResult.OK)
        textBox1.ForeColor =  MyDialog.Color;
 }

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
    Dim MyDialog As New ColorDialog()
    ' Keeps the user from selecting a custom color.
    MyDialog.AllowFullOpen = False
    ' Allows the user to get help. (The default is false.)
    MyDialog.ShowHelp = True
    ' Sets the initial color select to the current text color,
    MyDialog.Color = TextBox1.ForeColor

    ' Update the text box color if the user clicks OK 
    If (MyDialog.ShowDialog() = DialogResult.OK) Then
        TextBox1.ForeColor = MyDialog.Color
    End If
End Sub

Для создания этого конкретного общего диалогового окна необходимо вызвать унаследованный элемент ShowDialog . HookProc можно переопределить для реализации определенных функций перехватчика диалогового окна. Используется Color для получения цвета, выбранного пользователем.

При создании экземпляра ColorDialogнекоторые свойства чтения и записи задаются для начальных значений. Список этих значений см. в конструкторе ColorDialog .

Конструкторы

Имя	Описание
ColorDialog()	Инициализирует новый экземпляр класса ColorDialog.

Свойства

Имя	Описание
AllowFullOpen	Возвращает или задает значение, указывающее, может ли пользователь использовать диалоговое окно для определения пользовательских цветов.
AnyColor	Возвращает или задает значение, указывающее, отображает ли диалоговое окно все доступные цвета в наборе основных цветов.
CanRaiseEvents	Возвращает значение, указывающее, может ли компонент вызвать событие. (Унаследовано от Component)
Color	Возвращает или задает цвет, выбранный пользователем.
Container	Возвращает объект IContainer , содержащий Componentобъект . (Унаследовано от Component)
CustomColors	Возвращает или задает набор настраиваемых цветов, отображаемых в диалоговом окне.
DesignMode	Возвращает значение, указывающее, находится ли текущий Component режим разработки. (Унаследовано от Component)
Events	Возвращает список обработчиков событий, подключенных к этому Component. (Унаследовано от Component)
FullOpen	Возвращает или задает значение, указывающее, отображаются ли элементы управления, используемые для создания пользовательских цветов при открытии диалогового окна.
Instance	Возвращает дескриптор базового экземпляра окна (HINSTANCE).
Options	Возвращает значения для инициализации ColorDialog.
ShowHelp	Возвращает или задает значение, указывающее, отображается ли кнопка справки в диалоговом окне цвета.
Site	Возвращает или задает ISite объект Component. (Унаследовано от Component)
SolidColorOnly	Возвращает или задает значение, указывающее, будет ли диалоговое окно ограничивать пользователей только выбором сплошных цветов.
Tag	Возвращает или задает объект, содержащий данные об элементе управления. (Унаследовано от CommonDialog)

Методы

Имя	Описание
CreateObjRef(Type)	Создает объект, содержащий все соответствующие сведения, необходимые для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
Dispose()	Освобождает все ресурсы, используемые параметром Component. (Унаследовано от Component)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые Component и при необходимости освобождает управляемые ресурсы. (Унаследовано от Component)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetLifetimeService()	Устаревшие. Извлекает текущий объект службы времени существования, который управляет политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
GetService(Type)	Возвращает объект, представляющий службу, предоставляемую Component или ее Container. (Унаследовано от Component)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Определяет общую процедуру перехватчика диалогового окна, переопределенную для добавления определенных функций в общее диалоговое окно. (Унаследовано от CommonDialog)
InitializeLifetimeService()	Устаревшие. Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
MemberwiseClone(Boolean)	Создает неглубокую копию текущего MarshalByRefObject объекта. (Унаследовано от MarshalByRefObject)
OnHelpRequest(EventArgs)	Вызывает событие HelpRequest. (Унаследовано от CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Определяет процедуру окна владельца, переопределенную для добавления определенных функций в общее диалоговое окно. (Унаследовано от CommonDialog)
Reset()	Сбрасывает все параметры в значения по умолчанию, последний выбранный цвет на черный и настраиваемые цвета в значения по умолчанию.
RunDialog(IntPtr)	При переопределении в производном классе задает общее диалоговое окно.
ShowDialog()	Запускает общее диалоговое окно с владельцем по умолчанию. (Унаследовано от CommonDialog)
ShowDialog(IWin32Window)	Запускает общее диалоговое окно с указанным владельцем. (Унаследовано от CommonDialog)
ToString()	Возвращает строку, представляющую ColorDialog.

События

Имя	Описание
Disposed	Происходит при удалении компонента вызовом Dispose() метода. (Унаследовано от Component)
HelpRequest	Происходит, когда пользователь нажимает кнопку справки в общем диалоговом окне. (Унаследовано от CommonDialog)

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

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

CommonDialog

Обратная связь

Были ли сведения на этой странице полезными?