wingdi.h
SelectClipPath
La función SelectClipPath selecciona el camino actual como región de recorte para el contexto de dispositivo, combinando la nueva región con cualquiera existente usando el modo especificado.
Sintaxis
BOOL SelectClipPath(
HDC hdc, // manipulador de contexto de dispositivo
int iMode // modo de recorte
);
Parámetros
hdc: identifica el contexto de dispositivo.
iMode: especifica el modo de usar el camino. Se permiten los siguientes valores:
| Valor | Significado |
|---|---|
| RGN_AND | La nueva región de recorte se compone de las áreas superpuestas de la región de recorte actual y del camino actual. |
| RGN_COPY | La nueva región de recorte es el camino actual. |
| RGN_DIFF | La nueva región de recorte se compone de las áreas de la región de recorte actual excluyendo las del camino actual. |
| RGN_OR | La nueva región de recorte une la región de recorte actual y la región definida por el camino actual. |
| RGN_XOR | La nueva región de recorte se compone de la suma de las áreas en la región de recorte actual y la del camino actual, pero excluye las áreas superpuestas. |
Valor de retorno
Si la función tiene éxito, el valor de retorno es distinto de cero.
Si la función falla, el valor de retorno es cero. Para obtener información adicional sobre el error, llamar a GetLastError. GetLastError puede devolver uno de los siguientes códigos:
ERROR_CAN_NOT_COMPLETE ERROR_INVALID_PARAMETER ERROR_NOT_ENOUGH_MEMORY