CWinFormsControl-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Biedt de basisfunctionaliteit voor het hosten van een Windows Forms-besturingselement.

Syntaxis

template<class TManagedControl>
class CWinFormsControl : public CWnd

Parameterwaarden

TManagedControl
Een .NET Framework Windows Forms-besturingselement dat moet worden weergegeven in de MFC-toepassing.

Leden

Openbare constructors

Naam	Description
CWinFormsControl::CWinFormsControl	Maakt een MFC Windows Forms-besturingswikkelobject.

Openbare methoden

Naam	Description
CWinFormsControl::CreateManagedControl	Hiermee maakt u een Besturingselement voor Windows Forms in een MFC-container.
CWinFormsControl::GetControl	Hiermee wordt een aanwijzer naar het besturingselement Windows Forms opgehaald.
CWinFormsControl::GetControlHandle	Hiermee wordt een ingang opgehaald naar het besturingselement Windows Forms.

Openbare operators

Naam	Description
CWinFormsControl::operator ->	Vervangt CWinFormsControl::GetControl in expressies.
CWinFormsControl::operator TManagedControl^	Hiermee wordt een type geconverteerd als een aanwijzer naar een Besturingselement Windows Forms.

Opmerkingen

De CWinFormsControl klasse biedt de basisfunctionaliteit voor het hosten van een Windows Forms-besturingselement.

Zie Een Windows-formuliergebruikersbesturingselement gebruiken in MFC voor meer informatie over het gebruik van Windows Forms.

De MFC-code mag geen venstergrepen in de cache opslaan (meestal opgeslagen in m_hWnd). Voor sommige eigenschappen van Windows Forms-besturingselementen moet de onderliggende Win32 Window worden vernietigd en opnieuw worden gemaakt met en DestroyWindowCreateWindow. De implementatie van MFC Windows Forms verwerkt de Destroy en Create gebeurtenissen van de besturingselementen om het m_hWnd lid bij te werken.

Opmerking

MFC Windows Forms-integratie werkt alleen in projecten die dynamisch zijn gekoppeld aan MFC (waarin AFXDLL is gedefinieerd).

Requirements

Koptekst: afxwinforms.h

CWinFormsControl::CreateManagedControl

Hiermee maakt u een Besturingselement voor Windows Forms in een 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);

Parameterwaarden

pType
Het gegevenstype van het besturingselement dat moet worden gemaakt. Moet een gegevenstype Type zijn.

dwStyle
De vensterstijl die moet worden toegepast op het besturingselement. Geef een combinatie van vensterstijlen op. Op dit moment worden alleen de volgende stijlen ondersteund: WS_TABSTOP, WS_VISIBLE, WS_DISABLED en WS_GROUP.

Rect
Een RECT-structuur die de coördinaten definieert van de hoeken linksboven en rechtsonder van het besturingselement (alleen overbelasting).

nPlaceHolderID
De greep van het statische besturingselement voor tijdelijke aanduidingen dat in de Resource-editor is geplaatst. Het zojuist gemaakte Besturingselement Windows Forms vervangt het statische besturingselement, ervan uitgaande dat de positie, z-volgorde en stijlen (alleen tweede overbelasting) zijn.

pParentWnd
Een aanwijzer naar het bovenliggende venster.

nID
Het resource-id-nummer dat moet worden toegewezen aan het zojuist gemaakte besturingselement.

pControl
Een exemplaar van een Windows Forms-besturingselement dat moet worden gekoppeld aan het CWinFormsControl-object (alleen vierde overbelasting).

Retourwaarde

Als dit lukt, wordt een niet-nulwaarde geretourneerd. Als dit niet lukt, wordt nul geretourneerd.

Opmerkingen

Met deze methode wordt een .NET Framework Windows Forms-besturingselement geïnstitueert in een MFC-container.

De eerste overbelasting van de methode accepteert een .NET Framework-gegevenstype pType , zodat MFC een nieuw object van dit type kan instantiëren. pType moet een gegevenstype Type zijn.

Met de tweede overbelasting van de methode wordt een Besturingselement voor Windows Forms gemaakt op basis van de TManagedControl sjabloonparameter van de CWinFormsControl klasse. De grootte en positie van het besturingselement zijn gebaseerd op de RECT structuur die aan de methode wordt doorgegeven. Alleen dwStyle is belangrijk voor de stijlen.

De derde overbelasting van de methode maakt een Windows Forms-besturingselement dat een statisch besturingselement vervangt, het vernietigt en ervan uitgaat dat de positie, z-volgorde en stijlen zijn. Het statische besturingselement fungeert alleen als tijdelijke aanduiding voor het besturingselement Windows Forms. Bij het maken van het besturingselement combineert deze overbelasting de stijlen van dwStyle met de resourcestijlen van het statische besturingselement.

Met de vierde overbelasting van de methode kunt u een al geïnstantieerd Windows Forms-besturingselement doorgeven pControl dat MFC zal verpakken. Het moet van hetzelfde type zijn als de TManagedControl sjabloonparameter van de CWinFormsControl klasse.

Zie Het gebruik van een Windows-formuliergebruikersbesturingselement in MFC voor voorbeelden over het gebruik van Besturingselementen voor Windows-formulieren.

CWinFormsControl::CWinFormsControl

Maakt een MFC Windows Forms-besturingswikkelobject.

CWinFormsControl();

Opmerkingen

Het besturingselement Windows Forms wordt geïnstantieerd wanneer u CWinFormsControl::CreateManagedControl aanroept.

CWinFormsControl::GetControl

Hiermee wordt een aanwijzer naar het besturingselement Windows Forms opgehaald.

inline TManagedControl^ GetControl() const;

Retourwaarde

Hiermee wordt een aanwijzer geretourneerd naar het besturingselement Windows Forms.

Example

Zie CWinFormsControl::CreateManagedControl.

CWinFormsControl::GetControlHandle

Hiermee wordt een ingang opgehaald naar het besturingselement Windows Forms.

inline HWND GetControlHandle() const;

Retourwaarde

Hiermee wordt een ingang geretourneerd naar het besturingselement Windows Forms.

Opmerkingen

GetControlHandle is een helpermethode die de venstergreep retourneert die is opgeslagen in de eigenschappen van het .NET Framework-besturingselement. De waarde van de venstergreep wordt gekopieerd naar CWnd::m_hWnd tijdens de aanroep naar CWnd::Attach.

CWinFormsControl::operator ->

Vervangt CWinFormsControl::GetControl in expressies.

inline TManagedControl^  operator->() const;

Opmerkingen

Deze operator biedt een handige syntaxis die in expressies vervangt GetControl .

Zie Een Gebruikersbesturingselement voor Windows-formulieren gebruiken in MFC voor meer informatie over Windows Forms.

CWinFormsControl::operator TManagedControl^

Hiermee wordt een type geconverteerd als een aanwijzer naar een Besturingselement Windows Forms.

inline operator TManagedControl^() const;

Opmerkingen

Deze operator geeft functies door CWinFormsControl<TManagedControl> die een aanwijzer accepteren voor een Besturingselement Windows Forms.

Zie ook

Klasse CWinFormsDialog
CWinFormsView-klasse