CAxWindow::CreateControl
Crée un contrôle ActiveX, l'initialise, et le héberge dans la fenêtre spécifiée.
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> »
[!REMARQUE]
« 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é.
Exemple
Consultez Contrôles ActiveX d'hébergement à l'aide de ATL AXHost pour obtenir un exemple qui utilise CreateControl.
Configuration requise
Header: atlwin.h