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