Macros de classe de janela

Essas macros definem utilitários de classe de janela.

Nome	Descrição
DECLARE_WND_CLASS	Permite que você especifique o nome de uma nova classe de janela.
DECLARE_WND_CLASS2	(Visual Studio 2017) Permite que você especifique o nome de uma nova classe de janela e a classe de conexão cujo procedimento de janela a nova classe usará.
DECLARE_WND_SUPERCLASS	Permite que você especifique o nome de uma classe de janela existente na qual uma nova classe de janela será baseada.
DECLARE_WND_CLASS_EX	Permite que você especifique os parâmetros de uma classe.

Requisitos

Cabeçalho: atlwin.h

DECLARE_WND_CLASS

Permite que você especifique o nome de uma nova classe de janela. Coloque essa macro na classe de controle de um controle ATL ActiveX.

DECLARE_WND_CLASS( WndClassName )

Parâmetros

WndClassName
[in] O nome da nova classe de janela. Se NULL, a ATL gerará um nome de classe de janela.

Comentários

Se você estiver usando a opção do compilador /permissive, DECLARE_WND_CLASS causará um erro do compilador; use DECLARE_WND_CLASS2 em vez disso.

DECLARE_WND_CLASS permite especificar o nome de uma nova classe de janela cujas informações serão gerenciadas pelo CWndClassInfo. DECLARE_WND_CLASS define a nova classe de janela implementando a seguinte função estática:

static CWndClassInfo& GetWndClassInfo();

DECLARE_WND_CLASS especifica os seguintes estilos para a nova janela:

• CS_HREDRAW

• CS_VREDRAW

• CS_DBLCLKS

DECLARE_WND_CLASS também especifica a cor da tela de fundo da janela padrão. Use a macro DECLARE_WND_CLASS_EX para fornecer seus próprios estilos e cor da tela de fundo.

O CWindowImpl usa a macro DECLARE_WND_CLASS para criar uma janela com base em uma nova classe de janela. Para substituir esse comportamento, use a macro DECLARE_WND_SUPERCLASS ou forneça sua própria implementação da função GetWndClassInfo.

Para obter mais informações sobre como usar janelas na ATL, confira o artigo Classes de janelas de ATL.

DECLARE_WND_CLASS2

(Visual Studio 2017) Semelhante a DECLARE_WND_CLASS, mas com um parâmetro extra que evita um erro de nome dependente ao compilar com a opção /permissive.

DECLARE_WND_CLASS2( WndClassName, EnclosingClass )

Parâmetros

WndClassName
[in] O nome da nova classe de janela. Se NULL, a ATL gerará um nome de classe de janela.

EnclosingClass
[in] O nome da classe de janela que inclui a nova classe de janela. Não pode ser NULL.

Comentários

Se você estiver usando a opção /permissive, DECLARE_WND_CLASS causará um erro de compilação porque ele contém um nome dependente. DECLARE_WND_CLASS2 exige que você nomeie explicitamente a classe na qual essa macro é usada e não causa o erro no sinalizador /permissive. Caso contrário, essa macro é idêntica a DECLARE_WND_CLASS.

DECLARE_WND_SUPERCLASS

Permite que você especifique os parâmetros de uma classe. Coloque essa macro na classe de controle de um controle ATL ActiveX.

DECLARE_WND_SUPERCLASS( WndClassName, OrigWndClassName )

Parâmetros

WndClassName
[in] O nome da classe de janela que substituirá OrigWndClassName. Se NULL, a ATL gerará um nome de classe de janela.

OrigWndClassName
[in] O nome de uma classe de janela existente.

Comentários

Essa macro permite que você especifique o nome de uma classe de janela que substituirá uma classe de janela existente. CWndClassInfo gerencia as informações da superclasse.

DECLARE_WND_SUPERCLASS implementa a seguinte função estática:

static CWndClassInfo& GetWndClassInfo();

Por padrão, O CWindowImpl usa a macro DECLARE_WND_CLASS para criar uma janela com base em uma nova classe de janela. Ao especificar a macro DECLARE_WND_SUPERCLASS em uma classe derivada de CWindowImpl, a classe de janela será baseada em uma classe existente, mas usará o procedimento de janela. Essa técnica é chamada de superclasse.

Além de usar as macros DECLARE_WND_CLASS e DECLARE_WND_SUPERCLASS, você pode substituir a função GetWndClassInfo com uma implementação própria.

Para obter mais informações sobre como usar janelas na ATL, confira o artigo Classes de janelas de ATL.

DECLARE_WND_CLASS_EX

Permite que você especifique o nome de uma classe de janela existente na qual uma nova classe de janela será baseada. Coloque essa macro na classe de controle de um controle ATL ActiveX.

DECLARE_WND_CLASS_EX( WndClassName, style, bkgnd )

Parâmetros

WndClassName
[in] O nome da nova classe de janela. Se NULL, a ATL gerará um nome de classe de janela.

style
[in] O estilo da janela.

bkgnd
[in] A cor da tela de fundo da janela.

Comentários

Essa macro permite especificar o nome de uma nova classe de janela cujas informações serão gerenciadas por CWndClassInfo. DECLARE_WND_CLASS_EX define a nova classe de janela implementando a seguinte função estática:

static CWndClassInfo& GetWndClassInfo();

Se você quiser usar os estilos padrão e a cor da tela de fundo, use a macro DECLARE_WND_CLASS. Para obter mais informações sobre como usar janelas na ATL, confira o artigo Classes de janelas de ATL.

Confira também

Macros