Classe CWinFormsDialog
Um wrapper para uma classe de diálogo MFC que hospeda um controle de usuário do Windows Forms.
Sintaxe
template <typename TManagedControl>
class CWinFormsDialog :
public CDialog
Parâmetros
TManagedControl
O controle de usuário do .NET Framework a ser exibido no aplicativo MFC.
Membros
Construtores públicos
| Nome | Descrição |
|---|---|
| CWinFormsDialog::CWinFormsDialog | Constrói um objeto CWinFormsDialog. |
Métodos públicos
| Nome | Descrição |
|---|---|
| CWinFormsDialog::GetControl | Recupera uma referência ao controle de usuário do Windows Forms. |
| CWinFormsDialog::GetControlHandle | Recupera um identificador de janela para o controle de usuário do Windows Forms. |
| CWinFormsDialog::OnInitDialog | Inicializa a caixa de diálogo MFC criando e hospedando um controle de usuário do Windows Forms nela. |
Operadores públicos
| Nome | Descrição |
|---|---|
CWinFormsDialog::operator -> |
Substitui CWinFormsDialog::GetControl em expressões. |
| CWinFormsDialog::operator TManagedControl^ | Converte um tipo como uma referência a um controle de usuário do Windows Forms. |
Comentários
CWinFormsDialog é um wrapper para uma classe de diálogo MFC (CDialog) que hospeda um controle de usuário do Windows Forms. Isso permite a exibição de controles do .NET Framework em uma caixa de diálogo MFC modal ou sem modo.
Para mais informações sobre como usar o Windows Forms, consulte Usar um controle de usuário do Windows Forms no MFC e Hospedar um controle de usuário de Windows Form como uma caixa de diálogo MFC.
Requisitos
Cabeçalho: afxwinforms.h
CWinFormsDialog::CWinFormsDialog
Constrói um objeto CWinFormsDialog.
CWinFormsDialog(UINT nIDTemplate = IDD);
Parâmetros
nIDTemplate
Contém a ID de um recurso de modelo de caixa de diálogo. Use o editor de caixa de diálogo para criar o modelo de caixa de diálogo e armazená-lo no arquivo de script de recurso do aplicativo. Para obter mais informações sobre modelos de caixa de diálogo, consulte Classe CDialog.
CWinFormsDialog::GetControl
Recupera uma referência ao controle de usuário do Windows Forms.
inline TManagedControl^ GetControl() const;
Valor de retorno
Retorna uma referência ao controle do Windows Forms na caixa de diálogo MFC.
CWinFormsDialog::GetControlHandle
Recupera um identificador de janela para o controle de usuário do Windows Forms.
inline HWND GetControlHandle() const throw();
Valor de retorno
Retorna um identificador de janela para o controle de usuário do Windows Forms.
CWinFormsDialog::OnInitDialog
Inicializa a caixa de diálogo MFC criando e hospedando um controle de usuário do Windows Forms nela.
virtual BOOL OnInitDialog();
Valor de retorno
Um valor booliano que especifica se o aplicativo definiu o foco de entrada como um dos controles na caixa de diálogo. Se OnInitDialog retornar diferente de zero, o Windows definirá o foco de entrada como o primeiro controle na caixa de diálogo. Este método só poderá retornar 0 se o aplicativo tiver definido explicitamente o foco de entrada para um dos controles na caixa de diálogo.
Comentários
Quando a caixa de diálogo MFC é criada (usando o método Create, CreateIndirect ou DoModal herdado do CDialog), uma mensagem WM_INITDIALOG é enviada e esse método é chamado. Ele cria uma instância de um controle do Windows Forms na caixa de diálogo e ajusta o tamanho da caixa de diálogo para acomodar o tamanho do controle do usuário. Em seguida, ele hospeda o novo controle na caixa de diálogo MFC.
Substitua essa função de membro se você precisar executar o processamento especial quando a caixa de diálogo for inicializada. Para obter mais informações sobre como usar esse método, consulte CDialog::OnInitDialog.
CWinFormsDialog::operator ->
Substitui CWinFormsDialog::GetControl em expressões.
inline TManagedControl^ operator->() const throw();
Comentários
Esse operador fornece uma sintaxe conveniente que substitui GetControl em expressões.
Para mais informações sobre como usar o Windows Forms, confira Como usar um controle de usuário do Windows Form no MFC.
CWinFormsDialog::operator TManagedControl^
Converte um tipo como uma referência a um controle de usuário do Windows Forms.
inline operator TManagedControl^() const throw();
Comentários
Este operador converte um tipo como uma referência a um controle de usuário do Windows Forms. Ele é usado para passar uma caixa de diálogo CWinFormsDialog<TManagedControl> para funções que aceitam um ponteiro para um objeto de controle de usuário do Windows Forms.