Функция SetBrushOrgEx

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

Синтаксис

BOOL SetBrushOrgEx(
  HDC hdc,       // дескриптор контекста устройства
  int nXOrg,     // x-координата нового начала координат
  int nYOrg,     // y-координата нового начала координат
  LPPOINT lppt   // точки предыдущего начала координат кисти
);

Параметры

hdc

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

nXOrg

[in] Устанавливает x-координату, в единицах измерения устройства (пикселях), нового начала координат кисти. Если это значение больше, чем ширина кисти, ее значение уменьшается, используя оператор модуля (nXOrg  mod ширины кисти).

nYOrg

[in] Устанавливает y-координату, в единицах измерения устройства (пикселях), нового начала координат кисти. Если это значение больше, чем ширина кисти, ее значение уменьшается, используя оператор модуля (nYOrg  mod высоты кисти).

lppt

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

Этот параметр может быть ПУСТО (NULL), если предыдущее начало координат кисти не затребовано.

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

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

Если функция завершается ошибкой, возвращаемое значение равняется нулю.

Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Замечания

Кисть - это точечный рисунок, который система использует, чтобы окрашивать внутренние части заполняемых форм.

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

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

Приложение должно вызывать функцию SetBrushOrgEx после установки режима растяжения точечного рисунка в ПОЛУТОНОВОЙ (HALFTONE ), который использовал функцию SetStretchBltMode. Это должно быть сделано для того, чтобы избежать нарушения границ кисти.

Windows NT/2000/XP: Система автоматически отслеживает начало координат всех управляемых окном контекстов устройства и корректирует их кисти по мере необходимости, чтобы поддержать выравнивание узоров на поверхности.

Windows 95/98/Me:  Автоматическое отслеживание начала координат кисти не поддерживается. Приложения должны использовать функции UnrealizeObject, SetBrushOrgEx и SelectObject, чтобы выровнять кисть перед её использованием.

Смотри также 

Обзор Кисти, Функции, используемые кистями,  GetBrushOrgEx, POINT, SelectObject, SetStretchBltMode, UnrealizeObject

Размещение и совместимость SetBrushOrgEx

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 3.1 и выше

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

Gdi32.lib

Заголовочный файл

 

- объявлено в

Wingdi.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz