DialogBox

Das DialogBox Makro erstellt ein modales Dialogfeld aus einer Dialogfeldressource Vorlage. DialogBox gibt keine Kontrolle zurück, bis die angegebene Rückruffunktion des modalen Dialogfelds wird beendet durch die EndDialog -Funktion aufrufen. Das DialogBox Makro verwendet die DialogBoxParam -Funktion.

Int DialogBox) HINSTANCE  hInstance, / / handle für die AnwendungsinstanzLPCTSTRlpTemplate, / / Dialogfeld Feld Vorlage identifiziert HWNDhWndParent, / / handle für Eigentümer FensterDLGPROCLpDialogFunc / / Zeiger auf Dialogfeld im Feld Prozedur);
 

Parameter

hInstance
Identifiziert eine Instanz des Moduls deren ausführbare Datei das Dialogfeld Feld Vorlage enthält.
lpTemplate
Das Dialogfeld Feld Vorlage identifiziert. Dieser Parameter ist entweder der Zeiger auf eine Null-terminierte Zeichenfolge, die gibt den Namen der das Dialogfeld Feld Vorlage oder einen ganzzahligen Wert, der angibt, den Ressourcenbezeichner der Dialogfeldvorlage. Wenn der Parameter einen Ressourcenbezeichner gibt, höherwertigen Wort muss 0 (null) und niedrigwertigen Wort muss den Bezeichner enthalten. Das MAKEINTRESOURCE -Makro können Sie diese Werte schaffen.
hWndParent
Identifiziert das Fenster, das das Dialogfeld besitzt.
lpDialogFunc
Zeiger auf das Dialogfeld Feld Verfahren. Weitere Informationen über das Dialogfeld Feld Verfahren finden Sie unter DialogProc.

Rückgabewerte

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die nResult -Parameter im Aufruf an die EndDialog -Funktion verwendet, um das Dialogfeld zu beenden.

Wenn die Funktion fehlschlägt, ist der Rückgabewert – 1. Rufen Sie Fehlerinformationen verlängert bekommen, GetLastError.

Bemerkungen

Das DialogBox Makro verwendet die CreateWindowEx -Funktion um das Dialogfeld zu erstellen. DialogBox sendet dann eine WM_INITDIALOG-Meldung (und eine WM_SETFONT-Nachricht) Wenn die Vorlage die Style DS_SETFONT gibt an die Dialogfeldprozedur. Die Funktion zeigt das Dialogfeld (unabhängig davon, ob die Vorlage den Style WS_VISIBLE gibt), deaktiviert das Besitzerfenster und beginnt seine eigene Meldungsschleife abrufen und Versenden von Nachrichten für das Dialogfeld.

Wenn die Dialogfeldprozedur die EndDialog -Funktion aufruft, DialogBox das Dialogfeld zerstört, endet die Meldungsschleife, ermöglicht das Besitzerfenster (falls zuvor aktiviert) und gibt nResult Parameter, die durch die Dialogfeldprozedur wenn es EndDialog aufgerufen.

Windows 95 und höher:Das System unterstützt maximal 255 Steuerelemente pro Dialogfeld Feld Vorlage. Wenn Sie mehr als 255 Steuerelemente in einem Dialogfeld platzieren, erstellen Sie die Steuerelemente in der WM_INITDIALOG-Meldungshandler anstatt platzieren sie in der Vorlage.

Windows CE: Nicht alle Formate werden unterstützt in der DLGTEMPLATE Struktur in das Dialogfeldvorlage Parameter verweist die LpTemplate .

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Version 1.0 oder höher benötigt.
Header:In winuser.h deklarierten.
Importieren Bibliothek:Verwenden Sie user32.lib.
Unicode:Als Unicode und ANSI-Versionen unter Windows NT implementiert.

Siehe auch

Übersicht über Dialogfelder, Dialogfeld Feld Funktionen, CreateDialog, CreateWindowEx, DialogBoxIndirect, DialogBoxIndirectParam, DialogBoxParam, DialogProc, EndDialog, MAKEINTRESOURCE, WM_INITDIALOG, WM_SETFONT

Index