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

CreateRectRgnIndirect, CreateRoundRectRgn, DeleteObject, SelectObject .

CreateRectRgnIndirect

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

HRGN CreateRectRgnIndirect (

CONST RECT * lprc // указатель на прямоугольник

);

Параметры

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

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

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

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

Комментарии

В область не войдут правая и нижняя стороны прямоугольника.

См. также

CreateRectRgn, CreateRoundRectRgn, DeleteObject, RECT, SelectObject .

CreateRoundRectRgn

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

HRGN CreateRoundRectRgn (

int nLeftRect , // x -координата верхнего левого угла области

int nTopRect , // y -координата верхнего левого угла области

int nRightRect , // x -координата нижнего правого угла области

int nBottomRect , // y -координата нижнего правого угла области

int nWidthEllipse , // ширина эллипса для закругленных углов

int nHeightEllipse // высота эллипса для закругленных углов

);

Параметры

nLeftRect - определяет x -координату верхнего левого угла области.

nTopRect - определяет y - координату верхнего левого угла области.

nRightRect - определяет x -координату нижнего правого угла области.

nBottomRect - определяет y -координату нижнего правого угла области.

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

nHeightEllipse - определяет высоту эллипса, используемого для создания закругленных углов.

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

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

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

См. также

CreateRectRgn, CreateRectRgnIndirect, DeleteObject, SelectObject .

EqualRgn

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

BOOL EqualRgn (

HRGN hSrcRgn 1 , // дескриптор первой области

HRGN hSrcRgn 2 // дескриптор второй области

);

Параметры

hSrcRgn 1 - идентифицирует первую область.

hSrcRgn 2 - идентифицирует вторую область.

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

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

Если две области не равны, возвращается нуль. Возврат ERROR означает, что, по крайней мере, один из дескрипторов областей был недействительным.

См. также

CreateRectRgn, CreateRectRgnIndirect .

ExtCreateRegion

Функция ExtCreateRegion создает область из указанной области и данных трансформации.

HRGN ExtCreateRegion (

CONST XFORM * lpXform , // указатель на данные трансформации

DWORD nCount , // размер структуры, содержащей данные области

CONST RGNDATA * lpRgnData // указатель на данные области

);

Параметры

lpXform - указатель на структуру типа XFORM , которая определяет трансформацию, выполняемую над областью. Если значение этого параметра равно NULL, используется единичная трансформация.

nCount - определяет число байт, адресуемых значением параметра lpRgnData .

lpRgnData - указывает на структуру типа RGNDATA , которая содержит данные области.

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

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

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

Комментарии

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

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

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

См. также

GetRegionData, RGNDATA, XFORM.

FillRgn

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

BOOL FillRgn (

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

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

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

);

Параметры

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

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