Функция GetBrushOrgEx


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

Синтаксис

BOOL GetBrushOrgEx(
  HDC hdc,       // дескриптор контекста устройства (DC)
  LPPOINT lppt   // начало координат
);

Параметры

hdc
[in] Дескриптор контекста устройства.
lppt
[out] Указатель на структуру POINT, которая получает начало координат кисти, в координатах устройства.

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

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

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

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

Замечания

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

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

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

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

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

Смотри также 

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

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

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