Compartir a través de


Función GetClipRgn (wingdi.h)

La función GetClipRgn recupera un identificador que identifica la región de recorte definida por la aplicación actual para el contexto de dispositivo especificado.

Sintaxis

int GetClipRgn(
  [in] HDC  hdc,
  [in] HRGN hrgn
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[in] hrgn

Identificador de una región existente antes de llamar a la función. Una vez que se devuelve la función, este parámetro es un identificador de una copia de la región de recorte actual.

Valor devuelto

Si la función se realiza correctamente y no hay ninguna región de recorte para el contexto de dispositivo determinado, el valor devuelto es cero. Si la función se realiza correctamente y hay una región de recorte para el contexto de dispositivo determinado, el valor devuelto es 1. Si se produce un error, el valor devuelto es -1.

Comentarios

Una región de recorte definida por la aplicación es una región de recorte identificada por la función SelectClipRgn . No es una región de recorte creada cuando la aplicación llama a la función BeginPaint .

Si la función se ejecuta correctamente, el parámetro hrgn es un identificador de una copia de la región de recorte actual. Los cambios posteriores en esta copia no afectarán a la región de recorte actual.

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

BeginPaint

Funciones de recorte

Información general sobre el recorte

SelectClipRgn