CAxWindow2T Class

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at CAxWindow2T Class.

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

System_CAPS_ICON_important.jpg Important

This class and its members cannot be used in applications that execute in the Windows Runtime.

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

Parameters

TBase
The class from which CAxWindowT derives.

Public Constructors

NameDescription
CAxWindow2T::CAxWindow2TConstructs a CAxWindow2T object.

Public Methods

NameDescription
CAxWindow2T::CreateCreates a host window.
CAxWindow2T::CreateControlLicCreates a licensed ActiveX control, initializes it, and hosts it in the specified window.
CAxWindow2T::CreateControlLicExCreates a licensed ActiveX control, initializes it, hosts it in the specified window, and retrieves an interface pointer (or pointers) from the control.
CAxWindow2T::GetWndClassNameStatic method that retrieves the name of the window class.

Public Operators

NameDescription
CAxWindow2T::operator =Assigns an HWND to an existing CAxWindow2T object.

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;

System_CAPS_ICON_note.jpg Note

CAxWindowT members are documented under CAxWindow.

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

TBase

CAxWindowT

CAxWindow2T

Header: atlwin.h

Constructs a CAxWindow2T object.

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

Parameters

hWnd
A handle of an existing window.

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.

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.

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.

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.

Assigns an HWND to an existing CAxWindow2T object.

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

Parameters

hWnd
A handle of an existing window.

Class Overview
Control Containment FAQ

Show: