Тарас Сорока - Русский справочник по Win32 API

Приложение может извлечь данные для области, вызвав функцию GetRegionData.

Windows 95:Области более не ограничены кучей в 64 КБайт.

Windows 95:Мировые преобразования, который включают в себя сдвиг или вращение, не поддерживаются. Вызов ExtCreateRegionзавершится неудачей, если матрица преобразования задает собой что-либо отличное от масштабирования или сдвига области.

См. также

GetRegionData, RGNDATA, XFORM.

Функция FillRgnзаполняет область, используя определенную кисть.

BOOL FillRgn(

HDC hdc , // дескриптор контекста устройства

HRGN hrgn , // дескриптор заполняемой области

HBRUSH hbr // дескриптор кисти, используемой для заполнения области

);

Параметры

hdc - идентифицирует контекст устройства.

hrgn - идентифицирует заполняемую область. Предполагается, что координаты области задаются в логических единицах.

hbr - идентифицирует кисть, используемую для заполнения области.

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

В случае успеха возвращается ненулевое значение.

В случае неудачи возвращается нуль.

См. также

CreateBrushIndirect, CreateDIBPatternBrush, CreateHatchBrush, CreatePatternBrush, CreateSolidBrush, PaintRgn.

Функция FrameRgnрисует рамку вокруг указанной области, используя указанную кисть.

BOOL FrameRgn(

HDC hdc , // дескриптор контекста устройства

HRGN hrgn , // дескриптор области, вокруг которой рисуется рамка

HBRUSH hbr , // дескриптор кисти, используемой для рисования рамки

int nWidth , // ширина рамки

int nHeight // высота рамки

);

Параметры

hdc - идентифицирует контекст устройства.

hrgn - идентифицирует область, заключаемую в рамку. Предполагается, что координаты области задаются в логических единицах.

hbr - идентифицирует кисть, используемую для рисования рамки.

nWidth - определяет ширину вертикальных штрихов кисти, в логических единицах.

nHeight - определяет высоту горизонтальных штрихов кисти, в логических единицах.

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

В случае успеха возвращается ненулевое значение.

В случае неудачи возвращается нуль.

См. также

FillRgn, PaintRgn.

Функция GetPolyFillModeизвлекает текущий режим заполнения прямоугольника.

int GetPolyFillMode(

HDC hdc // дескриптор контекста устройства

);

Параметры

hdc - идентифицирует контекст устройства.

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

В случае успеха возвращается режим заполнения прямоугольников, который может быть одним из следующих значений:

В случае неудачи возвращается нуль.

См. также

SetPolyFillMode.

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

DWORD GetRegionData(

HRGN hRgn , // дескриптор области

DWORD dwCount , // размер буфера, содержащего данные области

LPRGNDATA lpRgnData // адрес буфера

);

Параметры

hRgn - идентифицирует область.

dwCount - определяет размер буфера, на который указывает значение параметра lpRgnData , в байтах.

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

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

Если вызов функции завершается успехом и значение dwCount определяет соответствующее количество байт, возвращается 1. Если значение dwCount слишком мало или значение lpRgnData равно NULL, возвращается требуемое количество байт.

В случае неудачи возвращается нуль.

Комментарии

Функция GetRegionDataиспользуется в паре с функцией ExtCreateRegion.

См. также

ExtCreateRegion, RGNDATA.

Функция GetRgnBoxизвлекает ограничивающий прямоугольник указанной области.

int GetRgnBox(

HRGN hrgn , // дескриптор области

LPRECT lprc // адрес структуры, которая получает

// ограничивающий прямоугольник

);

Параметры

hrgn - идентифицирует область.

lprc - указывает на структуру типа RECT, которая получает ограничивающий прямоугольник.

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

Возвращаемое значение показывает сложность результирующей области и может принимать одно из следующих значений:

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

См. также

RECT.

Функция OffsetRgnперемещает область на заданные смещения.

int OffsetRgn(

HRGN hrgn , // дескриптор области

int nXOffset , // смещение вдоль оси x

int nYOffset // смещение вдоль оси y

);

Параметры

hrgn - идентифицирует перемещаемую область.

nXOffset - задает количество логических единиц, на которое область смещается влево или вправо.

nYOffset - задает количество логических единиц, на которое область смещается вверх или вниз.

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

Возвращаемое значение определяет сложность новой области. Может принимать одно из следующих значений:

Функция SetPolyFillModeустанавливает режим заполнения многоугольников для соответствующих функций.

int SetPolyFillMode(