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.