Quel est l'API d'Hébergement contrôle ATL ?
L'API d'hébergement du contrôle ATL est l'ensemble de fonctions qui permet à n'importe quelle fenêtre pour agir comme un conteneur de contrôles ActiveX.Ces fonctions peuvent incorporer statiquement ou dynamiquement dans votre projet étant donné qu'ils sont disponibles en tant que code source et exposé par ATL90.dll.Les fonctions de contrôle hébergement sont répertoriées dans le tableau ci-dessous.
Fonction |
Description |
|---|---|
Crée un objet hôte, le connecte à la fenêtre fournie, puis lie un contrôle existant. |
|
Crée un objet hôte, le connecte à la fenêtre fournie, puis charge un contrôle. |
|
Crée un contrôle ActiveX autorisé, l'initialise, et le héberge dans la fenêtre spécifiée, semblable à AtlAxCreateControl. |
|
Crée un objet hôte, le connecte à la fenêtre fournie, puis charge un contrôle (permet également des récepteurs d'événements à installer). |
|
Crée un contrôle ActiveX autorisé, l'initialise, et le héberge dans la fenêtre spécifiée, semblable à AtlAxCreateControlLic. |
|
Crée une boîte de dialogue non modale d'une ressource de boîte de dialogue et retourne le handle de fenêtre. |
|
Crée une boîte de dialogue modale d'une ressource de boîte de dialogue. |
|
Retourne le pointeur d'interface de IUnknown du contrôle hébergé dans une fenêtre. |
|
Retourne le pointeur d'interface de IUnknown de l'objet hôte connecté à une fenêtre. |
|
Initialise le code de contrôle hébergement. |
|
Uninitializes le code de contrôle hébergement. |
Les paramètres d' HWND dans les trois premières fonctions doivent être une fenêtre existante (presque) de tout type.Si vous appelez l'une de ces trois fonctions de manière explicite (en général, vous devez pas), ne passez pas un handle vers une fenêtre qui agit comme déjà hôte (dans ce cas, l'objet hôte existant ne sera pas libéré).
Appel de sept le premier fonctions AtlAxWinInit implicitement.
[!REMARQUE]
L'API de contrôle hébergement forme la base de la prise en charge ATL de la relation contenant-contenu de contrôle ActiveX.Toutefois, il y a généralement peu de besoin d'appeler ces fonctions directement si vous tirez parti ou utiliser pleinement les classes wrapper ATL.Pour plus d'informations, consultez Classe ATL qui facilitent la relation contenant-contenu de contrôle ActiveX ?.