DialogBoxParam

Die DialogBoxParam -Funktion erstellt ein modales Dialogfeld aus einer Dialogfeldressource Vorlage. Vor dem Anzeigen des Dialogfelds, übergibt die Funktion einen anwendungsdefinierter Wert an die Dialogfeldprozedur als Parameter lParam der Nachricht WM_INITDIALOG . Eine Anwendung kann diesen Wert verwenden, Dialogfeld-Steuerelemente zu initialisieren.

Int DialogBoxParam) HINSTANCE  hInstance, / / handle für die AnwendungsinstanzLPCTSTRlpTemplateName, / / Dialogfeld Feld Vorlage identifiziertHWNDhWndParent, / / handle für Eigentümer FensterDLGPROClpDialogFunc, / / Zeiger auf Dialogfeld im Feld ProzedurLPARAMDwInitParam / / Initialisierungswert);
 

Parameter

hInstance

Identifiziert eine Instanz des Moduls deren ausführbare Datei das Dialogfeld Feld Vorlage enthält.

lpTemplateName

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.

dwInitParam

Gibt den Wert an das Dialogfeld in den lParam -Parameter der Nachricht WM_INITDIALOG übergeben.

Rückgabewerte

Wenn die Funktion erfolgreich ist, ist der Rückgabewert der Wert des Parameters nResult angegeben 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

Die DialogBoxParam -Funktion verwendet die CreateWindowEx -Funktion um das Dialogfeld zu erstellen. DialogBoxParam 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, DialogBoxParam zerstört das Dialogfeld, beendet 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 LpTemplateName .

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, CreateWindowEx, DialogBox, DialogBoxIndirect, DialogBoxIndirectParam, DialogProc, EndDialog, MAKEINTRESOURCE, WM_INITDIALOG, WM_SETFONT

Index