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 .