Função DwmSetWindowAttribute (dwmapi.h)

  • Artigo

Define o valor dos atributos de renderização não cliente do DWM (Gerenciador de Janelas da Área de Trabalho) para uma janela. Para obter diretrizes de programação e exemplos de código, consulte Controlandode renderização de região não cliente.

Sintaxe

HRESULT DwmSetWindowAttribute(
  [in] HWND    hwnd,
  [in] DWORD   dwAttribute,
  [in] LPCVOID pvAttribute,
  [in] DWORD   cbAttribute
);

Parâmetros

[in] hwnd

O identificador para a janela para a qual o valor do atributo deve ser definido.

[in] dwAttribute

Um sinalizador que descreve qual valor deve ser definido, especificado como um valor da enumeração DWMWINDOWATTRIBUTE . Esse parâmetro especifica qual atributo definir e o parâmetro pvAttribute aponta para um objeto que contém o valor do atributo.

[in] pvAttribute

Um ponteiro para um objeto que contém o valor do atributo a ser definido. O tipo do conjunto de valores depende do valor do parâmetro dwAttribute. O tópico de enumeração DWMWINDOWATTRIBUTE indica, na linha de cada sinalizador, para qual tipo de valor você deve passar um ponteiro no parâmetro pvAttribute .

[in] cbAttribute

O tamanho, em bytes, do valor do atributo que está sendo definido por meio do parâmetro pvAttribute . O tipo do conjunto de valores e, portanto, seu tamanho em bytes, depende do valor do parâmetro dwAttribute .

Valor de retorno

Tipo: HRESULT

Se a função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um de código de erro HRESULT.

Se a Composição da Área de Trabalho tiver sido desabilitada (Windows 7 e anterior), essa função retornará DWM_E_COMPOSITIONDISABLED.

Observações

Não é válido chamar essa função com o parâmetro dwAttribute definido como DWMWA_NCRENDERING_ENABLED. Para habilitar ou desabilitar a renderização não cliente, você deve usar o atributo DWMWA_NCRENDERING_POLICY e definir o valor desejado. Para obter mais informações e um exemplo de código, consulte Controlandode renderização de região não cliente.

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]
da Plataforma de Destino Windows
cabeçalho dwmapi.h
biblioteca Dwmapi.lib
de DLL Dwmapi.dll; Uxtheme.dll

Consulte também