Clase CAxWindow2T
Esta clase proporciona métodos para manipular una ventana que hospeda un control ActiveX y también es compatible con el hospedaje de controles ActiveX con licencia.
Importante
Esta clase y sus miembros no se pueden usar en las aplicaciones que se ejecutan en Windows Runtime.
Sintaxis
template <class TBase = CWindow>
class CAxWindow2T :
public CAxWindowT<TBase>
Parámetros
TBase
La clase de la que CAxWindowT
se deriva.
Miembros
Constructores públicos
Nombre | Descripción |
---|---|
CAxWindow2T::CAxWindow2T | Construye un objeto CAxWindow2T . |
Métodos públicos
Nombre | Descripción |
---|---|
CAxWindow2T::Create | Crea una ventana de host. |
CAxWindow2T::CreateControlLic | Crea un control ActiveX con licencia, lo inicializa y lo hospeda en la ventana especificada. |
CAxWindow2T::CreateControlLicEx | Crea un control ActiveX con licencia, lo inicializa, lo hospeda en la ventana especificada y recupera un puntero (o punteros) de interfaz del control. |
CAxWindow2T::GetWndClassName | Método estático que recupera el nombre de la clase de ventana. |
Operadores públicos
Nombre | Descripción |
---|---|
CAxWindow2T::operator = | Asigna HWND a un objeto CAxWindow2T existente. |
Comentarios
CAxWindow2T
proporciona métodos para manipular una ventana que hospeda un control ActiveX. CAxWindow2T
también admite el hospedaje de controles ActiveX con licencia. El hospedaje lo proporciona "AtlAxWinLic80", que se encapsula mediante CAxWindow2T
.
La clase CAxWindow2
se implementa como una especialización de la clase CAxWindow2T
. Esta especialización se declara de la siguiente forma:
typedef CAxWindow2T <CWindow> CAxWindow2;
Nota:
Los miembros de CAxWindowT
se documentan en CAxWindow.
Consulte Hospedaje de controles ActiveX mediante ATL AXHost para obtener un ejemplo que utilice a los miembros de esta clase.
Jerarquía de herencia
TBase
CAxWindowT
CAxWindow2T
Requisitos
Encabezado: atlwin.h
CAxWindow2T::CAxWindow2T
Construye un objeto CAxWindow2T
.
CAxWindow2T(HWND hWnd = NULL) : CAxWindowT<TBase>(hWnd)
Parámetros
hWnd
Manipulador de una ventana existente.
CAxWindow2T::Create
Crea una ventana de host.
HWND Create(
HWND hWndParent,
_U_RECT rect = NULL,
LPCTSTR szWindowName = NULL,
DWORD dwStyle = 0,
DWORD dwExStyle = 0,
_U_MENUorID MenuOrID = 0U,
LPVOID lpCreateParam = NULL);
Comentarios
CAxWindow2T::Create
llama a CWindow::Create con el parámetro LPCTSTR lpstrWndClass establecido en la clase de ventana que proporciona hospedaje de controles (AtlAxWinLic80
).
Consulte CWindow::Create
para obtener una descripción de los parámetros y el valor devuelto.
Nota Si se usa 0 como valor para el parámetro MenuOrID, se debe especificar como 0U (valor predeterminado) para evitar un error del compilador.
Ejemplo
Consulte Hospedar controles ActiveX mediante ATL AXHost para obtener un ejemplo que utilice CAxWindow2T::Create
.
CAxWindow2T::CreateControlLic
Crea un control ActiveX con licencia, lo inicializa y lo hospeda en la ventana especificada.
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);
Parámetros
bstrLicKey
Clave de licencia para el control; NULL si se crea un control sin licencia.
Comentarios
Consulte CAxWindow::CreateControl para obtener una descripción de los parámetros restantes y del valor devuelto.
Ejemplo
Consulte Hospedar controles ActiveX mediante ATL AXHost para obtener un ejemplo que utilice CAxWindow2T::CreateControlLic
.
CAxWindow2T::CreateControlLicEx
Crea un control ActiveX con licencia, lo inicializa, lo hospeda en la ventana especificada y recupera un puntero (o punteros) de interfaz del 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);
Parámetros
bstrLicKey
Clave de licencia para el control; NULL si se crea un control sin licencia.
Comentarios
Consulte CAxWindow::CreateControlEx para obtener una descripción de los parámetros restantes y del valor devuelto.
Ejemplo
Consulte Hospedar controles ActiveX mediante ATL AXHost para obtener un ejemplo que utilice CAxWindow2T::CreateControlLicEx
.
CAxWindow2T::GetWndClassName
Recupera el nombre de la clase de ventana.
static LPCTSTR GetWndClassName();
Valor devuelto
Puntero a una cadena que contiene el nombre de la clase de ventana (AtlAxWinLic80
) que puede hospedar controles ActiveX con y sin licencia.
CAxWindow2T::operator =
Asigna HWND a un objeto CAxWindow2T
existente.
CAxWindow2T<TBase>& operator= (HWND hWnd);
Parámetros
hWnd
Manipulador de una ventana existente.
Consulte también
Información general sobre la clase
Preguntas más frecuentes sobre la contención de controles