wingdi.h


GetClipRgn

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

Sintaxis

int GetClipRgn(
    HDC hdc,   // manipulador de contexto de dispositivo
    HRGN hrgn  // manipulador de región
   );

Parámetros:

hdc: identifica el contexto de dispositivo.

hrgn: identifica una región que ya existe antes de la llamada a la función. Después de que la función regresen este parámetro indentifica a una copia de la región de recorte actual.

Valor de retorno

Si la función tiene éxito y no exite una región de recorte para el contexto de dispositivo dado, el valor de retorno es cero. Si la función tiene éxito y existe una región de recorte, el valor de retorno es 1. Si ocurre un error, el valor de retorno es -1.

Observaciones

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 tiene éxito, el parámetro hrgn identifica a una copia de la región de recorte actual. Futuros cambios en esta copia no afectarán a la región de recorte actual.