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

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

Синтаксис

BOOL GetBrushOrgEx(
  [in]  HDC     hdc,
  [out] LPPOINT lppt
);

Параметры

[in] hdc

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

[out] lppt

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

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

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

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

Комментарии

Кисть — это растровое изображение, которое система использует для рисования внутренних элементов заполненных фигур.

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

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

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

Требования

См. также раздел

Функции кисти

Обзор кистей

ТОЧКИ

SelectObject

SetBrushOrgEx

UnrealizeObject