CColorDialog

Die CColorDialog -Klasse können Sie ein Farbauswahl Dialogfeld in Ihre Anwendung integrieren. Ein CColorDialog -Objekt ist ein Dialogfenster mit einer Liste der Farben, die für das Displaysystem definiert sind. Der Benutzer kann auswählen oder erstellen eine bestimmte Farbe aus der Liste, die dann zurück an die Anwendung gemeldet wird, wenn das Dialogfeld geschlossen wird.

Um ein CColorDialog -Objekt zu erstellen, verwenden Sie den bereitgestellten Konstruktor oder leiten Sie eine neue Klasse ab und verwenden Sie Ihre eigenen benutzerdefinierten Konstruktor.

Sobald das Dialogfeld erstellt wurde, können Sie festlegen oder Ändern der Werte in die M_cc -Struktur, die die Werte der Steuerelemente des Dialogfelds zu initialisieren. Die M_cc -Struktur ist der Typ CHOOSECOLOR.

Nach dem Initialisieren der Steuerelemente des Dialogfelds, rufen Sie die Memberfunktion DoModal zum Anzeigen des Dialogfelds und erlauben dem Benutzer, eine Farbe auszuwählen. DoModal gibt die Auswahl des Benutzers im Dialogfeld OK (IDOK) oder Abbrechen (IDCANCEL).

Wenn DoModal IDOKzurückgibt, können Sie eine der CColorDialogMemberfunktionen verwenden, zum Abrufen der vom Benutzer eingegebenen Informationen.

Sie können die Windows CommDlgExtendedError Funktion zu bestimmen, ob Fehler während der Initialisierung des Dialogfelds und erfahren Sie mehr über den Fehler.

CColorDialog beruht auf der COMMDLG.DLL-Datei, das im Lieferumfang von Windows 3.1 und höher.

Wenn das Dialogfeld anpassen möchten, leiten Sie eine Klasse von CColorDialog, bieten eine benutzerdefinierte Dialogfeldvorlage und Hinzufügen einer Meldungszuordnung zu der erweiterten Steuerelemente die Benachrichtigungsmeldungen zu verarbeiten. Alle nicht verarbeiteten Nachrichten sollten an die Basisklasse übergeben werden.

Anpassen der Hook-Funktion ist nicht erforderlich.

Hinweis&Nbsp;  Bei einigen Installationen wird das CColorDialog -Objekt nicht mit einem grauen Hintergrund angezeigt, wenn Sie das Framework verwendet haben, zu anderen CDialog Objekte grau.

Weitere Informationen zur Verwendung von CColorDialog, finden Sie unter Common Dialog-Klassen in Visual C++ Programmer's Guide.

# include lt;afxdlgs.h>

Klasse&nmember |nbsp; Basisklasse | Hierarchiediagramm

Proben&Nbsp; MFC Sample MDI | MFC-Beispiel DRAWCLI

Index