CAxWindow::CreateControl

Article
10/18/2015

Crée un contrôle ActiveX, l'initialise, et le héberge dans la fenêtre spécifiée.

Syntaxe

      HRESULT CreateControl(
   LPCOLESTR lpszName,
   IStream* pStream = NULL,
   IUnknown** ppUnkContainer = NULL 
);
HRESULT CreateControl(
   DWORD dwResID,
   IStream* pStream = NULL,
   IUnknown** ppUnkContainer = NULL 
);

Paramètres

lpszName
Un pointeur vers une chaîne pour créer le contrôle.Doit être mis en forme dans l'une des façons suivantes :
- Un progid tel que « MSCAL.Calendar.7 »
- Le CLSID (« {} » 8E27C92B-1264-101C-8A2F-040224009C02
- UNE URL telle que « https://www.microsoft.com »
- Une référence à un document actif tel que « \\Documents\MyDoc file:// » .doc
- Un fragment HTML tel que « MSHTML :<HTML><BODY>cela est une ligne de text</body></html> »
  
  Notes
  
  « MSHTML : » doit précéder le fragment de code HTML afin qu'il soit indiquée comme être un flux de MSHTML.Seul l'identificateur programmatique et le CLSID en charge dans les plateformes Windows Mobiles.Windows CE a incorporé plateformes, autre que Windows Mobile avec la prise en charge de pour pocket CE tous les types notamment l'identificateur programmatique, le CLSID, l'URL, la référence au document actif, et le fragment de code HTML.
pStream
[in] Un pointeur vers un flux qui est utilisé pour initialiser les propriétés du contrôle.Peut être NULL.
ppUnkContainer
[out] l'adresse d'un pointeur qui recevra IUnknown du conteneur.Peut être NULL.
dwResID
l'ID de ressource d'une ressource HTML.Le contrôle WebBrowser est créé et chargé avec la ressource spécifiée.

Valeur de retour

Une valeur standard d' HRESULT .

Notes

Si la deuxième version de cette méthode est utilisée, un contrôle HTML est créé et lié à la ressource identifiée par dwResID.

Cette méthode fournit le même résultat que l'appel :

AtlAxCreateControlEx(lpszName, hWnd, pStream, NULL, NULL, GUID_NULL, NULL);

Consultez CAxWindow2T::CreateControlLic pour créer, démarrer, et héberger un contrôle ActiveX autorisé.

Consultez Contrôles ActiveX d'hébergement à l'aide de ATL AXHost pour obtenir un exemple qui utilise CreateControl.

Configuration requise

Header: atlwin.h

Voir aussi

CAxWindow Class
AtlAxCreateControl

Partager via