CWinFormsDialog 類別

裝載 Windows Form 使用者控制項的 MFC 對話方塊類別包裝函式。

語法

template <typename TManagedControl>
class CWinFormsDialog :
    public CDialog

參數

TManagedControl
要顯示在 MFC 應用程式中的 .NET Framework 使用者控制項。

成員

公用建構函式

名稱	描述
CWinFormsDialog：：CWinFormsDialog	建構 CWinFormsDialog 物件。

公用方法

名稱	描述
CWinFormsDialog：：GetControl	擷取 Windows Forms 使用者控制項的參考。
CWinFormsDialog：：GetControlHandle	擷取 Windows Forms 使用者控制項的視窗控制碼。
CWinFormsDialog：：OnInitDialog	建立並裝載 Windows Forms 使用者控制項，以初始化 MFC 對話方塊。

公用運算子

名稱	描述
CWinFormsDialog::operator ->	取代運算式中的 CWinFormsDialog：：GetControl 。
CWinFormsDialog：：operator TManagedControl^	將類型轉換成 Windows Forms 使用者控制項的參考。

備註

CWinFormsDialog 是裝載 Windows Forms 使用者控制項之 MFC 對話方塊類別 （ CDialog ） 的包裝函式。 這允許在強制回應或無模式 MFC 對話方塊中顯示 .NET Framework 控制項。

如需使用 Windows Forms 的詳細資訊，請參閱 在 MFC 中使用 Windows Form 使用者控制項和 將 Windows Form 使用者控制項裝載為 MFC 對話方塊 。

需求

標頭： afxwinforms.h

CWinFormsDialog：：CWinFormsDialog

建構 CWinFormsDialog 物件。

CWinFormsDialog(UINT nIDTemplate = IDD);

參數

nIDTemplate
包含對話方塊範本資源的識別碼。 使用對話方塊編輯器來建立對話方塊範本，並將其儲存在應用程式的資源腳本檔案中。 如需對話方塊範本的詳細資訊，請參閱 CDialog 類別 。

CWinFormsDialog：：GetControl

擷取 Windows Forms 使用者控制項的參考。

inline TManagedControl^ GetControl() const;

傳回值

傳回 MFC 對話方塊中 Windows Forms 控制項的參考。

CWinFormsDialog：：GetControlHandle

擷取 Windows Forms 使用者控制項的視窗控制碼。

inline HWND GetControlHandle() const throw();

傳回值

傳回 Windows Forms 使用者控制項的視窗控制碼。

CWinFormsDialog：：OnInitDialog

建立並裝載 Windows Forms 使用者控制項，以初始化 MFC 對話方塊。

virtual BOOL OnInitDialog();

傳回值

布林值，指定應用程式是否已將輸入焦點設定為對話方塊中的其中一個控制項。 如果 OnInitDialog 傳回非零值，Windows 會將輸入焦點設定為對話方塊中的第一個控制項。 只有當應用程式明確將輸入焦點設定為對話方塊中的其中一個控制項時，這個方法才能傳回 0。

備註

建立 MFC 對話方塊時（使用 Create、 CreateIndirect 或 DoModal 方法繼承自 CDialog ），就會傳送WM_INITDIALOG訊息，並呼叫此方法。 它會在對話方塊上建立 Windows Forms 控制項的實例，並調整對話方塊的大小以容納使用者控制項的大小。 然後，它會在 [MFC] 對話方塊中裝載新的控制項。

如果您需要在初始化對話方塊時執行特殊處理，請覆寫此成員函式。 如需使用此方法的詳細資訊，請參閱 CDialog：：OnInitDialog 。

CWinFormsDialog::operator ->

取代運算式中的 CWinFormsDialog：：GetControl 。

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

備註

此運算子提供方便的語法，以取代 GetControl 運算式中。

如需使用 Windows Forms 的詳細資訊，請參閱 在 MFC 中使用 Windows Form 使用者控制項。

CWinFormsDialog：：operator TManagedControl^

將類型轉換成 Windows Forms 使用者控制項的參考。

inline operator TManagedControl^() const throw();

備註

這個運算子會將類型轉換成 Windows Forms 控制項的參考。 它用來將對話方塊傳遞 CWinFormsDialog<TManagedControl> 至接受 Windows Forms 使用者控制項物件的指標的函式。

另請參閱

CWnd 類別
CWinFormsView 類別
CDialog 類別