Función SelectClipPath (wingdi.h)

  • Artículo

La función SelectClipPath selecciona la ruta de acceso actual como región de recorte para un contexto de dispositivo, combinando la nueva región con cualquier región de recorte existente mediante el modo especificado.

Sintaxis

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

Parámetros

[in] hdc

Identificador del contexto del dispositivo de la ruta de acceso.

[in] mode

La forma de usar la ruta de acceso. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
RGN_AND
 : la nueva zona de recorte incluye la intersección (las áreas superpuestas) de la zona de recorte actual y el trazado actual.
RGN_COPY
 : la nueva zona de recorte es el trazado actual.
RGN_DIFF
 La nueva región de recorte incluye las áreas de la región de recorte actual con las de la ruta de acceso actual excluidas.
RGN_OR
 : la nueva zona de recorte incluye la unión (las áreas combinadas) de la zona de recorte actual y el trazado actual.
RGN_XOR
 La nueva región de recorte incluye la unión de la región de recorte actual y la ruta de acceso actual, pero sin las áreas superpuestas.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

El contexto del dispositivo identificado por el parámetro hdc debe contener una ruta de acceso cerrada.

Ejemplos

Para obtener un ejemplo, consulte Uso del recorte.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wingdi.h (incluye Windows.h)
Library Gdi32.lib
Archivo DLL Gdi32.dll

Consulte también

BeginPath

Funciones de recorte

Información general sobre el recorte

EndPath