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.
Important
This class and its members cannot be used in applications that execute in the Windows Runtime.
Syntax
template <class TBase = CWindow>
class CAxWindow2T :
public CAxWindowT<TBase>
Parameters
TBase
The class from which CAxWindowT derives.
Members
Public Constructors
| Name | Description |
|---|---|
| CAxWindow2T::CAxWindow2T | Constructs a CAxWindow2T object. |
Public Methods
| Name | Description |
|---|---|
| CAxWindow2T::Create | Creates a host window. |
| CAxWindow2T::CreateControlLic | Creates a licensed ActiveX control, initializes it, and hosts it in the specified window. |
| 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. |
| CAxWindow2T::GetWndClassName | Static method that retrieves the name of the window class. |
Public Operators
| Name | Description |
|---|---|
| CAxWindow2T::operator = | Assigns an HWND to an existing CAxWindow2T object. |
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;
Note
CAxWindowT members are documented under CAxWindow.
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.