CWnd::CreateControl

BOOL CWnd::CreateControl (LPCTSTR lpszClass, LPCTSTR lpszWindowName, DWORD dwStyleRECTamp const ;RectCWnd *,pParentWndUINTnIDCFile *pPersist= NULL, BOOLbStorage= F&ALSE, BSTRbstrLicKey = NULL );

BOOL CWnd::CreateControl (REFCLSID clsid, LPCTSTR lpszWindowName, DWORD dwStyleRECTamp const ;RectCWnd *,pParentWndUINTnIDCFile *pPersist= NULL, BOOLbStorage= F&ALSE, BSTRbstrLicKey = NULL );

Valeur de retour

Différent de zéro en cas de succès ; sinon 0.

Paramètres

lpszClass

Cette chaîne peut contenir l'OLE « nom court » (ProgID) pour la classe, par exemple, « CIRC3.Circ3Ctrl.1 ». Le nom doit correspondre au nom même enregistré par le contrôle. Par ailleurs, la chaîne peut contenir la forme de chaîne d'un CLSID, figurant entre accolades, par exemple, "{9DBAFCCF-592F-101B-85CE-00608CEC297B}". Dans les deux cas, CreateControl convertit la chaîne de l'ID de classe correspondants.

lpszWindowName

Un pointeur sur le texte à afficher dans le contrôle. Définit la valeur de la propriété Caption ou du texte du contrôle (le cas échéant). Si NULL, le contrôle de la légende ou la propriété Text n'est pas modifiée.

dwStyle

Styles de fenêtres. Les styles disponibles sont répertoriés sous remarques.

rect

Spécifie la taille et la position du contrôle. Il peut être un objet CRect ou une structure RECT.

pParentWnd

Spécifie la fenêtre du contrôle parent. Il ne doit pas être NULL.

nID

Spécifie l'ID du contrôle.

pPersist

Pointeur vers un CFile contenant l'état persistant du contrôle. La valeur par défaut est NULL, ce qui indique que le contrôle s'initialise sans restaurer son état à partir d'un stockage persistant. Si c'est pas NULL, il doit être un pointeur vers un CFile-objet qui contient les données du contrôle persistantes, sous la forme d'un flux ou un stockage dérivé. Ces données pourraient ont été enregistrées dans une précédente activation du client. CFile peut contenir d'autres données, mais devez avoir son pointeur de lecture-écriture établi pour le premier octet de données persistantes au moment de l'appel à CreateControl.

bStorage

Indique si les données dans pPersist doivent être interprétées comme données IStorage ou IStream. Si les données de pPersist soient un stockage, bStorage doit être TRUE. Si les données de pPersist soient un cours d'eau, bStorage doit être FALSE. La valeur par défaut est FALSE.

bstrLicKey

Option données de clés de licence. Ces données sont nécessaires uniquement pour créer des contrôles qui nécessitent une clé de licence de run-time. Si le contrôle prend en charge les licences, vous devez fournir une clé de licence pour la création du contrôle pour réussir. La valeur par défaut est NULL.

clsid

L'ID de classe unique du contrôle.

Remarques

Utilisez cette fonction membre pour créer un contrôle OLE qui sera représenté dans le programme MFC par un objet CWnd . CreateControl est un analogue direct de la fonction CWnd::Create , qui crée la fenêtre pour une CWnd. CreateControl crée un contrôle OLE au lieu d'une fenêtre ordinaire.

Seul un sous-ensemble des drapeaux dwStyle Windows sont pris en charge pour CreateControl:

WS_VISIBLE ; Crée une fenêtre qui est initialement visible. Requis si vous souhaitez que le contrôle doit être visible immédiatement, comme des fenêtres ordinaires.
WS_DISABLED ; Crée une fenêtre qui est initialement désactivée. Une fenêtre désactivée ne peut pas recevoir les commentaires de l'utilisateur. Peut être définie si le contrôle a une propriété Enabled.
WS_BORDER ; par co&nséquentnbsp ; Crée une fenêtre avec une bordure de ligne mince. Peut être définie si le contrôle a une propriété StyleBordure (BorderStyle).
WS_GROUP ; Spécifie le premier contrôle d'un groupe de contrôles. L'utilisateur peut changer le focus clavier d'un contrôle dans le groupe à l'autre en utilisant les touches de direction. Tous les contrôles définis avec le style WS_GROUP après le premier contrôle appartiennent au même groupe. Le contrôle suivant avec le style WS_GROUP termine le groupe et commence le prochain groupe.
WS_TABSTOP ; Spécifie un contrôle qui peut recevoir le focus clavier lorsque l'utilisateur appuie sur la touche TAB. La touche TAB change le focus clavier vers le contrôle suivant le style WS_TABSTOP.

Aperçu de CWnd |nbsp ; Membres de la classe | Graphique de la hiérarchie

Voir aussi ; Dans le Guide du programmeur Visual C++: sujets de contrôle ActiveX

Index