Enumeração DWMWINDOWATTRIBUTE (dwmapi.h)

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

Sintaxe

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 IMPORTANTE O valor de DWMWA_NCRENDERING_ENABLED é 1. cpp<br>typedef enum DWMWINDOWATTRIBUTE {<br> DWMWA_NCRENDERING_ENABLED = 1,<br> DWMWA_NCRENDERING_POLICY,<br> ...<br> Use com dwmGetWindowAttribute . Descobre se a renderização não cliente está habilitada. O valor recuperado é do tipo BOOL. VERDADEIRO 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 para ficar visível no quadro; caso contrário, FALSE .
DWMWA_CAPTION_BUTTON_BOUNDS Use com dwmGetWindowAttribute . Recupera os limites da área do botão de legenda no espaço relativo à janela. O valor recuperado é do tipo RECT. Se a janela for minimizada ou não estiver visível para o usuário, o valor do RECT recuperado será indefinido. Você deve verificar 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 está 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. VERDADEIRO se o conteúdo não cliente estiver 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 se uma representação dinâmica ou de instantâneo da janela estiver disponível. Esse valor 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. verdadeiro 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 ou espiar icônica (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. VERDADEIRO informar ao DWM que a janela fornecerá uma representação de miniatura ou espiada 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 de espiada 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 de visualização de espiar). O parâmetro pvAttribute aponta para um valor do tipo bool. TRUE para impedir a funcionalidade de espiar ou FALSE para permitir. 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 impedir que a janela desabilize 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 ocultada, fornecerá um dos seguintes valores explicando o motivo. DWM_CLOAKED_APP (0x00000001 de valor). A janela foi coberta pelo aplicativo proprietário. DWM_CLOAKED_SHELL (0x00000002 de valor). A janela foi coberta pelo Shell. DWM_CLOAKED_INHERITED (0x00000004 de valor). O valor do manto foi herdado da janela do 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 APIs do Windows::UI::Composition pode 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á-la. 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 de 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. verdadeiro para honrar 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 novamente 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 da legenda. O parâmetro pvAttribute aponta para um valor do tipo COLORREF. Especificar DWMWA_COLOR_DEFAULT (valor 0xFFFFFFFF) para a cor redefinirá a janela novamente usando o comportamento padrão do sistema para a cor da legenda. Esse valor tem suporte a partir do Windows 11 Build 22000.
DWMWA_TEXT_COLOR Use com dwmSetWindowAttribute. Especifica a cor do texto da legenda. O parâmetro pvAttribute aponta para um valor do tipo COLORREF. Especificar DWMWA_COLOR_DEFAULT (valor 0xFFFFFFFF) para a cor redefinirá a janela novamente usando o comportamento padrão do sistema para a cor do texto da 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 atrá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 DWMWINDOWATTRIBUTE, usado para fins de validação.

Requisitos

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

Consulte também

• função DwmGetWindowAttribute
• função DwmSetWindowAttribute
• Habilitar e controlar de composição do DWM