Функция DrawThemeParentBackgroundEx (uxtheme.h)

Статья
08/26/2023

Используется частично прозрачными или альфа-смешанными дочерними элементами управления для рисования части родительского элемента, перед которой они отображаются. Отправляет WM_ERASEBKGND сообщение, за которым следует WM_PRINTCLIENT.

Синтаксис

HRESULT DrawThemeParentBackgroundEx(
  [in] HWND       hwnd,
  [in] HDC        hdc,
  [in] DWORD      dwFlags,
  [in] const RECT *prc
);

Параметры

[in] hwnd

Тип: HWND

Дескриптор дочернего элемента управления.

[in] hdc

Тип: HDC

HDC дочернего элемента управления.

[in] dwFlags

Тип: DWORD

Ноль или несколько из следующих значений. Если это значение равно нулю, эта функция возвращает S_OK только в том случае, если родительский объект обработан WM_PRINTCLIENT.

Значение	Значение
DTPB_WINDOWDC	Если этот параметр задан, hdc считается оконным контроллером домена, а не клиентским контроллером домена.
DTPB_USECTLCOLORSTATIC	Если этот параметр задан, эта функция отправляет WM_CTLCOLORSTATIC сообщение родительскому элементу и использует кисть, если оно указано. В противном случае используется COLOR_BTNFACE.
DTPB_USEERASEBKGND	Если этот параметр задан, эта функция возвращает S_OK, не отправляя сообщение WM_CTLCOLORSTATIC , если родительский элемент фактически закрашен на WM_ERASEBKGND.

[in] prc

Тип: const RECT*

Необязательный элемент. Отрисовываемая область в дочерних координатах. Если этот параметр имеет значение NULL, отрисовываемая область включает всю область, занятую дочерним элементом управления.

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

Тип: HRESULT

S_OK в случае успешного выполнения; в противном случае S_FALSE.

Требования

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