Русский справочник по Win32 API
Шрифт:
int nLeftRect , // x -координата верхнего левого угла прямоугольника
int nTopRect , // y -координата верхнего левого угла прямоугольника
int nRightRect , // x -координата нижнего правого угла прямоугольника
int nBottomRect // y -координата нижнего правого угла прямоугольника
);
Параметры
hdc– идентифицирует контекст устройства.
nLeftRect– идентифицирует логическую x -координату верхнего левого угла прямоугольника.
nTopRect–
nRightRect– идентифицирует логическую x -координату нижнего правого угла прямоугольника.
nBottomRect– идентифицирует логическую y -координату нижнего правого угла прямоугольника.
Возвращаемые значения
В случае успеха возвращаемое значение определяет сложность области и может быть одним из предопределенных значений:
| Значение | Пояснение |
| COMPLEXREGION | Область состоит более чем из одного прямоугольника. |
| ERROR | Произошла ошибка. |
| NULLREGION | Пустая область. |
| SIMPLEREGION | Область является одиночным прямоугольником. |
Комментарии
Нижняя и правая грани указанного прямоугольника исключаются из области отсечения.
См . также
ExcludeClipRect .
OffsetClipRgn
Функция OffsetClipRgn перемещает область отсечения контекста устройства на указанные смещения.
int OffsetClipRgn (
HDC hdc , // дескриптор контекста устройства
int nXOffset , // смещение вдоль оси x
int nYOffset // смещение вдоль оси y
);
Параметры
hdc– идентифицирует контекст устройства.
nXOffset– определяет количество логических единиц для перемещения влево или вправо.
nYOffset– определяет количество логических единиц для перемещения вверх или вниз.
Возвращаемые значения
В случае успеха возвращаемое значение определяет сложность области и может быть одним из предопределенных значений:
| Значение | Пояснение |
| COMPLEXREGION | Область состоит более чем из одного прямоугольника. |
| ERROR | Произошла ошибка. |
| NULLREGION | Пустая область. |
| SIMPLEREGION | Область является одиночным прямоугольником. |
См. также
SelectClipRgn .
SelectClipPath
Функция SelectClipPath выбирает текущий путь ( path ) в качестве области отсечения для контекста устройства, объединяя новую область отсечения с существующей, используя указанный режим.
BOOL SelectClipPath (
HDC hdc , // дескриптор контекста устройства
int iMode // режим отсечения
);
Параметры
hdc– идентифицирует контекст устройства пути.
iMode– определяет способ использования пути. Допустимы следующие значения:
| Значение | Пояснение |
| RGN _ AND | Новая область отсечения включает пересечение (перекрывающиеся участки) текущей области отсечения и текущего пути. |
| RGN _ COPY | Новой областью отсечения является текущий путь. |
| RGN _ DIFF | Новая область отсечения включает участки текущей области отсечения и участки, исключенные из текущего пути. |
| RGN _ OR | Новая область отсечения представляет собой объединение текущей области отсечения и текущего пути. |
| RGN _ XOR | Новая область отсечения включает в себя объединение текущей области отсечения и текущего пути, но без пересекающихся участков. |
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError . GetLastError может возвращать один из следующих кодов ошибки:
ERROR_CAN_NOT_COMPLETE
ERROR_INVALID_PARAMETER
ERROR_NOT_ENOUGH_MEMORY
Комментарии
Контекст устройства, идентифицируемый значением параметра hdc , должен содержать замкнутый путь.
См. также
BeginPath, EndPath .
SelectClipRgn
Функция SelectClipRgn выбирает область в качестве текущей области отсечения для указанного контекста устройства.
int SelectClipRgn (
HDC hdc , // дескриптор контекста устройства
HRGN hrgn // дескриптор выбираемой области
);
Параметры
hdc– идентифицирует контекст устройства.
hrgn– идентифицирует область, которая выбирается.
Возвращаемые значения
В случае успеха возвращаемое значение определяет сложность области и может быть одним из предопределенных значений: