CAxWindow2T, classe

  • Article

Cette classe fournit des méthodes pour manipuler une fenêtre qui héberge un contrôle ActiveX et prend également en charge l’hébergement de contrôles ActiveX sous licence.

Important

Cette classe et ses membres ne peuvent pas être utilisés dans les applications qui s’exécutent dans Windows Runtime.

Syntaxe

template <class TBase = CWindow>
    class CAxWindow2T :
    public CAxWindowT<TBase>

Paramètres

TBase
Classe à partir de laquelle CAxWindowT dérive.

Membres

Constructeurs publics

Nom Description
CAxWindow2T ::CAxWindow2T Construit un objet CAxWindow2T.

Méthodes publiques

Nom Description
CAxWindow2T ::Create Crée une fenêtre hôte.
CAxWindow2T ::CreateControlLic Crée un contrôle ActiveX sous licence, puis initialise et héberge ce dernier dans la fenêtre spécifiée.
CAxWindow2T ::CreateControlLicEx Crée un contrôle ActiveX sous licence, l’initialise, l’héberge dans la fenêtre spécifiée et récupère un pointeur d’interface (ou des pointeurs) à partir du contrôle.
CAxWindow2T ::GetWndClassName Méthode statique qui récupère le nom de la classe de fenêtre.

Opérateurs publics

Nom Description
CAxWindow2T ::operator = Affecte un HWND à un objet existant CAxWindow2T .

Notes

CAxWindow2T fournit des méthodes pour manipuler une fenêtre qui héberge un contrôle ActiveX. CAxWindow2T prend également en charge l’hébergement de contrôles ActiveX sous licence. L’hébergement est fourni par « AtlAxWinLic80 », qui est encapsulé par CAxWindow2T.

La classe CAxWindow2 est implémentée en tant que spécialisation de la CAxWindow2T classe. Cette spécialisation est déclarée comme suit :

typedef CAxWindow2T <CWindow> CAxWindow2;

Remarque

CAxWindowT les membres sont documentés sous CAxWindow.

Consultez l’hébergement de contrôles ActiveX à l’aide d’ATL AXHost pour obtenir un exemple qui utilise les membres de cette classe.

Hiérarchie d'héritage

TBase

CAxWindowT

CAxWindow2T

Spécifications

En-tête : atlwin.h

CAxWindow2T ::CAxWindow2T

Construit un objet CAxWindow2T.

CAxWindow2T(HWND  hWnd = NULL) : CAxWindowT<TBase>(hWnd)

Paramètres

hWnd
Handle d’une fenêtre existante.

CAxWindow2T ::Create

Crée une fenêtre hôte.

HWND Create(
    HWND hWndParent,
    _U_RECT rect = NULL,
    LPCTSTR szWindowName = NULL,
    DWORD dwStyle = 0,
    DWORD dwExStyle = 0,
    _U_MENUorID MenuOrID = 0U,
    LPVOID lpCreateParam = NULL);

Notes

CAxWindow2T::Create appelle CWindow ::Create avec le paramètre LPCTSTR lpstrWndClass défini sur la classe de fenêtre qui fournit l’hébergement de contrôle (AtlAxWinLic80).

Consultez CWindow::Create la description des paramètres et de la valeur de retour.

Remarque Si 0 est utilisé comme valeur pour le paramètre MenuOrID , il doit être spécifié en tant que 0U (valeur par défaut) pour éviter une erreur du compilateur.

Exemple

Consultez l’hébergement de contrôles ActiveX à l’aide d’ATL AXHost pour un exemple qui utilise CAxWindow2T::Create.

CAxWindow2T ::CreateControlLic

Crée un contrôle ActiveX sous licence, puis initialise et héberge ce dernier dans la fenêtre spécifiée.

HRESULT CreateControlLic(
    DWORD dwResID,
    IStream* pStream = NULL,
    IUnknown** ppUnkContainer = NULL,
    BSTR bstrLicKey = NULL);

HRESULT CreateControlLic(
    LPCOLESTR lpszName,
    IStream* pStream = NULL,
    IUnknown** ppUnkContainer = NULL,
    BSTR bstrLicKey = NULL);

Paramètres

bstrLicKey
Clé de licence pour le contrôle ; NULL si vous créez un contrôle non licence.

Notes

Consultez CAxWindow ::CreateControl pour obtenir une description des paramètres restants et de la valeur de retour.

Exemple

Consultez l’hébergement de contrôles ActiveX à l’aide d’ATL AXHost pour un exemple qui utilise CAxWindow2T::CreateControlLic.

CAxWindow2T ::CreateControlLicEx

Crée un contrôle ActiveX sous licence, l’initialise, l’héberge dans la fenêtre spécifiée et récupère un pointeur d’interface (ou des pointeurs) à partir du contrôle.

HRESULT CreateControlLicEx(
    LPCOLESTR lpszName,
    IStream* pStream = NULL,
    IUnknown** ppUnkContainer = NULL,
    IUnknown** ppUnkControl = NULL,
    REFIID iidSink = IID_NULL,
    IUnknown* punkSink = NULL,
    BSTR bstrLicKey = NULL);

    HRESULT CreateControlLicEx(
    DWORD dwResID,
    IStream* pStream = NULL,
    IUnknown** ppUnkContainer = NULL,
    IUnknown** ppUnkControl = NULL,
    REFIID iidSink = IID_NULL,
    IUnknown* punkSink = NULL,
    BSTR bstrLickey = NULL);

Paramètres

bstrLicKey
Clé de licence pour le contrôle ; NULL si vous créez un contrôle non licence.

Notes

Consultez CAxWindow ::CreateControlEx pour obtenir une description des paramètres restants et de la valeur de retour.

Exemple

Consultez l’hébergement de contrôles ActiveX à l’aide d’ATL AXHost pour un exemple qui utilise CAxWindow2T::CreateControlLicEx.

CAxWindow2T ::GetWndClassName

Récupère le nom de la classe de fenêtre.

static LPCTSTR GetWndClassName();

Valeur de retour

Pointeur vers une chaîne contenant le nom de la classe de fenêtre (AtlAxWinLic80) qui peut héberger des contrôles ActiveX sous licence et non autorisés.

CAxWindow2T ::operator =

Affecte un HWND à un objet existant CAxWindow2T .

CAxWindow2T<TBase>& operator= (HWND hWnd);

Paramètres

hWnd
Handle d’une fenêtre existante.

Voir aussi

Vue d’ensemble de la classe
Faq sur le contrôle de l’autonomie