CDialog::InitModalIndirect

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

更新 : 2007 年 11 月

メモリ上に作成したダイアログボックステンプレートを使ってモーダルダイアログボックスを初期化します。

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

パラメータ

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

戻り値

ダイアログオブジェクトを正しく作成して、初期化した場合は 0 以外の値を返します。それ以外の場合は 0 を返します。

解説

間接的にモーダルダイアログボックスを作成するには、まずグローバルメモリブロックを割り当て、ダイアログボックステンプレートを設定します。その後、ダイアログボックスオブジェクトを構築するために空の CDialog コンストラクタを呼び出します。次に、メモリ上のダイアログボックステンプレートへのハンドルを格納するために、InitModalIndirect を呼び出します。Windows のダイアログボックスは、DoModal メンバ関数が呼び出されたときに作成、表示されます。

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