CColorDialog-Klasse

Artikel
02/26/2013

Ermöglicht es Ihnen, ein FarbeAuswahl Dialogfeld in Ihre Anwendung zu speichern.

class CColorDialog : public CCommonDialog

Mitglieder

Öffentliche Konstruktoren

Name	Description
CColorDialog::CColorDialog	Erstellt ein CColorDialog-Objekt.

Öffentliche Methoden

Name	Description
CColorDialog::DoModal	Zeigt ein Dialogfeld an und ermöglicht dem Benutzer, um die Auswahl zu machen.
CColorDialog::GetColor	Gibt eine COLORREF-Struktur zurück, die die Werte der ausgewählten Farbe enthält.
CColorDialog::GetSavedCustomColors	Ruft die benutzerdefinierten Farben ab, die vom Benutzer erstellt werden.
CColorDialog::SetCurrentColor	Erzwingt die aktuelle Farbauswahl der angegebenen Farbe.

Geschützte Methoden

Name	Description
CColorDialog::OnColorOK	Überschreiben Sie, um die Farbe zum Überprüfen des in das Dialogfeld.

Öffentliche Datenmember

Name	Description
CColorDialog::m_cc	Eine Struktur verwendet, um die Einstellungen des Dialogfelds anzupassen.

Hinweise

Ein Objekt CColorDialog ist ein Dialogfeld mit einer Liste von Farben, die für das Anzeigesystem definiert werden.Der Benutzer kann eine bestimmte Farbe aus der Liste auswählen oder erstellen, die dann an die Anwendung ausgegeben wird, wenn das Dialogfeld beendet.

So fügen Sie ein CColorDialog-Objekt erstellen, den bereitgestellten Konstruktor verwenden oder eine neue Klasse ableiten und den eigenen benutzerdefinierten Konstruktor verwenden.

Wenn das Dialogfeld erstellt wurde, können Sie alle Werte in der m_cc-Struktur festlegen oder ändern, um die Werte der Steuerelemente des Dialogfelds zu initialisieren.Die m_cc-Struktur ist vom Typ CHOOSECOLOR.

Nachdem Sie die Steuerelemente des Dialogfelds initialisiert haben, rufen Sie die DoModal-Memberfunktion auf, um das Dialogfeld anzuzeigen und dem Benutzer zu ermöglichen, eine Farbe auszuwählen.DoModal gibt die Auswahl des Benutzers entweder OK des Dialogfelds (IDOK) oder von Schaltfläche Löschverhalten (IDCANCEL) zurück.

Wenn DoModalIDOK zurückgibt, können Sie eine der Memberfunktionen von CColorDialog verwenden, um die Informationseingabe durch den Benutzer abzurufen.

Sie können die Funktion Windows CommDlgExtendedError verwenden, um mehr über den Fehler zu ermitteln, ob ein Fehler aufgetreten ist während der Initialisierung des Dialogfelds und zu erfahren.

CColorDialog beruht auf der COMMDLG.DLL-Datei, die mit Windows-Versionen 3,1 und höher bereitgestellt wird.

Um das Dialogfeld anzupassen, leiten Sie eine Klasse von CColorDialog, erstellen Sie eine benutzerdefinierte Dialogfeldvorlage, und fügen Sie eine Meldungszuordnung hinzu um die Benachrichtigungsmeldungen aus den erweiterten - Steuerelementen verarbeiten.Alle nicht verarbeiteten Nachrichten sollten die Basisklasse übergeben werden.

Die Hookfunktion anzupassen ist nicht erforderlich.

Hinweis
Bei einigen Installationen wird das CColorDialog-Objekt nicht mit einem grauen Hintergrund angezeigt, wenn Sie das Framework verwendet haben, um andere CDialog-Objektgrau auszuführen.