Classe CWinTraits

  • Artigo

Essa classe fornece um método para padronizar os estilos usados ao criar um objeto de janela.

Importante

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

Sintaxe

template <DWORD t_dwStyle = 0, DWORD t_dwExStyle = 0>  class CWinTraits

Parâmetros

t_dwStyle
Padrão de estilos de janela padrão.

t_dwExStyle
Estilos estendidos padrão de janela.

Membros

Métodos públicos

Nome Descrição
CWinTraits::GetWndExStyle (Estático) Recupera os estilos estendidos para o objeto CWinTraits.
CWinTraits::GetWndStyle (Estático) Recupera os estilos padrão para o objeto CWinTraits.

Comentários

Essa classe de características de janela fornece um método simples para padronizar os estilos utilizados na criação de um objeto de janela de ATL. Use uma especialização dessa classe como um parâmetro de modelo para CWindowImpl ou outra classe de janela de ATL para especificar os estilos padrão e estendidos padrão utilizados para instâncias dessa classe de janela.

Use esse modelo quando quiser fornecer estilos de janela padrão que serão utilizados somente quando nenhum outro estilo for especificado na chamada para CWindowImpl::Create.

ATL fornece três especializações predefinidas desse modelo para as combinações de estilos de janela normalmente utilizadas:

  • CControlWinTraits

    Projetado para uma janela de controle padrão. Os seguintes estilos padrão são utilizados: WS_CHILD, WS_VISIBLE, WS_CLIPCHILDREN e WS_CLIPSIBLINGS. Não há estilos estendidos.

  • CFrameWinTraits

    Projetado para uma janela do quadro padrão. Os estilos padrão utilizados incluem: WS_OVERLAPPEDWINDOW, WS_CLIPCHILDREN e WS_CLIPSIBLINGS. Os estilos estendidos utilizados incluem: WS_EX_APPWINDOW e WS_EX_WINDOWEDGE.

  • CMDIChildWinTraits

    Projetado para uma janela filho MDI padrão. Os estilos padrão utilizados incluem: WS_OVERLAPPEDWINDOW, WS_CHILD, WS_VISIBLE, WS_CLIPCHILDREN e WS_CLIPSIBLINGS. Os estilos estendidos utilizados incluem: WS_EX_MDICHILD.

Se você quiser garantir que determinados estilos sejam definidos para todas as instâncias da classe de janela enquanto permite que outros estilos sejam definidos por instância, useCWinTraitsOR.

Requisitos

Cabeçalho: atlwin.h

CWinTraits::GetWndStyle

Chame essa função para recuperar os estilos padrão do objeto CWinTraits.

static DWORD GetWndStyle(DWORD dwStyle);

Parâmetros

dwStyle
Estilos padrão utilizados para a criação de uma janela. Se dwStyle for 0, os valores de estilo de modelo (t_dwStyle) serão retornados. Se dwStyle for diferente de zero, dwStyle será retornado.

Valor de Devolução

Os estilos de janela padrão do objeto.

CWinTraits::GetWndExStyle

Chame essa função para recuperar os estilos estendidos do objeto CWinTraits.

static DWORD GetWndExStyle(DWORD dwExStyle);

Parâmetros

dwExStyle
Estilos estendidos utilizados na criação de uma janela. Se dwExStyle for 0, os valores de estilo do modelo (t_dwExStyle) serão retornados. Se dwExStyle for diferente de zero, dwExStyle será retornado.

Valor de Devolução

Os estilos de janela estendidos do objeto.

Confira também

Visão geral da classe
Noções básicas sobre as características da janela