COleControlSite::CreateControl

Article
06/10/2015

Crée un contrôle ActiveX, hébergé par l'objet d' COleControlSite .

virtual HRESULT CreateControl( 
   CWnd* pWndCtrl, 
   REFCLSID clsid, 
   LPCTSTR lpszWindowName, 
   DWORD dwStyle, 
   const RECT& rect, 
   UINT nID, 
   CFile* pPersist = NULL, 
   BOOL bStorage = FALSE, 
   BSTR bstrLicKey = NULL  
); 
virtual HRESULT CreateControl( 
   CWnd* pWndCtrl, 
   REFCLSID clsid, 
   LPCTSTR lpszWindowName, 
   DWORD dwStyle, 
   const POINT* ppt, 
   const SIZE* psize, 
   UINT nID, 
   CFile* pPersist = NULL, 
   BOOL bStorage = FALSE, 
   BSTR bstrLicKey = NULL  
);

Paramètres

pWndCtrl
Pointeur vers l'objet window représentant le contrôle.
clsid
Le seul ID de classe du contrôle.
lpszWindowName
Pointeur vers le texte à afficher dans le contrôle. Définit la valeur de la légende ou de la propriété Text des winodw (le cas échéant).
dwStyle
Styles Windows. Les styles disponibles sont répertoriés dans la section de Notes .
rect
Spécifie la taille et la position du contrôle. Ce peut être un objet d' CRect ou une structure d' RECT .
nID
Spécifie l'ID de la fenêtre enfant du contrôle
pPersist
Un pointeur vers CFile contenant l'état de persistance pour le contrôle. La valeur par défaut est NULL, indiquant que le contrôle s'initialise sans restaurer son état de toute mémoire persistant. Sinon NULL, il doit être un pointeur vers CFile- l'objet dérivé contenant les données persistantes du contrôle, sous la forme de flux ou de mémoire. Ces données peuvent avoir été enregistrées dans un lancement précédent du client. CFile peut contenir d'autres données, mais doit faire définir son pointeur lecture/écriture au 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 IStorage données ou d' IStream . Si les données dans pPersist sont une mémoire, bStorage doit être TRUE. Si les données dans pPersist sont un flux, bStorage doit être FALSE. La valeur par défaut est FALSE.
bstrLicKey
Données facultatives de licence. Ces données sont requises uniquement pour créer des contrôles qui requièrent une clé de licence utilisateur. Si le contrôle prend en charge l'attribution d'une licence, vous devez fournir une clé de licence pour la création du contrôle pour réussir. La valeur par défaut est NULL.
ppt
Un pointeur vers une structure de POINT qui contient le coin supérieur gauche du contrôle. La taille du contrôle est déterminée par la valeur de psize. ppt et psize les valeurs sont une méthode facultative de spécifier la taille et positionnent l'opf le contrôle.
psize
Un pointeur vers une structure de TAILLE qui contient la taille du contrôle. L'angle supérieur gauche est déterminé par la valeur d' ppt. ppt et psize les valeurs sont une méthode facultative de spécifier la taille et positionnent l'opf le contrôle.

Valeur de retour

Une valeur standard d' HRESULT .

Notes

Seul un sous-ensemble des balises d' dwStyle windows en charge par CreateControl:

WS_VISIBLE crée une fenêtre qui est initialement visible. Obligatoire si vous souhaitez que le contrôle soit visible immédiatement, comme les 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 l'entrée de l'utilisateur. Peut être défini si le contrôle a une propriété Enabled.
WS_BORDER crée une fenêtre avec une bordure épurée de. Peut être défini si le contrôle possède une propriété de BorderStyle.
WS_GROUP spécifie le premier contrôle d'un groupe de contrôles. L'utilisateur peut modifier le focus clavier d'un contrôle au groupe à la suivante à l'aide de les touches de direction. Tout contrôle défini avec le style de WS_GROUP après le premier contrôle appartiennent au même groupe. Le contrôle suivant avec le style de WS_GROUP termine le groupe et met démarrer le groupe.
WS_TABSTOP spécifie un contrôle pouvant recevoir le focus clavier lorsque l'utilisateur appuie sur la touche TAB. Appuyant sur les modifications de touche TAB le focus clavier au contrôle suivant du style de WS_TABSTOP .