CWinFormsDialog クラス

  • [アーティクル]

Windows フォーム ユーザー コントロールをホストする MFC ダイアログ クラスのラッパーです。

構文

template <typename TManagedControl>
class CWinFormsDialog :
    public CDialog

パラメーター

TManagedControl
MFC アプリケーションに表示される .NET Framework ユーザー コントロール。

メンバー

パブリック コンストラクター

名前 説明
CWinFormsDialog::CWinFormsDialog CWinFormsDialog オブジェクトを構築します。

パブリック メソッド

名前 説明
CWinFormsDialog::GetControl Windows フォーム ユーザー コントロールへの参照を取得します。
CWinFormsDialog::GetControlHandle Windows フォーム ユーザー コントロールへのウィンドウ ハンドルを取得します。
CWinFormsDialog::OnInitDialog MFC ダイアログ ボックスを初期化するには、WINDOWS フォーム ユーザー コントロールを作成してホストします。

パブリック演算子

名前 説明
CWinFormsDialog::operator -> 式の CWinFormsDialog::GetControl を置き換えます。
CWinFormsDialog::operator TManagedControl^ 型をWindows フォームユーザー コントロールへの参照としてキャストします。

解説

CWinFormsDialogは、Windows フォーム ユーザー コントロールをホストする MFC ダイアログ クラス (CDialog) のラッパーです。 これにより、モーダルまたはモードレス MFC ダイアログ ボックスに .NET Framework コントロールを表示できます。

Windows フォームの使用方法の詳細については、「MFC での Windows フォーム ユーザー コントロールの使用」および「MFC ダイアログ ボックスとしての Windows フォーム ユーザー コントロールのホスト」を参照してください。

必要条件

ヘッダー: afxwinforms.h

CWinFormsDialog::CWinFormsDialog

CWinFormsDialog オブジェクトを構築します。

CWinFormsDialog(UINT nIDTemplate = IDD);

パラメーター

nIDTemplate
ダイアログ ボックス テンプレート リソースの ID を格納します。 ダイアログ エディターを使用してダイアログ テンプレートを作成し、アプリケーションのリソース スクリプト ファイルに格納します。 ダイアログ テンプレートの詳細については、「CDialog クラス」を参照してください。

CWinFormsDialog::GetControl

Windows フォーム ユーザー コントロールへの参照を取得します。

inline TManagedControl^ GetControl() const;

戻り値

MFC ダイアログ ボックスのWindows フォーム コントロールへの参照を返します。

CWinFormsDialog::GetControlHandle

Windows フォーム ユーザー コントロールへのウィンドウ ハンドルを取得します。

inline HWND GetControlHandle() const throw();

戻り値

Windows フォーム ユーザー コントロールにウィンドウ ハンドルを返します。

CWinFormsDialog::OnInitDialog

MFC ダイアログ ボックスを初期化するには、WINDOWS フォーム ユーザー コントロールを作成してホストします。

virtual BOOL OnInitDialog();

戻り値

アプリケーションがダイアログ ボックスのコントロールのいずれかに入力フォーカスを設定したかどうかを指定するブール値。 0 以外の値が返された場合 OnInitDialog 、Windows は入力フォーカスをダイアログ ボックスの最初のコントロールに設定します。 このメソッドは、アプリケーションがダイアログ ボックスのコントロールのいずれかに入力フォーカスを明示的に設定した場合にのみ、0 を返すことができます。

解説

MFC ダイアログ ボックスが作成されると (CDialog から継承された Create、CreateIndirect、または DoModal メソッドを使用して)、WM_INITDIALOG メッセージが送信され、このメソッドが呼び出されます。 ダイアログ ボックスにWindows フォーム コントロールのインスタンスを作成し、ユーザー コントロールのサイズに合わせてダイアログ ボックスのサイズを調整します。 その後、MFC ダイアログ ボックスで新しいコントロールをホストします。

ダイアログ ボックスの初期化時に特別な処理を実行する必要がある場合は、このメンバー関数をオーバーライドします。 このメソッドの使用方法の詳細については、「CDialog::OnInitDialog」を参照してください。

CWinFormsDialog::operator ->

式の CWinFormsDialog::GetControl を置き換えます。

inline TManagedControl^  operator->() const throw();

解説

この演算子は、式で置き換える便利な GetControl 構文を提供します。

Windows フォームの使用方法の詳細については、「MFC での Windows フォーム ユーザー コントロールの使用」を参照してください。

CWinFormsDialog::operator TManagedControl^

型をWindows フォームユーザー コントロールへの参照としてキャストします。

inline operator TManagedControl^() const throw();

解説

この演算子は、型をWindows フォーム コントロールへの参照としてキャストします。 ダイアログ ボックスを、Windows フォームユーザー コントロール オブジェクトへのポインターを受け入れる関数に渡CWinFormsDialog<TManagedControl>すために使用されます。

関連項目

CWnd クラス
CWinFormsView クラス
CDialog クラス