ChooseColor

Die ChooseColor -Funktion erstellt ein Farbe gemeinsames Dialogfeld, das dem Benutzer ermöglicht, eine Farbe auswählen.

BOOL ChooseColor) LPCHOOSECOLOR  Lpcc / / Zeiger auf die Struktur mit Initialisierung / / Daten);
 

Parameter

lpcc

Zeiger auf eine CHOOSECOLOR -Struktur, die Informationen verwendet, um das Dialogfeld zu initialisieren enthält. ChooseColor gibt diese Struktur enthält Informationen über die Auswahl des Benutzers Farbe.

Rückgabewerte

Wenn der Benutzer auf die Schaltfläche OK im Dialogfeld klickt, ist der Rückgabewert ungleich NULL. Der RgbResult -Member der CHOOSECOLOR -Struktur enthält den RGB-Wert der vom Benutzer ausgewählten Farbe.

Wenn der Benutzer abbricht oder schließt das Dialogfeld Farbe oder ein Fehler auftritt, ist der Rückgabewert 0 (null). Um erweiterte Fehlerinformationen abzurufen, rufen Sie die CommDlgExtendedError -Funktion, die einen der folgenden Werte zurückgeben, können:

Bemerkungen

Das Dialogfeld Farbe unterstützt keine Paletten. Die Farbauswahl im Dialogfeld angeboten sind die Systemfarben und gemischten Versionen von diesen Farben beschränkt.

Sie können eine CCHookProc -Hook-Prozedur für das Dialogfeld Farben bereitstellen. Die Hook-Prozedur kann Nachrichten gesendet, um das Dialogfeld verarbeiten. Um eine Hook-Prozedur zu aktivieren, legen Sie das CC_ENABLEHOOK-Flag in den Flags der CHOOSECOLOR -Struktur, und geben Sie die Adresse der die Hook-Prozedur in der LpfnHook -member.

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Version 2.0 oder höher erforderlich.
Header:In commdlg.h deklariert.
Importieren Bibliothek:Verwenden Sie comdlg32.lib.
Unicode:Als Unicode und ANSI-Versionen unter Windows NT implementiert.

Siehe auch

Allgemeine Dialogfeld-Bibliothek – Übersicht, Funktionen der Common Dialog Box, CCHookProc, CHOOSECOLOR, CommDlgExtendedError

Index