Partager via


AtlAxCreateControlEx

Crée un contrôle ActiveX, l'initialise, et le héberge dans la fenêtre spécifiée. Un pointeur d'interface et un récepteur d'événements pour le contrôle peuvent également être créés.

Important

Cette fonction ne peut pas être utilisée dans les applications qui s'exécutent dans Windows Runtime.

ATLAPI AtlAxCreateControlEx( 
LPCOLESTR lpszName, 
HWND hWnd, 
IStream* pStream, 
IUnknown** ppUnkContainer, 
IUnknown** ppUnkControl, 
REFIID iidSink = IID_NULL, 
IUnknown* punkSink = NULL 
);

Paramètres

  • lpszName
    Un pointeur vers une chaîne à passer au 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.

  • hWnd
    [in] Handle dans la fenêtre que le contrôle est attaché.

  • 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 créé. Peut être NULL.

  • iidSink
    L'identificateur d'interface d'une interface sortante sur l'objet contenu.

  • punkSink
    Pointeur vers l'interface d' IUnknown de l'objet sink à connecter au point de connexion spécifié par iidSink sur l'objet contenu après que l'objet contenu a été correctement créé.

Valeur de retour

L'une des valeurs HRESULT standard.

Notes

AtlAxCreateControlEx est semblable à AtlAxCreateControl mais 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.

Pour créer un contrôle ActiveX autorisé, consultez l' AtlAxCreateControlLicEx.

Configuration requise

Header: atlhost.h

Voir aussi

Référence

CAxWindow::CreateControlEx

Concepts

Notions de base du contrôle composite

Autres ressources

Fonctions globales de contrôle composite