Freigeben über


AtlAxDialogBox

Stellt ein modales Dialogfeld aus einer Dialogfeldvorlage erstellt, die vom Benutzer bereitgestellt wird.

Wichtiger HinweisWichtig

Diese Funktion kann nicht in den Anwendungen verwendet werden, die in Windows-Runtime ausführen.

ATLAPI_(int) AtlAxDialogBox(
HINSTANCE hInstance,
LPCWSTR lpTemplateName,
HWND hWndParent,
DLGPROC lpDialogProc,
LPARAM dwInitParam 
);

Parameter

  • hInstance
    [in] Identifiziert eine Instanz des Moduls, dessen ausführbare Datei die Dialogfeldvorlage enthält.

  • lpTemplateName
    [in] Identifiziert die Dialogfeldvorlage.Dieser Parameter ist jeder der Zeiger auf eine auf NULL endende Zeichenfolge, die den Namen der Dialogfeldvorlage oder des ganzzahligen Werts angibt, der den Ressourcenbezeichner der Dialogfeldvorlage angibt.Wenn der Parameter einen Ressourcenbezeichner angibt, muss sein höherwertiges Wort null sein und sein niederwertiges Wort muss den Bezeichner enthalten.Sie können das MAKEINTRESOURCE-Makro verwenden, um diesen Wert zu erstellen.

  • hWndParent
    [in] Identifiziert das Fenster, das das Dialogfeld besitzt.

  • lpDialogProc
    [in] zeigt auf die Dialogfeldprozedur.Weitere Informationen über die Dialogfeldprozedur, finden Sie unter DialogProc.

  • dwInitParam
    [in] gibt den Wert an, um zum Dialogfeld im lParam-Parameter der WM_INITDIALOG Meldung zu übergeben.

Rückgabewert

Einer der Werte des Standards HRESULT.

Hinweise

Um AtlAxDialogBox mit einer Dialogfeldvorlage verwenden die ein ActiveX-Steuerelement enthält, geben Sie gültiges CLSID, APPID oder URL-Zeichenfolge als das Textfeld im CONTROL-Abschnitt der Dialogfeldressource, zusammen mit "AtlAxWin80" als das Klassennamenfeld unter demselben Abschnitt.Zeigt das folgende, was ein gültiger CONTROL-Abschnitt möglicherweise wie aussehen könnte:

CONTROL "{04FE35E9-ADBC-4f1d-83FE-8FA4D1F71C7F}", IDC_TEST,

"AtlAxWin80", WS_GROUP | WS_TABSTOP, 0, 0, 100, 100

Weitere Informationen zu Bearbeitungsressourcenskripte, finden Sie unter Gewusst wie: Öffnen einer Ressourcenskriptdatei im Textformat.Weitere Informationen zu Steuerelementressourcendefinitions-Anweisungen finden Sie unter Parameter für allgemeine Steuerelemente under Windows SDK*: SDK Tools*.

Weitere Informationen zu Dialogfeldern im Allgemeinen, verweisen Sie DialogBox und CreateDialogParam in Windows SDK an.

Anforderungen

Header: atlhost.h

Siehe auch

Referenz

AtlAxCreateDialog

Konzepte

Grundlagen des zusammengesetzten Steuerelements

Weitere Ressourcen

Globale Funktionen des zusammengesetzten Steuerelements