CDialog::CreateIndirect

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

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

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