Partager via


COleControlContainer::CreateControl

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

BOOL CreateControl(
   CWnd* pWndCtrl,
   REFCLSID clsid,
   LPCTSTR lpszWindowName,
   DWORD dwStyle,
   const RECT& rect,
   UINT nID,
   CFile* pPersist=NULL,
   BOOL bStorage=FALSE,
   BSTR bstrLicKey=NULL,
   COleControlSite** ppNewSite=NULL 
);
BOOL 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,
   COleControlSite** ppNewSite=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é de texte du contrôle (le cas échéant).Si NULL, la légende du contrôle ou la propriété Text n'est pas modifié.

  • 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.

  • ppNewSite
    Pointeur vers le site de contrôle existant qui héberge le contrôle est créé.La valeur par défaut est NULL, indiquant qu'un site de contrôle sera créé automatiquement et joint au nouveau contrôle.

  • 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 la position du 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 la position du contrôle.

Valeur de retour

Une valeur différente de zéro si l'opération a réussi ; sinon 0.

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 .

Utilisez la deuxième surcharge pour créer les contrôles de taille d'une valeur par défaut.

Configuration requise

Header: afxocc.h

Voir aussi

Référence

Classe de COleControlContainer

Graphique de la hiérarchie