ColorDialog Класс

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

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

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. В этом примере требуется, чтобы метод вызывался из существующей формы, имеющей и Button помещенной TextBox в нее.

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() = Windows.Forms.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