Функция CreateRectRgn (wingdi.h)
Функция CreateRectRgn создает прямоугольную область.
Синтаксис
HRGN CreateRectRgn(
[in] int x1,
[in] int y1,
[in] int x2,
[in] int y2
);
Параметры
[in] x1
Задает координату X левого верхнего угла области в логических единицах.
[in] y1
Задает координату Y левого верхнего угла области в логических единицах.
[in] x2
Задает координату X правого нижнего угла области в логических единицах.
[in] y2
Задает координату Y нижнего правого угла области в логических единицах.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет дескриптором области.
Если функция завершается сбоем, возвращается значение NULL.
Комментарии
Если объект HRGN больше не нужен, вызовите функцию DeleteObject , чтобы удалить его.
Координаты региона представлены в виде 27-разрядных целых чисел со знаком.
Области, созданные методами Rgn Create<shape>(например , CreateRectRgn и CreatePolygonRgn), включают только внутреннюю часть фигуры; контур фигуры исключается из области. Это означает, что любая точка на линии между двумя последовательными вершинами не включается в область . Если бы вы вызвали PtInRegion для такой точки, он возвратит ноль в качестве результата.
Примеры
Пример см. в разделе Маркеры рисования.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | wingdi.h (включая Windows.h) |
| Библиотека | Gdi32.lib |
| DLL | Gdi32.dll |