CreateDialogParam

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

HWND CreateDialogParam) 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 die Dialogfeldprozedur in den lParam -Parameter in der WM_INITDIALOG-Meldung übergeben.

Rückgabewerte

Wenn die Funktion erfolgreich ist, ist der Rückgabewert das Fensterhandle für das Dialogfeld.

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

Bemerkungen

Die CreateDialogParam -Funktion verwendet die CreateWindowEx -Funktion um das Dialogfeld zu erstellen. CreateDialogParam 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 an, wenn die Vorlage den WS_VISIBLE Stil gibt. Schließlich gibt die Fensterzugriffsnummer des Dialogfelds zurück CreateDialogParam.

Nachdem CreateDialogParam zurückgibt, zeigt die Anwendung das Dialogfeld (wenn es nicht bereits angezeigt wird) mit die ShowWindow -Funktion. Die Anwendung löscht das Dialogfeld mithilfe der Funktion DestroyWindow.

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, "createDialog", CreateDialogIndirect, CreateDialogIndirectParam, CreateWindowEx, DestroyWindow, DialogProc, MAKEINTRESOURCE, ShowWindow, WM_INITDIALOG, WM_SETFONT

Index