Функция GetBrushOrgEx (wingdi.h)

Статья
03/08/2023

Функция GetBrushOrgEx извлекает источник текущей кисти для указанного контекста устройства. Эта функция заменяет функцию GetBrushOrg .

Синтаксис

BOOL GetBrushOrgEx(
  [in]  HDC     hdc,
  [out] LPPOINT lppt
);

Параметры

[in] hdc

Дескриптор контекста устройства.

[out] lppt

Указатель на структуру POINT , которая получает источник кисти в координатах устройства.

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

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

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

Источник кисти — это набор координат со значениями от 0 до 7, указывающих расположение одного пикселя на растровом рисунке. Координаты источника кисти по умолчанию — (0,0). Для горизонтальных координат значение 0 соответствует крайнему левому столбцу пикселей; Значение 7 соответствует крайнему правому столбцу. Для вертикальных координат значение 0 соответствует верхней строке пикселей; Значение 7 соответствует самой нижней строке. Когда система размещает кисть в начале любой операции рисования, она сопоставляет ее источник с расположением в клиентской области окна, указанной источником кисти. Например, если для источника задано значение (2,3), система сопоставляет источник кисти (0,0) с расположением (2,3) в клиентской области окна.

Если приложение использует кисть для заполнения фона родительского и дочернего окна соответствующими цветами, может потребоваться задать источник кисти после рисования родительского окна, но перед рисованием дочернего окна.

Система автоматически отслеживает происхождение всех контекстов устройств, управляемых окном, и корректирует их кисти для поддержания выравнивания шаблонов на поверхности.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll