CAxWindow2T Class

This class provides methods for manipulating a window that hosts an ActiveX control, and also has support for hosting licensed ActiveX controls.

Syntax

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

Parameters

TBase
The class from which CAxWindowT derives.

Members

Public Constructors

Public Methods

Public Operators

Remarks

CAxWindow2T provides methods for manipulating a window that hosts an ActiveX control. CAxWindow2T also has support for hosting licensed ActiveX controls. The hosting is provided by " AtlAxWinLic80", which is wrapped by CAxWindow2T.

Class CAxWindow2 is implemented as a specialization of the CAxWindow2T class. This specialization is declared as:

typedef CAxWindow2T <CWindow> CAxWindow2;

See Hosting ActiveX Controls Using ATL AXHost for a sample that uses the members of this class.

Inheritance Hierarchy

TBase

CAxWindowT

CAxWindow2T

Requirements

Header: atlwin.h

CAxWindow2T::CAxWindow2T

Constructs a CAxWindow2T object.

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

Parameters

hWnd
A handle of an existing window.

CAxWindow2T::Create

Creates a host window.

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

Remarks

CAxWindow2T::Create calls CWindow::Create with the LPCTSTR lpstrWndClass parameter set to the window class that provides control hosting (AtlAxWinLic80).

See CWindow::Create for a description of the parameters and return value.

Note If 0 is used as the value for the MenuOrID parameter, it must be specified as 0U (the default value) to avoid a compiler error.

Example

See Hosting ActiveX Controls Using ATL AXHost for a sample that uses CAxWindow2T::Create.

CAxWindow2T::CreateControlLic

Creates a licensed ActiveX control, initializes it, and hosts it in the specified window.

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);

Parameters

bstrLicKey
The license key for the control; NULL if creating a nonlicensed control.

Remarks

See CAxWindow::CreateControl for a description of the remaining parameters and return value.

Example

See Hosting ActiveX Controls Using ATL AXHost for a sample that uses CAxWindow2T::CreateControlLic.

CAxWindow2T::CreateControlLicEx

Creates a licensed ActiveX control, initializes it, hosts it in the specified window, and retrieves an interface pointer (or pointers) from the control.

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);

Parameters

bstrLicKey
The license key for the control; NULL if creating a nonlicensed control.

Remarks

See CAxWindow::CreateControlEx for a description of the remaining parameters and return value.

Example

See Hosting ActiveX Controls Using ATL AXHost for a sample that uses CAxWindow2T::CreateControlLicEx.

CAxWindow2T::GetWndClassName

Retrieves the name of the window class.

static LPCTSTR GetWndClassName();

Return Value

A pointer to a string containing the name of the window class (AtlAxWinLic80) that can host licensed and nonlicensed ActiveX controls.

CAxWindow2T::operator =

Assigns an HWND to an existing CAxWindow2T object.

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

Parameters

hWnd
A handle of an existing window.

See also

Class Overview
Control Containment FAQ