Функция SelectClipPath (wingdi.h)

  • Статья

Функция SelectClipPath выбирает текущий путь в качестве области обрезки для контекста устройства, объединяя новый регион с любой существующей областью обрезки в указанном режиме.

Синтаксис

BOOL SelectClipPath(
  [in] HDC hdc,
  [in] int mode
);

Параметры

[in] hdc

Дескриптор для контекста устройства пути.

[in] mode

Способ использования пути. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
RGN_AND
 Новая область обрезки включает пересечение (перекрывающиеся области) текущей области обрезки и текущего пути.
RGN_COPY
 Новый регион обрезки — это текущий путь.
RGN_DIFF
 Новый регион обрезки включает области текущей области обрезки с областями текущего пути, исключенными.
RGN_OR
 Новая область обрезки включает объединение (объединенные области) текущей области обрезки и текущий путь.
RGN_XOR
 Новая область обрезки включает объединение текущей области обрезки и текущего пути, но без перекрывающихся областей.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение.

Комментарии

Контекст устройства, определяемый параметром hdc, должен содержать закрытый путь.

Примеры

Пример см. в разделе Использование обрезки.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header wingdi.h (включая Windows.h)
Библиотека Gdi32.lib
DLL Gdi32.dll

См. также раздел

BeginPath

Функции обрезки

Общие сведения об обрезки

EndPath