CHOOSECOLOR

Die CHOOSECOLOR -Struktur enthält Informationen, die die ChooseColor -Funktion verwendet, um das Dialogfeld Farbe häufig zu initialisieren. Nachdem der Benutzer das Dialogfeld geschlossen wurde, gibt das System Informationen über die Auswahl des Benutzers in dieser Struktur.

typedef Struct {/ / cc DWORD lStructSize; 
    HWND HwndOwner; 
    HWND hInstance; 
    COLORREF RgbResult; 
    COLORREF * LpCustColors; 
    DWORD Flags; 
    LPARAM lCustData; 
    LPCCHOOKPROC LpfnHook; 
    LPCTSTR LpTemplateName; 
} CHOOSECOLOR 

 

Mitglieder

lStructSize
Gibt die Länge in Bytes, der Struktur.
hwndOwner
Identifiziert das Fenster, das das Dialogfeld besitzt. Dieser Member kann gültiges Fensterhandle, oder es kann NULL sein, wenn das Dialogfeld keine Besitzer hat.
hInstance
Wenn das CC_ENABLETEMPLATEHANDLE-Flag in den Flags festgelegt ist, ist hInstance das Handle für ein Objekt mit eine Dialogfeldvorlage. Wenn das CC_ENABLETEMPLATE-Flag festgelegt ist, identifiziert hInstance ein Modul, das eine Dialogfeld Feld Vorlage mit dem Namen des Mitglieds LpTemplateName enthält. Wenn weder CC_ENABLETEMPLATEHANDLE noch CC_ENABLETEMPLATE festgelegt ist, wird dieses Element ignoriert.
rgbResult
Wenn das CC_RGBINIT-Flag festgelegt ist, gibt RgbResult die Farbe zunächst ausgewählt, wenn Sie das Dialogfeld erstellt wird. Wenn der angegebene Color-Wert nicht unter den verfügbaren Farben ist, wählt das System die nächstgelegene Volltonfarbe erhältlich. Wenn RgbResult 0 (null ist) oder CC_RGBINIT nicht festgelegt ist, ist die ursprünglich gewählte Farbe schwarz. Wenn der Benutzer auf die Schaltfläche OK klickt, gibt RgbResult die Auswahl des Benutzers Farbe.
lpCustColors
Zeiger auf ein Array von 16 COLORREF-Werten, die rot, grün und blau (RGB) Werte für die benutzerdefinierte Farbe enthalten Felder im Dialogfeld. Wenn der Benutzer diese Farben geändert wird, aktualisiert das System das Array mit den neuen RGB-Werten. Damit um neue benutzerdefinierte Farben zwischen Aufrufe der ChooseColor -Funktion zu erhalten, sollten Sie statische Speicher für das Array zuweisen.
Flaggen
Ein Satz von Bitflags, die Sie verwenden können, um das Dialogfeld Farbe häufig zu initialisieren. Wenn das Dialogfeld zurückgegeben wird, legt diese Flags an die Eingabe des Benutzers fest. Dieser Member kann eine Kombination der folgenden Flags sein:
Flagge Bedeutung
CC_ANYCOLOR Bewirkt, dass das Dialogfeld in den Grundfarben alle verfügbare Farben angezeigt.
CC_ENABLEHOOK Ermöglicht die Hook-Prozedur in der LpfnHook -Member der Struktur angegeben. Dieses Flag wird verwendet, nur, um das Dialogfeld zu initialisieren.
CC_ENABLETEMPLATE Gibt an, dass die hInstance und LpTemplateName Mitglieder eine Dialogfeld Feld Vorlage statt der Standardvorlage verwenden angeben. Dieses Flag wird verwendet, nur, um das Dialogfeld zu initialisieren.
CC_ENABLETEMPLATEHANDLE Gibt an, dass das hInstance Mitglied ein Datenblockes identifiziert, das eine vorgespannte Dialogfeld Feld Vorlage enthält. Das System ignoriert den LpTemplateName Member, wenn dieses Flag angegeben ist. Dieses Flag wird verwendet, nur, um das Dialogfeld zu initialisieren.
CC_FULLOPEN Bewirkt, dass das Dialogfeld die zusätzliche Steuerelemente anzuzeigen, die dem Benutzer ermöglichen, benutzerdefinierte Farben erstellen. Wenn dieses Flag nicht festgelegt ist, muss der Benutzer die SchaltflächebenutzerdefinierteFarbe definierenbenutzerdefinierte Farbe Steuerelemente anzeigen klicken. .
CC_PREVENTFULLOPEN Deaktiviert die Schaltfläche definierenbenutzerdefinierterFarben .
CC_RGBINIT Bewirkt, dass das Dialogfeld in die Farbe in den RgbResult als die erste Farbauswahl verwenden.
CC_SHOWHELP Bewirkt, dass das Dialogfeld die Schaltfläche Hilfe anzeigen. Das HwndOwner -Mitglied muss angeben, dass das Fenster die HELPMSGSTRING empfangen Nachrichten registriert, die im Dialogfeld sendet, wenn der Benutzer die Schaltfläche Hilfe klickt.
CC_SOLIDCOLOR Das Dialogfeld anzuzeigende nur Volltonfarben in den Grundfarben.

lCustData
Gibt anwendungsdefinierten Daten, die das System an die Hook-Prozedur durch das LpfnHook -Element identifiziert wird. Sendet das System die WM_INITDIALOG -Meldung an die Hook-Prozedur, ist die Nachricht lParam -Parameter ein Zeiger auf die Struktur der CHOOSECOLOR angegeben, wenn das Dialogfeld erstellt wurde. Die Hook-Prozedur können diesen Zeiger zum Abrufen des Werts lCustData.
lpfnHook
Zeiger auf ein CCHookProc Haken Verfahren, die Nachrichten für das Dialogfeld verarbeiten kann. Dieser Member wird ignoriert, es sei denn, das CC_ENABLEHOOK-Flag in den Flags gesetzt ist.
lpTemplateName
Zeiger auf eine auf Null endende Zeichenfolge, die Vorlage die Dialogfeldressource im Modul identifiziert das hInstance -Mitglied benennt. Diese Vorlage ist für das standard-Dialogfeld Feld Vorlage ersetzt. Für nummerierte Dialogfeld Feld Ressourcen können LpTemplateName einen Wert des Makros MAKEINTRESOURCE zurückgegeben werden. Dieser Member wird ignoriert, es sei denn, das CC_ENABLETEMPLATE-Flag in den Flags gesetzt ist.

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Version 1.0 oder höher benötigt.
Header:In commdlg.h deklariert.
Unicode:Als Unicode und ANSI Strukturen definiert.

Siehe auch

Übersicht über Common Dialog Box Library, gemeinsamen Dialog Box Strukturen, CCHookProc, ChooseColor, MAKEINTRESOURCE, WM_INITDIALOG