Partager via


CWinFormsControl, classe

Fournit les fonctionnalités de base pour l'hébergement d'un contrôle Windows Forms.

Syntaxe

template<class TManagedControl>
class CWinFormsControl : public CWnd

Paramètres

TManagedControl
Contrôle Windows Forms .NET Framework à afficher dans l’application MFC.

Membres

Constructeurs publics

Nom Description
CWinFormsControl ::CWinFormsControl Construit un objet wrapper de contrôle Windows Forms MFC.

Méthodes publiques

Nom Description
CWinFormsControl ::CreateManagedControl Crée un contrôle Windows Forms dans un conteneur MFC.
CWinFormsControl ::GetControl Récupère un pointeur vers le contrôle Windows Forms.
CWinFormsControl ::GetControlHandle Récupère un handle dans le contrôle Windows Forms.

Opérateurs publics

Nom Description
CWinFormsControl::operator -> Remplace CWinFormsControl ::GetControl dans les expressions.
CWinFormsControl ::operator TManagedControl^ Convertit un type en tant que pointeur vers un contrôle Windows Forms.

Notes

La CWinFormsControl classe fournit les fonctionnalités de base pour l’hébergement d’un contrôle Windows Forms.

Pour plus d’informations sur l’utilisation de Windows Forms, consultez Utilisation d’un contrôle utilisateur Windows Form dans MFC.

Votre code MFC ne doit pas mettre en cache les handles de fenêtre (généralement stockés dans m_hWnd). Certaines propriétés de contrôle Windows Forms nécessitent que le win32 Window sous-jacent soit détruit et recréé à l’aide DestroyWindow et CreateWindow. L’implémentation windows Forms MFC gère les événements et Create les Destroy événements des contrôles pour mettre à jour le m_hWnd membre.

Remarque

L’intégration de Windows Forms MFC fonctionne uniquement dans les projets qui sont liés dynamiquement à MFC (dans lesquels AFXDLL est défini).

Spécifications

En-tête : afxwinforms.h

CWinFormsControl ::CreateManagedControl

Crée un contrôle Windows Forms dans un conteneur MFC.

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);

Paramètres

pType
Type de données du contrôle à créer. Doit être un type de données Type .

dwStyle
Style de fenêtre à appliquer au contrôle. Spécifiez une combinaison de styles de fenêtre. Actuellement, seuls les styles suivants sont pris en charge : WS_TABSTOP, WS_VISIBLE, WS_DISABLED et WS_GROUP.

rect
Structure RECT qui définit les coordonnées des coins supérieur gauche et inférieur droit du contrôle (première surcharge uniquement).

nPlaceHolderID
Handle du contrôle d’espace réservé statique placé dans l’Éditeur de ressources. Le contrôle Windows Forms nouvellement créé remplace le contrôle statique, en supposant sa position, son ordre z et ses styles (deuxième surcharge uniquement).

pParentWnd
Pointeur vers la fenêtre parente.

nID
Numéro d’ID de ressource à affecter au contrôle nouvellement créé.

pControl
Instance d’un contrôle Windows Forms à associer à l’objet CWinFormsControl (quatrième surcharge uniquement).

Valeur de retour

Si elle réussit, retourne une valeur différente de zéro. En cas d’échec, retourne zéro.

Notes

Cette méthode instancie un contrôle Windows Forms .NET Framework dans un conteneur MFC.

La première surcharge de la méthode accepte un type de données .NET Framework pType afin que MFC puisse instancier un nouvel objet de ce type. pType doit être un type de données Type .

La deuxième surcharge de la méthode crée un contrôle Windows Forms basé sur le TManagedControl paramètre de modèle de la CWinFormsControl classe. La taille et la position du contrôle sont basées sur la RECT structure passée à la méthode. Seul dwStyle importe pour les styles.

La troisième surcharge de la méthode crée un contrôle Windows Forms qui remplace un contrôle statique, le détruisant et en supposant sa position, l’ordre z et les styles. Le contrôle statique sert uniquement d’espace réservé pour le contrôle Windows Forms. Lors de la création du contrôle, cette surcharge combine les styles de dwStyle avec les styles de ressources du contrôle statique.

La quatrième surcharge de la méthode vous permet de passer un contrôle Windows Forms déjà instancié pControl que MFC encapsule. Il doit être du même type que le TManagedControl paramètre de modèle de la CWinFormsControl classe.

Consultez Utilisation d’un contrôle utilisateur Windows Form dans MFC pour obtenir des exemples sur l’utilisation des contrôles Windows Form.

CWinFormsControl ::CWinFormsControl

Construit un objet wrapper de contrôle Windows Forms MFC.

CWinFormsControl();

Notes

Le contrôle Windows Forms est instancié lorsque vous appelez CWinFormsControl ::CreateManagedControl.

CWinFormsControl ::GetControl

Récupère un pointeur vers le contrôle Windows Forms.

inline TManagedControl^ GetControl() const;

Valeur de retour

Retourne un pointeur vers le contrôle Windows Forms.

Exemple

Consultez CWinFormsControl ::CreateManagedControl.

CWinFormsControl ::GetControlHandle

Récupère un handle dans le contrôle Windows Forms.

inline HWND GetControlHandle() const;

Valeur de retour

Retourne un handle au contrôle Windows Forms.

Notes

GetControlHandle est une méthode d’assistance qui retourne le handle de fenêtre stocké dans les propriétés du contrôle .NET Framework. La valeur du handle de fenêtre est copiée dans CWnd ::m_hWnd pendant l’appel à CWnd ::Attach.

CWinFormsControl::operator ->

Remplace CWinFormsControl ::GetControl dans les expressions.

inline TManagedControl^  operator->() const;

Notes

Cet opérateur fournit une syntaxe pratique qui remplace dans les GetControl expressions.

Pour plus d’informations sur Windows Forms, consultez Utilisation d’un contrôle utilisateur Windows Form dans MFC.

CWinFormsControl ::operator TManagedControl^

Convertit un type en tant que pointeur vers un contrôle Windows Forms.

inline operator TManagedControl^() const;

Notes

Cet opérateur passe CWinFormsControl<TManagedControl> aux fonctions qui acceptent un pointeur vers un contrôle Windows Forms.

Voir aussi

CWinFormsDialog, classe
CWinFormsView, classe