Freigeben über


CSimpleDialog-Klasse

Diese Klasse implementiert ein einfaches modales Dialogfeld.

Syntax

template <WORD t_wDlgTemplateID, BOOL t_bCenter = TRUE>
class CSimpleDialog : public CDialogImplBase

Parameter

t_wDlgTemplateID

Die Ressourcen-ID der Dialogvorlagenressource.

t_bCenter
TRUE, wenn das Dialogobjekt im Besitzerfenster zentriert werden soll; andernfalls FALSE.

Member

Öffentliche Methoden

Name Beschreibung
CSimpleDialog::D oModal Erstellt ein modales Dialogfeld.

Hinweise

Implementiert ein modales Dialogfeld mit grundlegenden Funktionen. CSimpleDialog bietet nur Unterstützung für allgemeine Windows-Steuerelemente. Um ein modales Dialogfeld zu erstellen und anzuzeigen, erstellen Sie eine Instanz dieser Klasse, und geben Sie den Namen einer vorhandenen Ressourcenvorlage für das Dialogfeld an. Das Dialogfeldobjekt wird geschlossen, wenn der Benutzer auf ein beliebiges Steuerelement mit einem vordefinierten Wert klickt (z. B. IDOK oder IDCANCEL).

CSimpleDialog ermöglicht ihnen, nur modale Dialogfelder zu erstellen. CSimpleDialog stellt die Dialogfeldprozedur bereit, die die Standardmeldungszuordnung verwendet, um Nachrichten an die entsprechenden Handler zu leiten.

Weitere Informationen finden Sie unter Implementieren eines Dialogfelds .

Vererbungshierarchie

CDialogImplBase

CSimpleDialog

Anforderungen

Kopfzeile: atlwin.h

CSimpleDialog::D oModal

Ruft ein modales Dialogfeld auf und gibt das Ergebnis des Dialogfelds zurück, wenn sie fertig sind.

INT_PTR DoModal(HWND hWndParent = ::GetActiveWindow());

Parameter

hWndParent
Ein Handle für das übergeordnete Element des Dialogfelds. Wenn kein Wert angegeben wird, wird das übergeordnete Element auf das aktuelle aktive Fenster festgelegt.

Rückgabewert

Bei erfolgreicher Ausführung ist der Rückgabewert die Ressourcen-ID des Steuerelements, das das Dialogfeld geschlossen hat.

Wenn die Funktion fehlschlägt, lautet der Rückgabewert -1. Um erweiterte Fehlerinformationen abzurufen, rufen Sie GetLastError auf.

Hinweise

Diese Methode behandelt alle Interaktionen mit dem Benutzer, während das Dialogfeld aktiv ist. Dies macht das Dialogfeld modal; d. h. der Benutzer kann erst dann mit anderen Fenstern interagieren, wenn das Dialogfeld geschlossen wird.

Siehe auch

Klassenübersicht