ColorDialog Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Stellt ein Standarddialogfeld dar, in dem die verfügbaren Farben angezeigt werden sowie Steuerelemente, mit denen Benutzer benutzerdefinierte Farben definieren können.

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

Vererbung

Object

MarshalByRefObject

Component

CommonDialog

ColorDialog

Beispiele

Im folgenden Beispiel wird die Erstellung eines neuen ColorDialogveranschaulicht. In diesem Beispiel muss die -Methode innerhalb eines vorhandenen Formulars TextBox aufgerufen und Button darauf platziert werden.

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

Hinweise

Das geerbte Element ShowDialog muss aufgerufen werden, um dieses bestimmte allgemeine Dialogfeld zu erstellen. HookProc kann überschrieben werden, um bestimmte Hookfunktionen für Dialogfelder zu implementieren. Verwenden Sie Color , um die vom Benutzer ausgewählte Farbe abzurufen.

Wenn Sie eine instance von ColorDialogerstellen, werden einige der Lese-/Schreibeigenschaften auf Anfangswerte festgelegt. Eine Liste dieser Werte finden Sie im ColorDialog Konstruktor.

Konstruktoren

ColorDialog()

Initialisiert eine neue Instanz der ColorDialog-Klasse.

Eigenschaften

AllowFullOpen	Ruft einen Wert ab, der angibt, ob im Dialogfeld benutzerdefinierte Farben definiert werden können, oder legt diesen fest.
AnyColor	Ruft einen Wert ab, der angibt, ob im Dialogfeld bei den Grundfarben alle verfügbaren Farben angezeigt werden, oder legt diesen fest.
CanRaiseEvents	Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component)
Color	Ruft die von den Benutzern ausgewählte Farbe ab oder legt diese fest.
Container	Ruft die IContainer ab, die in der Component enthalten ist. (Geerbt von Component)
CustomColors	Ruft den im Dialogfeld angezeigten Satz benutzerdefinierter Farben ab oder legt diesen fest.
DesignMode	Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet. (Geerbt von Component)
Events	Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind. (Geerbt von Component)
FullOpen	Ruft einen Wert ab, der angibt, ob die Steuerelemente für das Erstellen benutzerdefinierter Farben beim Öffnen des Dialogfelds angezeigt werden, oder legt diesen fest.
Instance	Ruft das zugrunde liegende Fensterinstanzhandle (HINSTANCE) ab.
Options	Ruft Werte für die Initialisierung von ColorDialog ab.
ShowHelp	Ruft einen Wert ab, der angibt, ob im Farbendialogfeld eine Hilfeschaltfläche angezeigt wird, oder legt diesen Wert fest.
Site	Ruft den ISite von Component ab oder legt ihn fest. (Geerbt von Component)
SolidColorOnly	Ruft einen Wert ab, der angibt, ob Benutzer im Dialogfeld ausschließlich Volltonfarben auswählen können, oder legt diesen fest.
Tag	Ruft ein Objekt ab, das Daten bezüglich des Steuerelements enthält, oder legt dieses Objekt fest. (Geerbt von CommonDialog)

Methoden

CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
Dispose()	Gibt alle vom Component verwendeten Ressourcen frei. (Geerbt von Component)
Dispose(Boolean)	Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von Component)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetService(Type)	Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt. (Geerbt von Component)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definiert die Hookprozedur für Standarddialogfelder, die überschrieben wird, um einem Standarddialogfeld spezifische Funktionen hinzuzufügen. (Geerbt von CommonDialog)
InitializeLifetimeService()	Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
OnHelpRequest(EventArgs)	Löst das HelpRequest-Ereignis aus. (Geerbt von CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definiert die Prozedur des Besitzerfensters, die überschrieben wird, um einem Standarddialogfeld spezifische Funktionen hinzuzufügen. (Geerbt von CommonDialog)
Reset()	Setzt alle Optionen auf die Standardwerte zurück, die zuletzt ausgewählte Farbe auf Schwarz und die benutzerdefinierten Farben auf die Standardwerte.
RunDialog(IntPtr)	Wenn dies in einer abgeleiteten Klasse überschrieben wird, wird hierdurch ein Standarddialogfeld angegeben.
ShowDialog()	Führt ein Standarddialogfeld mit einem Standardbesitzer aus. (Geerbt von CommonDialog)
ShowDialog(IWin32Window)	Führt ein Standarddialogfeld mit dem angegebenen Besitzer aus. (Geerbt von CommonDialog)
ToString()	Gibt eine Zeichenfolge zurück, die den ColorDialog darstellt.

Ereignisse

Disposed	Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird. (Geerbt von Component)
HelpRequest	Tritt ein, wenn der Benutzer in einem Standarddialogfeld auf die Hilfeschaltfläche klickt. (Geerbt von CommonDialog)

Weitere Informationen

• CommonDialog