Функция SelectClipPath выбирает текущий путь как регион отсечения для контекста устройства, комбинируя новый регион с каким-либо существующим регионом отсечения, используя указанный режим.
Синтаксис
BOOL SelectClipPath( HDC hdc, // дескриптор DC int iMode // режим отсечения ); |
[in] Дескриптор контекста устройства пути.
iMode
[in] Задает способ, которым должен пользоваться путь. Этот параметр может быть одним из следующих значений.
| Значение | Предназначение |
|---|---|
| RGN_AND | Новый регион отсечения включает в себя пересечение (области перекрытия) текущего региона отсечения и текущего пути. |
| RGN_COPY | Новый регион отсечения - текущий путь. |
| RGN_DIFF | Новый регион отсечения включает в себя области текущего региона отсечения с такими же из текущего исключенного пути. |
| RGN_OR | Новый регион отсечения включает в себя объединенные области текущего региона отсечения и текущего пути. |
| RGN_XOR | Новый регион отсечения включает в себя объединение текущего региона отсечения и текущего пути, но без областей перекрытия. |
Если функция завершается успешно, возвращаемое значение является ненулевым.
Если функция завершается ошибкой, возвращаемое значение - нуль.
Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError. GetLastError может возвратить один из следующих кодов ошибки:
ERROR_CAN_NOT_COMPLETE
ERROR_INVALID_PARAMETER
ERROR_NOT_ENOUGH_MEMORY
Контекст устройства, идентифицированный параметром hdc должен иметь в своем составе закрытый путь.
Пример смотри в статье Использование отсечения.
Смотри также
Обзор Отсечение, Функции, используемые отсечением, BeginPath, EndPath
|
Размещение и совместимость SelectClipPath |
||
| К | Windows XP | Да |
| л | Windows 2000 Professional | Да |
| и | Windows NT Workstation | Да версии 3.1 и старше |
| е | Windows Me | Да |
| н | Windows 98 | Да |
| т | Windows 95 | Да |
| С | Windows Server 2003 | Нет |
| е | Windows 2000 Server | Да |
| р | Windows NT Server | Да |
| в | ||
| е | ||
| р | ||
| Используемая библиотека | Gdi32.lib | |
| Используемая DLL | - | |
| Заголовочный файл | ||
| - объявлено в | Wingdi.h | |
| - включено в | Windows.h | |
| Unicode | Нет | |
| Замечания по платформе | Не имеется | |