Enumeração DWMWINDOWATTRIBUTE (dwmapi.h)

  • Artigo

Opções usadas pelas funções DwmGetWindowAttribute e DwmSetWindowAttribute .

Syntax

typedef enum DWMWINDOWATTRIBUTE {
  DWMWA_NCRENDERING_ENABLED,
  DWMWA_NCRENDERING_POLICY,
  DWMWA_TRANSITIONS_FORCEDISABLED,
  DWMWA_ALLOW_NCPAINT,
  DWMWA_CAPTION_BUTTON_BOUNDS,
  DWMWA_NONCLIENT_RTL_LAYOUT,
  DWMWA_FORCE_ICONIC_REPRESENTATION,
  DWMWA_FLIP3D_POLICY,
  DWMWA_EXTENDED_FRAME_BOUNDS,
  DWMWA_HAS_ICONIC_BITMAP,
  DWMWA_DISALLOW_PEEK,
  DWMWA_EXCLUDED_FROM_PEEK,
  DWMWA_CLOAK,
  DWMWA_CLOAKED,
  DWMWA_FREEZE_REPRESENTATION,
  DWMWA_PASSIVE_UPDATE_MODE,
  DWMWA_USE_HOSTBACKDROPBRUSH,
  DWMWA_USE_IMMERSIVE_DARK_MODE = 20,
  DWMWA_WINDOW_CORNER_PREFERENCE = 33,
  DWMWA_BORDER_COLOR,
  DWMWA_CAPTION_COLOR,
  DWMWA_TEXT_COLOR,
  DWMWA_VISIBLE_FRAME_BORDER_THICKNESS,
  DWMWA_SYSTEMBACKDROP_TYPE,
  DWMWA_LAST
} ;

Constantes

 
DWMWA_NCRENDERING_ENABLED
Use com DwmGetWindowAttribute. Descobre se a renderização não cliente está habilitada. O valor recuperado é do tipo BOOL. TRUE se a renderização não cliente estiver habilitada; caso contrário, FALSE.
DWMWA_NCRENDERING_POLICY
Use com DwmSetWindowAttribute. Define a política de renderização não cliente. O parâmetro pvAttribute aponta para um valor da enumeração DWMNCRENDERINGPOLICY .
DWMWA_TRANSITIONS_FORCEDISABLED
Use com DwmSetWindowAttribute. Habilita ou desabilita à força as transições de DWM. O parâmetro pvAttribute aponta para um valor do tipo BOOL. TRUE para desabilitar transições ou FALSE para habilitar transições.
DWMWA_ALLOW_NCPAINT
Use com DwmSetWindowAttribute. Permite que o conteúdo renderizado na área não cliente fique visível no quadro desenhado pelo DWM. O parâmetro pvAttribute aponta para um valor do tipo BOOL. TRUE para habilitar o conteúdo renderizado na área não cliente a ser visível no quadro; caso contrário, FALSE.
DWMWA_CAPTION_BUTTON_BOUNDS
Use com DwmGetWindowAttribute. Recupera os limites da área do botão legenda no espaço relativo à janela. O valor recuperado é do tipo RECT. Se a janela estiver minimizada ou não estiver visível para o usuário, o valor do RECT recuperado será indefinido. Você deve marcar se o RECT recuperado contém um limite com o qual você pode trabalhar e, se não o fizer, poderá concluir que a janela está minimizada ou não visível.
DWMWA_NONCLIENT_RTL_LAYOUT
Use com DwmSetWindowAttribute. Especifica se o conteúdo não cliente é espelhado da direita para a esquerda (RTL). O parâmetro pvAttribute aponta para um valor do tipo BOOL. TRUE se o conteúdo não cliente for espelhado da direita para a esquerda (RTL) ; caso contrário, FALSE.
DWMWA_FORCE_ICONIC_REPRESENTATION
Use com DwmSetWindowAttribute. Força a janela a exibir uma representação de miniatura ou espiar icônica (um bitmap estático), mesmo que uma representação dinâmica ou instantâneo da janela esteja disponível. Normalmente, esse valor é definido durante a criação de uma janela e não é alterado durante todo o tempo de vida da janela. Alguns cenários, no entanto, podem exigir que o valor seja alterado ao longo do tempo. O parâmetro pvAttribute aponta para um valor do tipo BOOL. TRUE para exigir uma representação de miniatura ou espiar icônica; caso contrário, FALSE.
DWMWA_FLIP3D_POLICY
Use com DwmSetWindowAttribute. Define como o Flip3D trata a janela. O parâmetro pvAttribute aponta para um valor da enumeração DWMFLIP3DWINDOWPOLICY .
DWMWA_EXTENDED_FRAME_BOUNDS
Use com DwmGetWindowAttribute. Recupera o retângulo de limites de quadro estendido no espaço de tela. O valor recuperado é do tipo RECT.
DWMWA_HAS_ICONIC_BITMAP
Use com DwmSetWindowAttribute. A janela fornecerá um bitmap para uso pelo DWM como uma representação de miniatura icônica ou espiar (um bitmap estático) para a janela. DWMWA_HAS_ICONIC_BITMAP pode ser especificado com DWMWA_FORCE_ICONIC_REPRESENTATION. DWMWA_HAS_ICONIC_BITMAP normalmente é definido durante a criação de uma janela e não é alterado durante todo o tempo de vida da janela. Alguns cenários, no entanto, podem exigir que o valor seja alterado ao longo do tempo. O parâmetro pvAttribute aponta para um valor do tipo BOOL. TRUE para informar ao DWM que a janela fornecerá uma representação de miniatura ou espiar icônica; caso contrário, FALSE.

Windows Vista e anteriores: Não há suporte para esse valor.
DWMWA_DISALLOW_PEEK
Use com DwmSetWindowAttribute. Não mostre a visualização de espiada para a janela. O modo de exibição peek mostra uma visualização completa da janela quando o mouse passa o mouse sobre a miniatura da janela na barra de tarefas. Se esse atributo estiver definido, focalizar o ponteiro do mouse sobre a miniatura da janela ignorará a espiada (caso outra janela no grupo tenha uma visualização prévia de visualização exibida). O parâmetro pvAttribute aponta para um valor do tipo BOOL. TRUE para evitar a funcionalidade de espiar ou FALSE para permitir isso.

Windows Vista e anteriores: Não há suporte para esse valor.
DWMWA_EXCLUDED_FROM_PEEK
Use com DwmSetWindowAttribute. Impede que uma janela desbote para uma folha de vidro quando a espiada é invocada. O parâmetro pvAttribute aponta para um valor do tipo BOOL. TRUE para evitar que a janela desbote durante a espiada de outra janela ou FALSE para comportamento normal.

Windows Vista e anteriores: Não há suporte para esse valor.
DWMWA_CLOAK
Use com DwmSetWindowAttribute. Oculta a janela de modo que ela não esteja visível para o usuário. A janela ainda é composta pelo DWM.

Usando com DirectComposition: Use o sinalizador DWMWA_CLOAK para ocultar a janela filho em camadas ao animar uma representação do conteúdo da janela por meio de um visual DirectComposition associado à janela filho em camadas. Para obter mais detalhes sobre esse caso de uso, consulte Como animar o bitmap de uma janela filho em camadas.

Windows 7 e anteriores: Não há suporte para esse valor.
DWMWA_CLOAKED
Use com DwmGetWindowAttribute. Se a janela estiver camuflada, fornecerá um dos seguintes valores explicando o motivo.

DWM_CLOAKED_APP (valor 0x00000001). A janela foi camuflada por seu aplicativo proprietário.

DWM_CLOAKED_SHELL (valor 0x00000002). A janela foi camuflada pelo Shell.

DWM_CLOAKED_INHERITED (valor 0x00000004). O valor do manto foi herdado de sua janela de proprietário.

Windows 7 e anteriores: Não há suporte para esse valor.
DWMWA_FREEZE_REPRESENTATION
Use com DwmSetWindowAttribute. Congele a imagem em miniatura da janela com seus visuais atuais. Não faça mais atualizações ao vivo na imagem em miniatura para corresponder ao conteúdo da janela.

Windows 7 e anteriores: Não há suporte para esse valor.
DWMWA_USE_HOSTBACKDROPBRUSH
Use com DwmSetWindowAttribute. Permite que uma janela não UWP use pincéis de cenário do host. Se esse sinalizador estiver definido, um aplicativo Win32 que chama AS APIs Windows::UI::Composition poderá criar efeitos de transparência usando o pincel de cenário do host (consulte Compositor.CreateHostBackdropBrush). O parâmetro pvAttribute aponta para um valor do tipo BOOL. TRUE para habilitar pincéis de cenário do host para a janela ou FALSE para desabilitá-lo.

Esse valor tem suporte a partir do Windows 11 Build 22000.
DWMWA_USE_IMMERSIVE_DARK_MODE
Use com DwmSetWindowAttribute. Permite que o quadro de janela dessa janela seja desenhado em cores do modo escuro quando a configuração do sistema do modo escuro estiver habilitada. Por motivos de compatibilidade, todas as janelas são padrão para o modo de luz, independentemente da configuração do sistema. O parâmetro pvAttribute aponta para um valor do tipo BOOL. TRUE para respeitar o modo escuro da janela, FALSE para sempre usar o modo claro.

Esse valor tem suporte a partir do Windows 11 Build 22000.
DWMWA_WINDOW_CORNER_PREFERENCE
Use com DwmSetWindowAttribute. Especifica a preferência de canto arredondado para uma janela. O parâmetro pvAttribute aponta para um valor do tipo DWM_WINDOW_CORNER_PREFERENCE.

Esse valor tem suporte a partir do Windows 11 Build 22000.
DWMWA_BORDER_COLOR
Use com DwmSetWindowAttribute. Especifica a cor da borda da janela. O parâmetro pvAttribute aponta para um valor do tipo COLORREF. O aplicativo é responsável por alterar a cor da borda de acordo com as alterações de estado, como uma alteração na ativação da janela.

Especificar DWMWA_COLOR_NONE (valor 0xFFFFFFFE) para a cor suprimirá o desenho da borda da janela. Isso possibilita ter uma janela arredondada sem borda.

Especificar DWMWA_COLOR_DEFAULT (valor 0xFFFFFFFF) para a cor redefinirá a janela de volta para usando o comportamento padrão do sistema para a cor da borda.

Esse valor tem suporte a partir do Windows 11 Build 22000.
DWMWA_CAPTION_COLOR
Use com DwmSetWindowAttribute. Especifica a cor do legenda. O parâmetro pvAttribute aponta para um valor do tipo COLORREF.

Especificar DWMWA_COLOR_DEFAULT (valor 0xFFFFFFFF) para a cor redefinirá a janela de volta para usando o comportamento padrão do sistema para a cor legenda.

Esse valor tem suporte a partir do Windows 11 Build 22000.
DWMWA_TEXT_COLOR
Use com DwmSetWindowAttribute. Especifica a cor do texto legenda. O parâmetro pvAttribute aponta para um valor do tipo COLORREF.

Especificar DWMWA_COLOR_DEFAULT (valor 0xFFFFFFFF) para a cor redefinirá a janela de volta para usando o comportamento padrão do sistema para a cor do texto legenda.

Esse valor tem suporte a partir do Windows 11 Build 22000.
DWMWA_VISIBLE_FRAME_BORDER_THICKNESS
Use com DwmGetWindowAttribute. Recupera a largura da borda externa que o DWM desenharia ao redor dessa janela. O valor pode variar dependendo do DPI da janela. O parâmetro pvAttribute aponta para um valor do tipo UINT.

Esse valor tem suporte a partir do Windows 11 Build 22000.
DWMWA_SYSTEMBACKDROP_TYPE
Use com DwmGetWindowAttribute ou DwmSetWindowAttribute. Recupera ou especifica o material de pano de fundo desenhado pelo sistema de uma janela, incluindo por trás da área não cliente. O parâmetro pvAttribute aponta para um valor do tipo DWM_SYSTEMBACKDROP_TYPE.

Esse valor tem suporte a partir do Windows 11 Build 22621.
DWMWA_LAST
O valor máximo reconhecido de DWMWINDOWATTRIBUTE , usado para fins de validação.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho dwmapi.h

Confira também