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