CDialog::InitModalIndirect

[アーティクル]
08/09/2011

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

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 リソースで提供される追加情報を必要とします。詳細については、「サポート技術情報」(knowledge Base) の記事 Q231591、「「HOWTO:ダイアログテンプレート MFC ダイアログ ActiveX コントロールを作成するために使用します。サポート技術情報の文書は、MSDN ライブラリの Visual Studio のドキュメント、または https://support.microsoft.com で参照できます。