CDialog::CreateIndirect

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

メモリ上のダイアログボックステンプレートからモードレスダイアログボックスを作成します。

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

パラメータ

lpDialogTemplate
ダイアログボックスを作成するためのダイアログボックステンプレートを持つメモリへのポインタ。このテンプレートは DLGTEMPLATE 構造体の形式であり、コントロールの情報を保持します。詳細については、Windows SDK を参照してください。
pParentWnd
ダイアログオブジェクトの CWnd 型の親ウィンドウオブジェクトへのポインタ。NULL の場合は、ダイアログオブジェクトの親ウィンドウがアプリケーションのメインウィンドウになります。
lpDialogInit
DLGINIT リソースへのポインタ。
hDialogTemplate
ダイアログボックステンプレートを持つグローバルメモリへのハンドル。このテンプレートは、DLGTEMPLATE 構造体の形式で、ダイアログボックスのコントロールについてのデータを持ちます。

戻り値

ダイアログボックスが正しく作成されて初期化された場合は、0 以外を返します。それ以外の場合は 0 を返します。

解説

CreateIndirect メンバ関数は、ダイアログボックスを作成後すぐに戻ります。

親ウィンドウを作成したときにダイアログボックスを表示する場合は、ダイアログボックステンプレートで WS_VISIBLE スタイルを使用します。それ以外の場合は、ShowWindow 関数を呼び出す必要があります。テンプレートでその他のダイアログボックスのスタイルを指定する方法については、Windows SDK の DLGTEMPLATE 構造体の説明を参照してください。

CreateIndirect 関数で作成したダイアログボックスを破棄するには、CWnd::DestroyWindow 関数を使います。

ActiveX コントロールを持つダイアログボックスは、DLGINIT リソースで提供される追加情報を必要とします。詳細については、サポート技術情報の「HOWTO: Use a Dialog Template to Create a MFC Dialog with an ActiveX Control (Q231591)」を参照してください。サポート技術情報の文書は、MSDN ライブラリの Visual Studio のドキュメント、または https://support.microsoft.com で参照できます。