Текущая область отсечения контекста устройства определяется пересечением его области отсечения и его метаобласти.
См. также
SetMetaRgn .
IntersectClipRect
Функция IntersectClipRect создает новую область отсечения из пересечения текущей области отсечения и указанного прямоугольника.
int IntersectClipRect (
HDC hdc , // дескриптор контекста устройства
int nLeftRect , // x -координата верхнего левого угла прямоугольника
int nTopRect , // y -координата верхнего левого угла прямоугольника
int nRightRect , // x -координата нижнего правого угла прямоугольника
int nBottomRect // y -координата нижнего правого угла прямоугольника
);
Параметры
hdc - идентифицирует контекст устройства.
nLeftRect - идентифицирует логическую x -координату верхнего левого угла прямоугольника.
nTopRect - идентифицирует логическую y -координату верхнего левого угла прямоугольника.
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 - идентифицирует область, которая выбирается.
Возвращаемые значения
В случае успеха возвращаемое значение определяет сложность области и может быть одним из предопределенных значений:
|
Значение |
Пояснение |
|
COMPLEXREGION |
Область состоит более чем из одного прямоугольника. |
|
ERROR |
Произошла ошибка. |
|
NULLREGION |