Функция SetBrushOrgEx (wingdi.h)
Функция 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 |