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.

Weitere Informationen

CWinFormsDialog-Klasse
CWinFormsView-Klasse