SelectClipPath

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 .