Функция DwmSetWindowAttribute (dwmapi.h)

  • Статья

Задает значение неклиентских атрибутов отрисовки диспетчера окон рабочего стола (DWM) для окна. Руководство по программированию и примеры кода см. в разделе Управление отображением неклиентского региона.

Синтаксис

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

Параметры

hwnd

Дескриптор окна, для которого необходимо задать значение атрибута.

dwAttribute

Флаг, описывающий устанавливаемое значение, указанное в качестве значения перечисления DWMWINDOWATTRIBUTE . Этот параметр указывает, какой атрибут следует задать, а параметр pvAttribute указывает на объект, содержащий значение атрибута.

[in] pvAttribute

Указатель на объект, содержащий устанавливаемое значение атрибута. Тип набора значений зависит от значения параметра dwAttribute . Раздел перечисления DWMWINDOWATTRIBUTE указывает в строке для каждого флага, на какой тип значения следует передать указатель в параметре pvAttribute .

cbAttribute

Размер (в байтах) значения атрибута, задающегося с помощью параметра pvAttribute . Тип набора значений и, следовательно, его размер в байтах зависят от значения параметра dwAttribute .

Возвращаемое значение

Тип: HRESULT

Если функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибкиHRESULT.

Если композиция рабочего стола отключена (Windows 7 и более ранние версии), эта функция возвращает DWM_E_COMPOSITIONDISABLED.

Комментарии

Недопустимо вызывать эту функцию с параметром dwAttribute, равнымDWMWA_NCRENDERING_ENABLED. Чтобы включить или отключить отрисовку, не являющейся клиентом, следует использовать атрибут DWMWA_NCRENDERING_POLICY и задать нужное значение. Дополнительные сведения и пример кода см. в разделе Управление отображением неклиентского региона.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header dwmapi.h
Библиотека Dwmapi.lib
DLL Dwmapi.dll; Uxtheme.dll

См. также раздел