Classe CAxWindow2T

Essa classe fornece métodos de manipulação de uma janela que hospeda um controle ActiveX e é compatível com a hospedagem de controles ActiveX licenciados.

Importante

Essa classe e os respectivos membros não podem ser usados em aplicativos executados no Windows Runtime.

Sintaxe

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

Parâmetros

TBase
A classe da qual CAxWindowT é derivado.

Membros

Construtores públicos

Nome	Descrição
CAxWindow2T::CAxWindow2T	Constrói um objeto CAxWindow2T.

Métodos públicos

Nome	Descrição
CAxWindow2T::Create	Cria uma janela de host.
CAxWindow2T::CreateControlLic	Cria um controle ActiveX licenciado, inicializa-o e hospeda-o na janela especificada.
CAxWindow2T::CreateControlLicEx	Cria um controle ActiveX licenciado, inicializa-o, hospeda-o na janela especificada e recupera um ponteiro de interface (ou ponteiros) do controle.
CAxWindow2T::GetWndClassName	Método estático que recupera o nome da classe de janela.

Operadores públicos

Nome	Descrição
CAxWindow2T::operator =	Atribui um HWND a um objeto CAxWindow2T existente.

Comentários

CAxWindow2T fornece métodos para manipular uma janela que hospeda um controle ActiveX. CAxWindow2T também é compatível com hospedagem de controles ActiveX licenciados. A hospedagem é fornecida por "AtlAxWinLic80", que é encapsulado por CAxWindow2T.

A classe CAxWindow2 é implementada como uma especialização da classe CAxWindow2T. Essa especialização é declarada como:

typedef CAxWindow2T <CWindow> CAxWindow2;

Observação

Os membros CAxWindowT são documentados em CAxWindow.

Confira Hospedando controles ActiveX usando o AXHost da ATL para obter um exemplo que usa os membros dessa interface.

Hierarquia de herança

TBase

CAxWindowT

CAxWindow2T

Requisitos

Cabeçalho: atlwin.h

CAxWindow2T::CAxWindow2T

Constrói um objeto CAxWindow2T.

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

Parâmetros

hWnd
Um identificador de uma janela existente.

CAxWindow2T::Create

Cria uma janela 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);

Comentários

CAxWindow2T::Create chama CWindow::Create com o parâmetro lpstrWndClass de LPCTSTR definido como a classe de janela que fornece a hospedagem do controle (AtlAxWinLic80).

Confira CWindow::Create para obter uma descrição dos parâmetros e do valor retornado.

Observação Se 0 for usado como o valor do parâmetro MenuOrID, ele precisará ser especificado como 0U (o valor padrão) para evitar um erro do compilador.

Exemplo

Confira Hospedagem de Controles ActiveX usando o AXHost da ATL para obter um exemplo que usa CAxWindow2T::Create.

CAxWindow2T::CreateControlLic

Cria um controle ActiveX licenciado, inicializa-o e hospeda-o na janela 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
A chave de licença do controle; NULL se estiver criando um controle não licenciado.

Comentários

Confira CAxWindow::CreateControl para obter uma descrição dos parâmetros restantes e do valor retornado.

Exemplo

Confira Hospedagem de Controles ActiveX usando o AXHost da ATL para obter um exemplo que usa CAxWindow2T::CreateControlLic.

CAxWindow2T::CreateControlLicEx

Cria um controle ActiveX licenciado, inicializa-o, hospeda-o na janela especificada e recupera um ponteiro de interface (ou ponteiros) do controle.

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
A chave de licença do controle; NULL se estiver criando um controle não licenciado.

Comentários

Confira CAxWindow::CreateControlEx para obter uma descrição dos parâmetros restantes e do valor retornado.

Exemplo

Confira Hospedagem de Controles ActiveX usando o AXHost da ATL para obter um exemplo que usa CAxWindow2T::CreateControlLicEx.

CAxWindow2T::GetWndClassName

Recupera o nome da classe de janela.

static LPCTSTR GetWndClassName();

Valor de retorno

Um ponteiro para uma cadeia de caracteres que contém o nome da classe de janela (AtlAxWinLic80) que pode hospedar controles ActiveX licenciados e não licenciados.

CAxWindow2T::operator =

Atribui um HWND a um objeto CAxWindow2T existente.

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

Parâmetros

hWnd
Um identificador de uma janela existente.

Confira também

Visão geral da aula
Perguntas frequentes sobre contenção de controle