);
Параметры
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 - идентифицирует заполняемую область. Предполагается, что координаты области задаются в логических единицах.
hbr - идентифицирует кисть, используемую для заполнения области.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль.
См. также
CreateBrushIndirect, CreateDIBPatternBrush, CreateHatchBrush, CreatePatternBrush, CreateSolidBrush, PaintRgn .
FrameRgn
Функция FrameRgn рисует рамку вокруг указанной области, используя указанную кисть.
BOOL FrameRgn (
HDC hdc , // дескриптор контекста устройства
HRGN hrgn , // дескриптор области, вокруг которой рисуется рамка
HBRUSH hbr , // дескриптор кисти, используемой для рисования рамки
int nWidth , // ширина рамки
int nHeight // высота рамки
);
Параметры
hdc - идентифицирует контекст устройства.
hrgn - идентифицирует область, заключаемую в рамку. Предполагается, что координаты области задаются в логических единицах.
hbr - идентифицирует кисть, используемую для рисования рамки.
nWidth - определяет ширину вертикальных штрихов кисти, в логических единицах.
nHeight - определяет высоту горизонтальных штрихов кисти, в логических единицах.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль.
См. также
FillRgn, PaintRgn .
GetPolyFillMode
Функция GetPolyFillMode извлекает текущий режим заполнения прямоугольника.
int GetPolyFillMode (
HDC hdc // дескриптор контекста устройства
);
Параметры
hdc - идентифицирует контекст устройства.
Возвращаемые значения
В случае успеха возвращается режим заполнения прямоугольников, который может быть одним из следующих значений:
Значение |
Пояснение |
ALTERNATE |
Попеременный режим. Закрашиваются только те фрагменты внутренней области многоугольника, которые получаются путем соединения линий с нечетными номерами (1, 3, 5 и т. д.). Другие фрагменты внутренней области не закрашиваются. |
WINDING |
Сквозной. Windows закрашивает все внутренние области. |
В случае неудачи возвращается нуль.
См. также
SetPolyFillMode .
GetRegionData
Функция 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
Функция GetRgnBox извлекает ограничивающий прямоугольник указанной области.
int GetRgnBox (
HRGN hrgn , // дескриптор области
LPRECT lprc // адрес структуры, которая получает
// ограничивающий прямоугольник
);
Параметры
hrgn - идентифицирует область.