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

Статья
03/08/2023

Функция SetBrushOrgEx задает источник кисти, который GDI назначает следующей кисти, выбранной приложением, в указанном контексте устройства.

Синтаксис

BOOL SetBrushOrgEx(
  [in]  HDC     hdc,
  [in]  int     x,
  [in]  int     y,
  [out] LPPOINT lppt
);

Параметры

[in] hdc

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

[in] x

Координата X (в единицах устройства) нового источника кисти. Если это значение больше ширины кисти, его значение уменьшается с помощью оператора modulus (nXOrgmod width).

[in] y

Координата Y в единицах устройства нового источника кисти. Если это значение больше высоты кисти, его значение уменьшается с помощью оператора модуля (nYOrgmod height).

[out] lppt

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

Этот параметр может иметь значение NULL , если предыдущий источник кисти не требуется.

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

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

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

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

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

Приложение должно вызывать SetBrushOrgEx после установки режима растяжения растрового рисунка HALFTONE с помощью SetStretchBltMode. Это необходимо сделать, чтобы избежать несоответствия кистей.

Требования


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