Typedefs ATL

A Active Template Library inclui os typedefs a seguir.

Typedef Descrição
_ATL_BASE_MODULE Definido como um typedef com base no _ATL_BASE_MODULE70.
_ATL_COM_MODULE Definido como um typedef com base no _ATL_COM_MODULE70.
_ATL_MODULE Definido como um typedef com base no _ATL_MODULE70.
_ATL_WIN_MODULE Definido como um typedef com base no _ATL_WIN_MODULE70
ATL_URL_PORT O tipo usado pelo CUrl para especificar um número de porta.
CComDispatchDriver Essa classe gerencia ponteiros de interface do COM.
CComGlobalsThreadModel Chama os métodos de modelo de thread apropriados, independentemente do modelo de threading que está sendo usado.
CComObjectThreadModel Chama os métodos de modelo de thread apropriados, independentemente do modelo de threading que está sendo usado.
CContainedWindow Essa classe é uma especialização de CContainedWindowT.
CPath Uma especialização de CPathT usando CString.
CPathA Uma especialização de CPathT usando CStringA.
CPathW Uma especialização de CPathT usando CStringW.
CSimpleValArray Representa uma matriz para armazenar tipos simples.
DefaultThreadTraits A classe de características de thread padrão.
LPCURL Um ponteiro para um objeto CUrl constante.
LPURL Um ponteiro para um objeto CUrl.

_ATL_BASE_MODULE

Definido como um typedef com base no _ATL_BASE_MODULE70.

typedef ATL::_ATL_BASE_MODULE70 _ATL_BASE_MODULE;

Comentários

Usado em todos os projetos da ATL. Baseado em _ATL_BASE_MODULE70.

Classes que fazem parte das Classes de módulo da ATL 7.0 derivam da estrutura _ATL_BASE_MODULE. Para obter mais informações sobre classes de módulo da ATL, consulte Classes de módulos do COM.

Requisitos

Cabeçalho: atlcore.h

_ATL_COM_MODULE

Definido como um typedef com base no _ATL_COM_MODULE70.

typedef ATL::_ATL_COM_MODULE70 _ATL_COM_MODULE;

Comentários

Usado por projetos da ATL que usam recursos do COM. Baseado no _ATL_COM_MODULE70.

Requisitos

Cabeçalho: atlbase.h

_ATL_MODULE

Definido como um typedef com base no _ATL_MODULE70.

typedef ATL::_ATL_MODULE70 _ATL_MODULE;

Requisitos

Cabeçalho:

Comentários

Baseado no _ATL_MODULE70.

_ATL_WIN_MODULE

Definido como um typedef com base no _ATL_WIN_MODULE70.

typedef ATL::_ATL_WIN_MODULE70 _ATL_WIN_MODULE;

Comentários

Usado por qualquer projeto da ATL que use recursos de janela. Baseado no _ATL_WIN_MODULE70.

Requisitos

Cabeçalho: atlbase.h

ATL_URL_PORT

O tipo usado pelo CUrl para especificar um número de porta.

typedef WORD ATL_URL_PORT;

Requisitos

Cabeçalho: atlutil.h

CComDispatchDriver

Essa classe gerencia ponteiros de interface do COM.

typedef CComQIPtr<IDispatch, &__uuidof(IDispatch)> CComDispatchDriver;

Requisitos

Cabeçalho: atlbase.h

CComGlobalsThreadModel

Chama os métodos de modelo de thread apropriados, independentemente do modelo de threading que está sendo usado.

#if defined(_ATL_SINGLE_THREADED)
typedef CComSingleThreadModel CComGlobalsThreadModel;
#elif defined(_ATL_APARTMENT_THREADED)
typedef CComMultiThreadModel CComGlobalsThreadModel;
#elif defined(_ATL_FREE_THREADED)
typedef CComMultiThreadModel CComGlobalsThreadModel;
#else
#pragma message ("No global threading model defined")
#endif

Comentários

Dependendo do modelo de threading usado pelo aplicativo, o nome typedef CComGlobalsThreadModel faz referência a CComSingleThreadModel ou CComMultiThreadModel. Essas classes fornecem nomes typedef adicionais para fazer referência a uma classe de seção crítica.

Observação

CComGlobalsThreadModel não faz referência à classe CComMultiThreadModelNoCS.

O uso da CComGlobalsThreadModel libera você de especificar uma classe de modelo de threading específica. Independentemente do modelo de threading que está sendo usado, os métodos apropriados serão chamados.

Além da CComGlobalsThreadModel, a ATL fornece o nome typedef CComObjectThreadModel. A classe referenciada para cada typedef depende do modelo de threading usado, conforme mostrado na tabela a seguir:

typedef Threading simples Threading de apartamento Threading livre
CComObjectThreadModel S S M
CComGlobalsThreadModel S M M

S= CComSingleThreadModel; M= CComMultiThreadModel

Use CComObjectThreadModel em uma única classe de objeto. Use CComGlobalsThreadModel em um objeto que esteja disponível globalmente para seu programa ou quando quiser proteger os recursos do módulo em vários threads.

Requisitos

Cabeçalho: atlbase.h

CComObjectThreadModel

Chama os métodos de modelo de thread apropriados, independentemente do modelo de threading que está sendo usado.

#if defined(_ATL_SINGLE_THREADED)
typedef CComSingleThreadModel CComObjectThreadModel;
#elif defined(_ATL_APARTMENT_THREADED)
typedef CComSingleThreadModel CComObjectThreadModel;
#elif defined(_ATL_FREE_THREADED)
typedef CComMultiThreadModel CComObjectThreadModel;
#else
#pragma message ("No global threading model defined")
#endif

Comentários

Dependendo do modelo de threading usado pelo aplicativo, o nome typedef CComObjectThreadModel faz referência a CComSingleThreadModel ou CComMultiThreadModel. Essas classes fornecem nomes typedef adicionais para fazer referência a uma classe de seção crítica.

Observação

CComObjectThreadModel não faz referência à classe CComMultiThreadModelNoCS.

O uso da CComObjectThreadModel libera você de especificar uma classe de modelo de threading específica. Independentemente do modelo de threading que está sendo usado, os métodos apropriados serão chamados.

Além da CComObjectThreadModel, a ATL fornece o nome typedef CComGlobalsThreadModel. A classe referenciada para cada typedef depende do modelo de threading usado, conforme mostrado na tabela a seguir:

typedef Threading simples Threading de apartamento Threading livre
CComObjectThreadModel S S M
CComGlobalsThreadModel S M M

S= CComSingleThreadModel; M= CComMultiThreadModel

Use CComObjectThreadModel em uma única classe de objeto. Use CComGlobalsThreadModel em um objeto que esteja disponível globalmente para seu programa ou quando quiser proteger os recursos do módulo em vários threads.

Requisitos

Cabeçalho: atlbase.h

CContainedWindow

Essa classe é uma especialização de CContainedWindowT.

typedef CContainedWindowT<CWindow> CContainedWindow;

Requisitos

Cabeçalho: atlwin.h

Comentários

CContainedWindow é uma especialização de CContainedWindowT. Se você quiser alterar a classe base ou características, use CContainedWindowT diretamente.

CPath

Uma especialização de CPathT usando CString.

typedef CPathT<CString> CPath;

Requisitos

Cabeçalho: atlpath.h

CPathA

Uma especialização de CPathT usando CStringA.

typedef CPathT<CStringA> CPathA;

Requisitos

Cabeçalho: atlpath.h

CPathW

Uma especialização de CPathT usando CStringW.

typedef ATL::CPathT<CStringW> CPathW;

Requisitos

Cabeçalho: atlpath.h

CSimpleValArray

Representa uma matriz para armazenar tipos simples.

#define CSimpleValArray CSimpleArray

Comentários

CSimpleValArray é fornecido para criar e gerenciar matrizes que contêm tipos de dados simples. É uma #define simples do CSimpleArray.

Requisitos

Cabeçalho: atlsimpcoll.h

LPCURL

Um ponteiro para um objeto CUrl constante.

typedef const CUrl* LPCURL;

Requisitos

Cabeçalho: atlutil.h

DefaultThreadTraits

A classe de características de thread padrão.

Sintaxe

#if defined(_MT)
   typedef CRTThreadTraits DefaultThreadTraits;
#else
   typedef Win32ThreadTraits DefaultThreadTraits;
#endif

Comentários

Se o projeto atual usa o CRT com vários threads, a DefaultThreadTraits será definida como CRTThreadTraits. Caso contrário, Win32ThreadTraits será usada.

Requisitos

Cabeçalho: atlbase.h

LPURL

Um ponteiro para um objeto CUrl.

typedef CUrl* LPURL;

Requisitos

Cabeçalho: atlutil.h

Confira também

Componentes de área de trabalho COM da ATL
Funções
Variáveis globais
Classes e structs
Macros