ColorDialog Klasa

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Reprezentuje typowe okno dialogowe, które wyświetla dostępne kolory wraz z kontrolkami, które umożliwiają użytkownikowi definiowanie kolorów niestandardowych.

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

Dziedziczenie

Object

MarshalByRefObject

Component

CommonDialog

ColorDialog

Przykłady

W poniższym przykładzie przedstawiono tworzenie nowego ColorDialogelementu . Ten przykład wymaga wywołania metody z poziomu istniejącego formularza, który ma element TextBox i Button umieszczony na nim.

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

Uwagi

Aby utworzyć to typowe okno dialogowe, należy wywołać dziedziczony element członkowski ShowDialog . HookProc można zastąpić w celu zaimplementowania określonych funkcji zaczepienia okna dialogowego. Użyj Color polecenia , aby pobrać kolor wybrany przez użytkownika.

Podczas tworzenia wystąpienia programu ColorDialogniektóre właściwości odczytu/zapisu są ustawione na wartości początkowe. Aby uzyskać listę tych wartości, zobacz ColorDialog konstruktor.

Konstruktory

ColorDialog()

Inicjuje nowe wystąpienie klasy ColorDialog.

Właściwości

AllowFullOpen	Pobiera lub ustawia wartość wskazującą, czy użytkownik może używać okna dialogowego do definiowania kolorów niestandardowych.
AnyColor	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe wyświetla wszystkie dostępne kolory w zestawie kolorów podstawowych.
CanRaiseEvents	Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component)
Color	Pobiera lub ustawia kolor wybrany przez użytkownika.
Container	Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
CustomColors	Pobiera lub ustawia zestaw kolorów niestandardowych wyświetlanych w oknie dialogowym.
DesignMode	Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component)
Events	Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu . (Odziedziczone po Component)
FullOpen	Pobiera lub ustawia wartość wskazującą, czy kontrolki używane do tworzenia kolorów niestandardowych są widoczne po otwarciu okna dialogowego.
Instance	Pobiera uchwyt wystąpienia okna bazowego (HINSTANCE).
Options	Pobiera wartości w celu zainicjowania elementu ColorDialog.
ShowHelp	Pobiera lub ustawia wartość wskazującą, czy przycisk Pomoc jest wyświetlany w oknie dialogowym koloru.
Site	Pobiera lub ustawia ISite element .Component (Odziedziczone po Component)
SolidColorOnly	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe ograniczy użytkowników tylko do wybierania kolorów stałych.
Tag	Pobiera lub ustawia obiekt zawierający dane dotyczące kontrolki. (Odziedziczone po CommonDialog)

Metody

CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszelkie zasoby używane przez element Component. (Odziedziczone po Component)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po Component)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetService(Type)	Zwraca obiekt reprezentujący usługę dostarczaną przez Component obiekt lub przez obiekt Container. (Odziedziczone po Component)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definiuje wspólną procedurę zaczepienia okna dialogowego, która jest zastępowana w celu dodania określonych funkcji do wspólnego okna dialogowego. (Odziedziczone po CommonDialog)
InitializeLifetimeService()	Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
OnHelpRequest(EventArgs)	HelpRequest Zgłasza zdarzenie. (Odziedziczone po CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definiuje procedurę okna właściciela, która jest zastępowana, aby dodać określone funkcje do wspólnego okna dialogowego. (Odziedziczone po CommonDialog)
Reset()	Resetuje wszystkie opcje do ich wartości domyślnych, ostatni wybrany kolor na czarny i kolory niestandardowe do ich wartości domyślnych.
RunDialog(IntPtr)	W przypadku zastąpienia w klasie pochodnej określa wspólne okno dialogowe.
ShowDialog()	Uruchamia wspólne okno dialogowe z domyślnym właścicielem. (Odziedziczone po CommonDialog)
ShowDialog(IWin32Window)	Uruchamia wspólne okno dialogowe z określonym właścicielem. (Odziedziczone po CommonDialog)
ToString()	Zwraca ciąg reprezentujący ColorDialogelement .

Zdarzenia

Disposed	Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody . (Odziedziczone po Component)
HelpRequest	Występuje, gdy użytkownik kliknie przycisk Pomoc w typowym oknie dialogowym. (Odziedziczone po CommonDialog)

Zobacz też

• CommonDialog