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	通过在其上创建和托管 Windows 窗体用户控件来初始化 MFC 对话框。

公共运算符

“属性”	描述
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

通过在其上创建和托管 Windows 窗体用户控件来初始化 MFC 对话框。

virtual BOOL OnInitDialog();

返回值

一个布尔值，指定应用程序是否已将输入焦点设置为对话框中的一个控件。 如果 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 窗体控件的引用。 它用于将 CWinFormsDialog<TManagedControl> 对话框传递给相关函数，这些函数会接受指向 Windows 窗体用户控件对象的指针。

另请参阅

CWnd 类
CWinFormsView 类
CDialog 类