Partager via


CAxWindow::CreateControlEx

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

HRESULT CreateControlEx( 
   LPCOLESTR lpszName, 
   IStream* pStream = NULL, 
   IUnknown** ppUnkContainer = NULL, 
   IUnknown** ppUnkControl = NULL, 
   REFIID iidSink = IID_NULL, 
   IUnknown* punkSink = NULL  
); 
HRESULT CreateControlEx( 
   DWORD dwResID, 
   IStream* pStream = NULL, 
   IUnknown** ppUnkContainer = NULL, 
   IUnknown** ppUnkControl = NULL, 
   REFIID iidSink = IID_NULL, 
   IUnknown* punkSink = 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.

  • ppUnkControl
    [out] l'adresse d'un pointeur qui recevra IUnknown du contrôle. Peut être NULL.

  • iidSink
    [in] L'identificateur d'interface d'une interface sortante sur l'objet contenu. Peut être IID_NULL.

  • punkSink
    [in] Pointeur vers l'interface d' IUnknown de l'objet sink à connecter au point de connexion sur l'objet contenu spécifié par iidSink.

  • dwResID
    [in] 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

Cette méthode est similaire à CAxWindow::CreateControl, mais contrairement à cette méthode, CreateControlEx vous permet également de recevoir un pointeur d'interface vers le contrôle que vous venez de créer et installer un récepteur d'événements pour recevoir des événements déclenchés par le contrôle.

Consultez CAxWindow2T::CreateControlLicEx 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 CreateControlEx.

Configuration requise

Header: atlwin.h

Voir aussi

Référence

CAxWindow, classe

AtlAxCreateControlEx