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

  • Статья

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

Синтаксис

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

Параметры

[in] hwnd

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

[in] dwAttribute

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

[in] pvAttribute

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

[in] cbAttribute

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

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

Тип: HRESULT

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

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

Замечания

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows Vista [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2008 [только классические приложения]
целевая платформа Виндоус
заголовка dwmapi.h
библиотеки Dwmapi.lib
DLL Dwmapi.dll; Uxtheme.dll

См. также