CWinFormsDialog-Klasse

Ein Wrapper für eine MFC-Dialogfeldklasse, die ein Windows Forms-Benutzersteuerelement hostet.

Syntax

template <typename TManagedControl>
class CWinFormsDialog :
    public CDialog

Parameter

TManagedControl
Das .NET Framework-Benutzersteuerelement, das in der MFC-Anwendung angezeigt werden soll.

Member

Öffentliche Konstruktoren

Name Beschreibung
CWinFormsDialog::CWinFormsDialog Erstellt ein CWinFormsDialog-Objekt.

Öffentliche Methoden

Name Beschreibung
CWinFormsDialog::GetControl Ruft einen Verweis auf das Windows Forms-Benutzersteuerelement ab.
CWinFormsDialog::GetControlHandle Ruft ein Fensterhandle zum Windows Forms-Benutzersteuerelement ab.
CWinFormsDialog::OnInitDialog Initialisiert das MFC-Dialogfeld, indem ein Windows Forms-Benutzersteuerelement erstellt und gehostet wird.

Öffentliche Operatoren

Name Beschreibung
CWinFormsDialog::operator -> Ersetzt CWinFormsDialog::GetControl in Ausdrücken.
CWinFormsDialog::operator TManagedControl^ Wandelt einen Typ als Verweis auf ein Windows Forms-Benutzersteuerelement um.

Hinweise

CWinFormsDialog ist ein Wrapper für eine MFC-Dialogklasse ( CDialog), die ein Windows Forms-Benutzersteuerelement hosten. Dadurch wird die Anzeige von .NET Framework-Steuerelementen in einem modalem oder moduslosen MFC-Dialogfeld ermöglicht.

Weitere Informationen zur Verwendung von Windows Forms finden Sie unter Verwenden eines Windows Form-Benutzersteuerelements in MFC und Hosten eines Windows Form-Benutzersteuerelements als MFC-Dialogfeld.

Anforderungen

Kopfzeile: afxwinforms.h

CWinFormsDialog::CWinFormsDialog

Erstellt ein CWinFormsDialog-Objekt.

CWinFormsDialog(UINT nIDTemplate = IDD);

Parameter

nIDTemplate
Enthält die ID einer Dialogfeldvorlagenressource. Verwenden Sie den Dialogfeld-Editor, um die Dialogfeldvorlage zu erstellen und in der Ressourcenskriptdatei der Anwendung zu speichern. Weitere Informationen zu Dialogfeldvorlagen finden Sie unter "CDialog Class".

CWinFormsDialog::GetControl

Ruft einen Verweis auf das Windows Forms-Benutzersteuerelement ab.

inline TManagedControl^ GetControl() const;

Rückgabewert

Gibt einen Verweis auf das Windows Forms-Steuerelement im MFC-Dialogfeld zurück.

CWinFormsDialog::GetControlHandle

Ruft ein Fensterhandle zum Windows Forms-Benutzersteuerelement ab.

inline HWND GetControlHandle() const throw();

Rückgabewert

Gibt ein Fensterhandle an das Windows Forms-Benutzersteuerelement zurück.

CWinFormsDialog::OnInitDialog

Initialisiert das MFC-Dialogfeld, indem ein Windows Forms-Benutzersteuerelement erstellt und gehostet wird.

virtual BOOL OnInitDialog();

Rückgabewert

Ein boolescher Wert, der angibt, ob die Anwendung den Eingabefokus auf eines der Steuerelemente im Dialogfeld festgelegt hat. Wenn OnInitDialog "nonzero" zurückgegeben wird, legt Windows den Eingabefokus auf das erste Steuerelement im Dialogfeld fest. Diese Methode kann 0 nur zurückgeben, wenn die Anwendung den Eingabefokus explizit auf eines der Steuerelemente im Dialogfeld festgelegt hat.

Hinweise

Wenn das MFC-Dialogfeld erstellt wird (mithilfe der von CDialog geerbten Create-, CreateIndirect- oder DoModal-Methode), wird eine WM_INITDIALOG Nachricht gesendet, und diese Methode wird aufgerufen. Es erstellt eine Instanz eines Windows Forms-Steuerelements im Dialogfeld und passt die Größe des Dialogfelds an, um die Größe des Benutzersteuerelements zu berücksichtigen. Anschließend wird das neue Steuerelement im MFC-Dialogfeld gehostet.

Überschreiben Sie diese Memberfunktion, wenn Sie eine spezielle Verarbeitung ausführen müssen, wenn das Dialogfeld initialisiert wird. Weitere Informationen zur Verwendung dieser Methode finden Sie unter "CDialog::OnInitDialog".

CWinFormsDialog::operator ->

Ersetzt CWinFormsDialog::GetControl in Ausdrücken.

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

Hinweise

Dieser Operator bietet eine bequeme Syntax, die in Ausdrücken GetControl ersetzt wird.

Informationen zur Verwendung von Windows Forms finden Sie unter Verwenden eines Windows Form-Benutzersteuerelements in MFC.

CWinFormsDialog::operator TManagedControl^

Wandelt einen Typ als Verweis auf ein Windows Forms-Benutzersteuerelement um.

inline operator TManagedControl^() const throw();

Hinweise

Dieser Operator wandelt einen Typ als Verweis auf ein Windows Forms-Steuerelement um. Es wird verwendet, um ein CWinFormsDialog<TManagedControl> Dialogfeld an Funktionen zu übergeben, die einen Zeiger auf ein Windows Forms-Benutzersteuerelementobjekt akzeptieren.

Siehe auch

CWnd-Klasse
CWinFormsView-Klasse
CDialog-Klasse