Classe CAxWindow2T

Observação

A Active Template Library (ATL) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Esta classe fornece métodos para manipular uma janela que hospeda um controlo ActiveX e também suporta o alojamento de controlos ActiveX licenciados.

Importante

Esta classe e os seus membros não podem ser usados em aplicações que sejam executadas no Windows Runtime.

Sintaxe

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

Parâmetros

TBase
A classe da qual CAxWindowT deriva.

Membros

Construtores Públicos

Nome	Description
CAxWindow2T::CAxWindow2T	Constrói um CAxWindow2T objeto.

Métodos Públicos

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

Operadores Públicos

Nome	Description
CAxWindow2T::operator =	Atribui um HWND a um objeto existente CAxWindow2T .

Observações

CAxWindow2T fornece métodos para manipular uma janela que hospeda um controlo ActiveX. CAxWindow2T também tem suporte para alojar controlos ActiveX licenciados. O alojamento é fornecido por " AtlAxWinLic80", que é encapsulado por CAxWindow2T.

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

typedef CAxWindow2T <CWindow> CAxWindow2;

Observação

CAxWindowT os membros estão documentados sob o CAxWindow.

Consulte Hospedagem de Controlos ActiveX Usando ATL AXHost para um exemplo que utiliza os membros desta classe.

Hierarquia de herança

TBase

CAxWindowT

CAxWindow2T

Requerimentos

Cabeçalho: atlwin.h

CAxWindow2T::CAxWindow2T

Constrói um CAxWindow2T objeto.

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

Parâmetros

hWnd
Uma maçaneta de uma janela existente.

CAxWindow2T::Create

Cria uma janela de anfitrião.

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

Observações

CAxWindow2T::Create chama CWindow::Create com o parâmetro LPCTSTR lpstrWndClass definido para a classe janela que fornece alojamento de controlo (AtlAxWinLic80).

Veja CWindow::Create para uma descrição dos parâmetros e do valor de retorno.

Nota Se 0 for usado como valor para o parâmetro MenuOrID , deve ser especificado como 0U (o valor padrão) para evitar um erro do compilador.

Example

Consulte Hospedagem de Controlos ActiveX usando ATL AXHost para um exemplo que utiliza CAxWindow2T::Create.

CAxWindow2T::CreateControlLic

Cria um controlo ActiveX licenciado, inicializa-o e aloja-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 para o controlo; NULL se estiver a criar um controlo não licenciado.

Observações

Consulte CAxWindow::CreateControl para uma descrição dos parâmetros restantes e do valor de retorno.

Example

Consulte Hospedagem de Controlos ActiveX usando ATL AXHost para um exemplo que utiliza CAxWindow2T::CreateControlLic.

CAxWindow2T::CreateControlLicEx

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

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 para o controlo; NULL se estiver a criar um controlo não licenciado.

Observações

Consulte CAxWindow::CreateControlEx para uma descrição dos parâmetros restantes e valor de retorno.

Example

Consulte Hospedagem de Controlos ActiveX usando ATL AXHost para um exemplo que utiliza CAxWindow2T::CreateControlLicEx.

CAxWindow2T::GetWndClassName

Recupera o nome da classe janela.

static LPCTSTR GetWndClassName();

Valor de retorno

Um apontador para uma string contendo o nome da classe janela (AtlAxWinLic80) que pode hospedar controlos ActiveX licenciados e não licenciados.

CAxWindow2T::operator =

Atribui um HWND a um objeto existente CAxWindow2T .

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

Parâmetros

hWnd
Uma maçaneta de uma janela existente.

Consulte também

Visão geral da classe
FAQ sobre Contenção de Controlo