CWinFormsView Class

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at CWinFormsView Class.

Provides generic functionality for hosting of a Windows Forms control as an MFC view.

Syntax

class CWinFormsView : public CView;  

Members

Public Constructors

Name	Description
CWinFormsView::CWinFormsView	Constructs a CWinFormsView object.

Public Methods

Name	Description
CWinFormsView::GetControl	Retrieves a pointer to the Windows Forms control.

Public Operators

Name
CWinFormsView::operator Control^	Casts a type as a pointer to a Windows Forms control.

Remarks

MFC uses the CWinFormsView class to host a .NET Framework Windows Forms control within an MFC view. The control is a child of the native view and occupies the entire client area of the MFC view. The result is similar to a CFormView view, allowing you to take advantage of the Windows Forms designer and run time to create rich form-based views.

For more information on using Windows Forms, see Using a Windows Form User Control in MFC.

Note

MFC Windows Forms integration works only in projects which link dynamically with MFC (projects in which AFXDLL is defined).

Note

CWinFormsView does not support the MFC splitter window ( CSplitterWnd Class). Currently only the Windows Forms Splitter control ( Splitter) is supported.

Requirements

Header: afxwinforms.h

CWinFormsView::CWinFormsView

Constructs a CWinFormsView object.

CWinFormsView(System::Type^ pManagedViewType);  

Parameters

pManagedViewType
A pointer to the data type of the Windows Forms user control. For more information, see System.Type.

Example

In the following example, the CUserView class inherits from CWinFormsView and passes the type of UserControl1 to the CWinFormsView constructor. UserControl1 is a custom-built control in ControlLibrary1.dll.

class CMyView : public CWinFormsView

IMPLEMENT_DYNCREATE(CMyView, CWinFormsView)

BEGIN_MESSAGE_MAP(CMyView, CWinFormsView)
END_MESSAGE_MAP()

CMyView::CMyView()
   : CWinFormsView(ControlLibrary1::UserControl1::typeid)
{
}

CWinFormsView::GetControl

Retrieves a pointer to the Windows Forms control.

System::Windows::Forms::Control^ GetControl() const;  

Return Value

A pointer to a System.Windows.Forms.Control object.

Remarks

For an example of how to use Windows Forms, see Using a Windows Form User Control in MFC.

CWinFormsView::operator Control^

Casts a type as a pointer to a Windows Forms control.

operator System::Windows::Forms::Control^() const;  

Remarks

This operator allows you to pass a CWinFormsView view to functions that accept a pointer to a Windows Forms control of type System.Windows.Forms.Control.

Example

See CWinFormsView::GetControl.

See Also

Hierarchy Chart
CWinFormsControl Class
CWinFormsDialog Class
CFormView Class