Функция 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 |
Нет |
|
Замечания по платформе |
Не имеется |