Partilhar via


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.

Confira também

Classe CWnd
Classe CWinFormsView
Classe CDialog