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, das in der MFC-Anwendung angezeigt werden soll.
Member
Öffentliche Konstruktoren
| name | BESCHREIBUNG |
|---|---|
| CWinFormsControl::CWinFormsControl | Erstellt ein MFC-Windows Forms-Wrapperobjekt. |
Öffentliche Methoden
| name | BESCHREIBUNG |
|---|---|
| CWinFormsControl::CreateManagedControl | Erstellt ein Windows Forms-Steuerelement in einem MFC-Container. |
| CWinFormsControl::GetControl | Ruft einen Zeiger auf das Windows Forms ab. |
| CWinFormsControl::GetControlHandle | Ruft ein Handle für das Windows Forms ab. |
Öffentliche Operatoren
| Name | BESCHREIBUNG |
|---|---|
CWinFormsControl::operator -> |
Ersetzt CWinFormsControl::GetControl in Ausdrücken. |
| CWinFormsControl::operator TManagedControl^ | Casts a type as a zeiger to a Windows Forms control. |
Hinweise
Die CWinFormsControl -Klasse stellt die grundlegende Funktionalität zum Hosten eines Windows Forms zur Verfügung.
Weitere Informationen zur Verwendung von Windows Forms finden Sie unter Using a Windows Form User Control in MFC.
Ihr MFC-Code sollte Keine Window-Handles zwischenspeichern (normalerweise in gespeichert m_hWnd). Einige Windows Forms-Steuerelementeigenschaften erfordern, dass das zugrunde liegende Win32-Steuerelement Window mit und zerstört und neu erstellt DestroyWindow wirdCreateWindow. Die MFC Windows Forms-Implementierung verarbeitet die Ereignisse Destroy und Create der Steuerelemente, um den Member zu m_hWnd aktualisieren.
Hinweis
Die MFC Windows Forms integration funktioniert nur in Projekten, die dynamisch mit MFC verknüpft sind (in denen AFXDLL definiert ist).
Anforderungen
Header: 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 Type-Datentyp sein.
dwStyle
Der Fensterstil, der auf das Steuerelement angewendet werden soll. Geben Sie eine Kombination aus Fensterstilen an. Derzeit werden nur die folgenden Stile 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 Platzhalter-Steuerelements, das im Ressourcen-Editor platziert wird. Das neu erstellte Windows Forms ersetzt das statische Steuerelement, vorausgesetzt, seine Position, Z-Reihenfolge und Stile (nur zweite Überladung).
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, das dem CWinFormsControl-Objekt zugeordnet werden soll (nur vierte Überladung).
Rückgabewert
Bei Erfolg wird ein Wert ungleich 0 (null) zurückgegeben. Wenn dies nicht erfolgreich ist, wird 0 (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 pType-Datentyp, sodass MFC ein neues Objekt dieses Typs instanziieren kann. pType muss ein Type-Datentyp sein.
Die zweite Überladung der -Methode erstellt ein Windows Forms-Steuerelement basierend auf dem TManagedControl Vorlagenparameter der -CWinFormsControlKlasse. Die Größe und Position des Steuerelements basiert auf der -Struktur RECT , die an die -Methode übergeben wird. Nur dwStyle ist für die Stile 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 Stile anfordert. 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 pControl übergeben, das MFC umschließen wird. Sie muss denselben Typ wie der Vorlagenparameter TManagedControl der -Klasse CWinFormsControl haben.
Beispiele zur Verwendung Windows Formularsteuerelementen finden Sie unter Using a Windows Form User Control in MFC (Verwenden Windows Formularsteuerelementen).
CWinFormsControl::CWinFormsControl
Erstellt ein MFC-Windows Forms-Wrapperobjekt.
CWinFormsControl();
Hinweise
Das Windows Forms wird instanziiert, wenn Sie CWinFormsControl::CreateManagedControl aufrufen.
CWinFormsControl::GetControl
Ruft einen Zeiger auf das Windows Forms ab.
inline TManagedControl^ GetControl() const;
Rückgabewert
Gibt einen Zeiger auf das Windows Forms zurück.
Beispiel
Siehe CWinFormsControl::CreateManagedControl.
CWinFormsControl::GetControlHandle
Ruft ein Handle für das Windows Forms ab.
inline HWND GetControlHandle() const;
Rückgabewert
Gibt ein Handle für das Windows Forms zurück.
Hinweise
GetControlHandleist eine Hilfsmethode, die das fensterhand handle zurückgibt, das in den eigenschaften .NET Framework gespeichert ist. Der Fensterhandpunktwert wird während des Aufrufs von CWnd::Attach m_hWnd CWnd::attach in CWnd::m_hWnd kopiert.
CWinFormsControl::operator ->
Ersetzt CWinFormsControl::GetControl in Ausdrücken.
inline TManagedControl^ operator->() const;
Hinweise
Dieser Operator bietet eine praktische Syntax, die in Ausdrücken GetControl ersetzt.
Weitere Informationen zum Windows Forms finden Sie unter Verwenden eines Windows Formularbenutzer-Steuerelements in MFC.
CWinFormsControl::operator TManagedControl^
Casts a type as a zeiger to a Windows Forms control.
inline operator TManagedControl^() const;
Hinweise
Dieser Operator übergibt CWinFormsControl<TManagedControl> an Funktionen, die einen Zeiger auf ein Windows Forms-Steuerelement akzeptieren.