CDialog::CreateIndirect

Artikel
06/10/2015

Rufen Sie die Memberfunktion auf, um ein nicht modales Dialogfeld aus einer Dialogfeldvorlage im Arbeitsspeicher zu erstellen.

virtual BOOL CreateIndirect( 
   LPCDLGTEMPLATE lpDialogTemplate, 
   CWnd* pParentWnd = NULL, 
   void* lpDialogInit = NULL 
); 
virtual BOOL CreateIndirect( 
   HGLOBAL hDialogTemplate, 
   CWnd* pParentWnd = NULL 
);

Parameter

lpDialogTemplate
Zeigt auf den Arbeitsspeicher, der eine Dialogfeldvorlage enthält, die verwendet wird, um das Dialogfeld zu erstellen. Diese Vorlage ist in Form einer DLGTEMPLATE-Struktur und Steuerelementinformationen, wie in Windows SDK beschrieben.
pParentWnd
Zeigt auf Objekt des übergeordneten Fensters des Dialogfeldobjekts (vom Typ CWnd). Wenn es NULL ist, wird das übergeordnete Fenster des Dialogfeldobjekts zum Hauptanwendungsfenster festgelegt.
lpDialogInit
Zeigt auf eine DLGINIT Ressource.
hDialogTemplate
Enthält ein Handle im globalen Speicher, der eine Dialogfeldvorlage enthält. Diese Vorlage ist in Form einer DLGTEMPLATE-Struktur und Daten für jedes Steuerelement im Dialogfeld.

Rückgabewert

Ungleich 0 (null), wenn das Dialogfeld erfolgreich erstellt und initialisiert wurde; andernfalls 0.

Hinweise

Die CreateIndirect-Memberfunktion gibt zurück, sobald sie das Dialogfeld erstellt.

Verwenden Sie das WS_VISIBLE Format in der Dialogfeldvorlage, wenn das Dialogfeld angezeigt wird, wenn das übergeordnete Fenster erstellt wird. Andernfalls müssen Sie ShowWindow aufrufen, um es wird angezeigt. Weitere Informationen dazu, wie Sie andere Dialogfeldformate in der Vorlage angeben können, finden Sie die DLGTEMPLATE-Struktur in Windows SDK.

Verwenden Sie die CWnd::DestroyWindow-Funktion, um ein Dialogfeld zu zerstören, das von der CreateIndirect-Funktion erstellt wird.

Dialogfelder, die ActiveX-Steuerelemente enthalten, erfordern die zusätzliche Informationen, die in einer DLGINIT Ressource bereitgestellt wird. Weitere Informationen finden Sie im Knowledge Base-Artikel Q231591, "HOWTO: Verwenden Sie eine Dialogfeldvorlage, um ein MFC-Dialogfeld ein ActiveX-Steuerelement erstellen." Knowledge Base-Artikel sind in der MSDN Library Visual Studio-Dokumentation oder unter https://support.microsoft.com/?in=de verfügbar.