CWinFormsDialog Class
A wrapper for an MFC dialog class that hosts a Windows Forms user control.
Syntax
template <typename TManagedControl>
class CWinFormsDialog :
public CDialog
Parameters
TManagedControl
The .NET Framework user control to be displayed in the MFC application.
Members
Public Constructors
| Name | Description |
|---|---|
| CWinFormsDialog::CWinFormsDialog | Constructs a CWinFormsDialog object. |
Public Methods
| Name | Description |
|---|---|
| CWinFormsDialog::GetControl | Retrieves a reference to the Windows Forms user control. |
| CWinFormsDialog::GetControlHandle | Retrieves a window handle to the Windows Forms user control. |
| CWinFormsDialog::OnInitDialog | Initializes the MFC dialog box by creating and hosting a Windows Forms user control on it. |
Public Operators
| Name | Description |
|---|---|
CWinFormsDialog::operator -> |
Replaces CWinFormsDialog::GetControl in expressions. |
| CWinFormsDialog::operator TManagedControl^ | Casts a type as a reference to a Windows Forms user control. |
Remarks
CWinFormsDialog is a wrapper for an MFC dialog class ( CDialog) that hosts a Windows Forms user control. This allows the display of .NET Framework controls on a modal or modeless MFC dialog box.
For more information on using Windows Forms, see Using a Windows Form User Control in MFC and Hosting a Windows Form User Control as an MFC Dialog Box.
Requirements
Header: afxwinforms.h
CWinFormsDialog::CWinFormsDialog
Constructs a CWinFormsDialog object.
CWinFormsDialog(UINT nIDTemplate = IDD);
Parameters
nIDTemplate
Contains the ID of a dialog box template resource. Use the dialog editor to create the dialog template and store it in the application's resource script file. For more information on dialog templates, see CDialog Class.
CWinFormsDialog::GetControl
Retrieves a reference to the Windows Forms user control.
inline TManagedControl^ GetControl() const;
Return Value
Returns a reference to the Windows Forms control in the MFC dialog box.
CWinFormsDialog::GetControlHandle
Retrieves a window handle to the Windows Forms user control.
inline HWND GetControlHandle() const throw();
Return Value
Returns a window handle to the Windows Forms user control.
CWinFormsDialog::OnInitDialog
Initializes the MFC dialog box by creating and hosting a Windows Forms user control on it.
virtual BOOL OnInitDialog();
Return Value
A Boolean value that specifies whether the application has set the input focus to one of the controls in the dialog box. If OnInitDialog returns nonzero, Windows sets the input focus to the first control in the dialog box. This method can return 0 only if the application has explicitly set the input focus to one of the controls in the dialog box.
Remarks
When the MFC dialog box is created (using the Create, CreateIndirect, or DoModal method inherited from CDialog), a WM_INITDIALOG message is sent and this method is called. It creates an instance of a Windows Forms control on the dialog box and adjusts the size of the dialog box to accommodate for the size of the user control. Then it hosts the new control in the MFC dialog box.
Override this member function if you need to perform special processing when the dialog box is initialized. For more information on using this method, see CDialog::OnInitDialog.
CWinFormsDialog::operator ->
Replaces CWinFormsDialog::GetControl in expressions.
inline TManagedControl^ operator->() const throw();
Remarks
This operator provides a convenient syntax that replaces GetControl in expressions.
For information on using Windows Forms, see Using a Windows Form User Control in MFC.
CWinFormsDialog::operator TManagedControl^
Casts a type as a reference to a Windows Forms user control.
inline operator TManagedControl^() const throw();
Remarks
This operator casts a type as a reference to a Windows Forms control. It is used to pass a CWinFormsDialog<TManagedControl> dialog box to functions that accept a pointer to a Windows Forms user control object.