Classe CWinFormsDialog

Wrapper per una classe finestra di dialogo MFC che ospita un controllo utente Windows Form.

Sintassi

template <typename TManagedControl>
class CWinFormsDialog :
    public CDialog

Parametri

TManagedControl
Controllo utente di .NET Framework da visualizzare nell'applicazione MFC.

Membri

Costruttori pubblici

Metodi pubblici

Operatori pubblici

Osservazioni:

CWinFormsDialogè un wrapper per una classe di dialogo MFC (CDialog) che ospita un controllo utente Windows Form. In questo modo è possibile visualizzare i controlli .NET Framework in una finestra di dialogo MFC modale o modeless.

Per altre informazioni sull'uso di Windows Form, vedere Uso di un controllo utente windows Form in MFC e hosting di un controllo utente di Windows Form come finestra di dialogo MFC.

Requisiti

Intestazione: afxwinforms.h

CWinFormsDialog::CWinFormsDialog

Costruisce un oggetto CWinFormsDialog.

CWinFormsDialog(UINT nIDTemplate = IDD);

Parametri

nIDTemplate
Contiene l'ID di una risorsa modello di finestra di dialogo. Usare l'editor di dialoghi per creare il modello di finestra di dialogo e archiviarlo nel file di script di risorse dell'applicazione. Per altre informazioni sui modelli di finestra di dialogo, vedere Classe CDialog.

CWinFormsDialog::GetControl

Recupera un riferimento al controllo utente Windows Form.

inline TManagedControl^ GetControl() const;

Valore restituito

Restituisce un riferimento al controllo Windows Form nella finestra di dialogo MFC.

CWinFormsDialog::GetControlHandle

Recupera un handle di finestra nel controllo utente Windows Form.

inline HWND GetControlHandle() const throw();

Valore restituito

Restituisce un handle di finestra al controllo utente Windows Form.

CWinFormsDialog::OnInitDialog

Inizializza la finestra di dialogo MFC creando e ospitando un controllo utente Windows Form su di esso.

virtual BOOL OnInitDialog();

Valore restituito

Valore booleano che specifica se l'applicazione ha impostato lo stato attivo di input su uno dei controlli nella finestra di dialogo. Se OnInitDialog restituisce un valore diverso da zero, Windows imposta lo stato attivo sull'input sul primo controllo della finestra di dialogo. Questo metodo può restituire 0 solo se l'applicazione ha impostato in modo esplicito lo stato attivo sull'input su uno dei controlli nella finestra di dialogo.

Osservazioni:

Quando viene creata la finestra di dialogo MFC (usando il metodo Create, CreateIndirect o DoModal ereditato da CDialog), viene inviato un messaggio WM_INITDIALOG e questo metodo viene chiamato. Crea un'istanza di un controllo Windows Form nella finestra di dialogo e modifica le dimensioni della finestra di dialogo in modo da adattarla alle dimensioni del controllo utente. Ospita quindi il nuovo controllo nella finestra di dialogo MFC.

Eseguire l'override di questa funzione membro se è necessario eseguire un'elaborazione speciale quando viene inizializzata la finestra di dialogo. Per altre informazioni sull'uso di questo metodo, vedere CDialog::OnInitDialog.

CWinFormsDialog::operator ->

Sostituisce CWinFormsDialog::GetControl nelle espressioni.

inline TManagedControl^  operator->() const throw();

Osservazioni:

Questo operatore fornisce una sintassi pratica che sostituisce GetControl nelle espressioni.

Per informazioni sull'uso di Windows Form, vedere Uso di un controllo utente di Windows Form in MFC.

CWinFormsDialog::operator TManagedControl^

Esegue il cast di un tipo come riferimento a un controllo utente Windows Form.

inline operator TManagedControl^() const throw();

Osservazioni:

Questo operatore esegue il cast di un tipo come riferimento a un controllo Windows Form. Viene usato per passare una CWinFormsDialog<TManagedControl> finestra di dialogo alle funzioni che accettano un puntatore a un oggetto controllo utente Windows Form.

Vedi anche

Classe CWnd
Classe CWinFormsView
Classe CDialog