CWinFormsControl Class

Article
01/08/2013

Provides the basic functionality for hosting of a Windows Forms control.

template<class TManagedControl>
class CWinFormsControl : public CWnd

Parameters

TManagedControl
A .NET Framework Windows Forms control to be displayed in the MFC application.

Members

Public Constructors

Name	Description
CWinFormsControl::CWinFormsControl	Constructs an MFC Windows Forms control wrapper object.

Public Methods

Name	Description
CWinFormsControl::CreateManagedControl	Creates a Windows Forms control in an MFC container.
CWinFormsControl::GetControl	Retrieves a pointer to the Windows Forms control.
CWinFormsControl::GetControlHandle	Retrieves a handle to the Windows Forms control.

Public Operators

Name	Description
CWinFormsControl::operator ->	Replaces CWinFormsControl::GetControl in expressions.
CWinFormsControl::operator TManagedControl^	Casts a type as a pointer to a Windows Forms control.

Remarks

The CWinFormsControl class provides the basic functionality for hosting of a Windows Forms control.

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

Your MFC code should not cache Window handles (usually stored in m_hWnd). Some Windows Forms control properties require that the underlying Win32 Window be destroyed and recreated using DestroyWindow and CreateWindow. The MFC Windows Forms implementation handles the Destroy and Create events of the controls to update the m_hWnd member.

Note

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

Requirements

Header: afxwinforms.h