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.