CWinFormsControl-Klasse
Stellt die grundlegende Funktionalität zum Hosten eines Windows Forms-Steuerelements bereit.
Syntax
template<class TManagedControl>
class CWinFormsControl : public CWnd
Parameter
TManagedControl
Ein .NET Framework-Windows Forms-Steuerelement, das in der MFC-Anwendung angezeigt werden soll.
Member
Öffentliche Konstruktoren
| Name | Beschreibung |
|---|---|
| CWinFormsControl::CWinFormsControl | Erstellt ein MFC Windows Forms-Steuerelementwrapperobjekt. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CWinFormsControl::CreateManagedControl | Erstellt ein Windows Forms-Steuerelement in einem MFC-Container. |
| CWinFormsControl::GetControl | Ruft einen Zeiger auf das Windows Forms-Steuerelement ab. |
| CWinFormsControl::GetControlHandle | Ruft ein Handle für das Windows Forms-Steuerelement ab. |
Öffentliche Operatoren
| Name | Beschreibung |
|---|---|
CWinFormsControl::operator -> |
Ersetzt CWinFormsControl::GetControl in Ausdrücken. |
| CWinFormsControl::operator TManagedControl^ | Wandelt einen Typ als Zeiger auf ein Windows Forms-Steuerelement um. |
Hinweise
Die CWinFormsControl Klasse stellt die grundlegenden Funktionen zum Hosten eines Windows Forms-Steuerelements bereit.
Weitere Informationen zur Verwendung von Windows Forms finden Sie unter Verwenden eines Windows Form-Benutzersteuerelements in MFC.
Ihr MFC-Code sollte keine Fensterhandles zwischenspeichern (in der Regel gespeichert m_hWnd). Einige Windows Forms-Steuerelementeigenschaften erfordern, dass die zugrunde liegende Win32 Window zerstört und mithilfe DestroyWindow und CreateWindowneu erstellt wird. Die MFC Windows Forms-Implementierung behandelt die Destroy Und-Ereignisse Create der Steuerelemente, um das m_hWnd Element zu aktualisieren.
Hinweis
Die MFC Windows Forms-Integration funktioniert nur in Projekten, die dynamisch mit MFC (in denen AFXDLL definiert ist) verknüpfen.
Anforderungen
Kopfzeile: afxwinforms.h
CWinFormsControl::CreateManagedControl
Erstellt ein Windows Forms-Steuerelement in einem MFC-Container.
inline BOOL CreateManagedControl(
System::Type^ pType,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
int nID)
inline BOOL CreateManagedControl(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
int nID);
inline BOOL CreateManagedControl(
DWORD dwStyle,
int nPlaceHolderID,
CWnd* pParentWnd);
inline BOOL CreateManagedControl(
typename TManagedControl^ pControl,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
int nID);
Parameter
pType
Der Datentyp des zu erstellenden Steuerelements. Muss ein Typ-Datentyp sein.
dwStyle
Das Fensterformat, das auf das Steuerelement angewendet werden soll. Geben Sie eine Kombination aus Fensterformatvorlagen an. Derzeit werden nur die folgenden Formatvorlagen unterstützt: WS_TABSTOP, WS_VISIBLE, WS_DISABLED und WS_GROUP.
rect
Eine RECT-Struktur , die die Koordinaten der oberen linken und unteren rechten Ecke des Steuerelements definiert (nur erste Überladung).
nPlaceHolderID
Das Handle des statischen Platzhaltersteuerelements, das im Ressourcen-Editor platziert wird. Das neu erstellte Windows Forms-Steuerelement ersetzt das statische Steuerelement, wobei seine Position, Z-Reihenfolge und Formatvorlagen (nur zweite Überladung) vorausgesetzt werden.
pParentWnd
Ein Zeiger auf das übergeordnete Fenster.
Nid
Die Ressourcen-ID-Nummer, die dem neu erstellten Steuerelement zugewiesen werden soll.
pControl
Eine Instanz eines Windows Forms-Steuerelements, das dem CWinFormsControl-Objekt zugeordnet werden soll (nur vierte Überladung).
Rückgabewert
Wenn dies erfolgreich ist, wird ein Wert ungleich Null zurückgegeben. Wenn dies nicht erfolgreich ist, wird null zurückgegeben.
Hinweise
Diese Methode instanziiert ein .NET Framework-Windows Forms-Steuerelement in einem MFC-Container.
Die erste Überladung der Methode akzeptiert einen .NET Framework-Datentyp pType , sodass MFC ein neues Objekt dieses Typs instanziieren kann. pType muss ein Typ-Datentyp sein.
Die zweite Überladung der Methode erstellt ein Windows Forms-Steuerelement basierend auf dem TManagedControl Vorlagenparameter der CWinFormsControl Klasse. Die Größe und Position des Steuerelements basiert auf der RECT Struktur, die an die Methode übergeben wird. Nur dwStyle ist für die Formatvorlagen wichtig.
Die dritte Überladung der Methode erstellt ein Windows Forms-Steuerelement, das ein statisches Steuerelement ersetzt, es zerstört und seine Position, Z-Reihenfolge und Formatvorlagen übernimmt. Das statische Steuerelement dient nur als Platzhalter für das Windows Forms-Steuerelement. Beim Erstellen des Steuerelements kombiniert diese Überladung die Stile von dwStyle mit den Ressourcenstilen des statischen Steuerelements.
Mit der vierten Überladung der Methode können Sie ein bereits instanziiertes Windows Forms-Steuerelement pControl übergeben, das MFC umschließt. Er muss vom gleichen Typ wie der TManagedControl Vorlagenparameter der CWinFormsControl Klasse sein.
Beispiele zur Verwendung von Windows Form-Steuerelementen finden Sie unter Verwenden eines Windows Form-Benutzersteuerelements in MFC .
CWinFormsControl::CWinFormsControl
Erstellt ein MFC Windows Forms-Steuerelementwrapperobjekt.
CWinFormsControl();
Hinweise
Das Windows Forms-Steuerelement wird instanziiert, wenn Sie CWinFormsControl::CreateManagedControl aufrufen.
CWinFormsControl::GetControl
Ruft einen Zeiger auf das Windows Forms-Steuerelement ab.
inline TManagedControl^ GetControl() const;
Rückgabewert
Gibt einen Zeiger auf das Windows Forms-Steuerelement zurück.
Beispiel
Siehe CWinFormsControl::CreateManagedControl.
CWinFormsControl::GetControlHandle
Ruft ein Handle für das Windows Forms-Steuerelement ab.
inline HWND GetControlHandle() const;
Rückgabewert
Gibt ein Handle für das Windows Forms-Steuerelement zurück.
Hinweise
GetControlHandle ist eine Hilfsmethode, die das in den .NET Framework-Steuerelementeigenschaften gespeicherte Fensterhandle zurückgibt. Der Fensterhandlewert wird während des Aufrufs von CWnd::m_hWnd in CWnd::Attach kopiert.
CWinFormsControl::operator ->
Ersetzt CWinFormsControl::GetControl in Ausdrücken.
inline TManagedControl^ operator->() const;
Hinweise
Dieser Operator bietet eine bequeme Syntax, die in Ausdrücken GetControl ersetzt wird.
Weitere Informationen zu Windows Forms finden Sie unter Verwenden eines Windows Form-Benutzersteuerelements in MFC.
CWinFormsControl::operator TManagedControl^
Wandelt einen Typ als Zeiger auf ein Windows Forms-Steuerelement um.
inline operator TManagedControl^() const;
Hinweise
Dieser Operator wird an Funktionen übergeben CWinFormsControl<TManagedControl> , die einen Zeiger auf ein Windows Forms-Steuerelement akzeptieren.