Freigeben über


CColorDialog::DoModal

Rufen Sie diese Funktion auf, um das allgemeine Dialogfeld Windows anzuzeigen und dem Benutzer zu ermöglichen, eine Farbe auszuwählen.

virtual INT_PTR DoModal( );

Rückgabewert

IDOK oder IDCANCEL.Wenn IDCANCEL zurückgegeben wird, rufen Sie die Funktion Windows CommDlgExtendedError auf, um zu bestimmen, ob ein Fehler aufgetreten ist.

IDOK und IDCANCEL sind Konstanten, die angeben, ob der Benutzer OK oder die Abbruchschaltfläche ausgewählt hat.

Hinweise

Wenn verschiedene Farbendialogfeldoptionen initialisieren möchten, indem Sie Member der Struktur m_cc festlegen, sollten Sie dies tun, bevor Sie DoModal aufrufen, aber nach Dialogfeld wird das Objekt erstellt.

Nachdem Sie DoModal aufgerufen haben, können Sie andere Memberfunktionen aufrufen, um die Einstellungen oder die Informationseingabe vom Benutzer im Dialogfeld abzurufen.

Beispiel

Im Beispiel für CColorDialog::CColorDialog.

Anforderungen

Header: afxdlgs.h

Siehe auch

Referenz

CColorDialog-Klasse

Hierarchien-Diagramm

CDialog::DoModal

CColorDialog::CColorDialog