Función GetRandomRgn (wingdi.h)

2024-03-13

La función GetRandomRgn copia la región de recorte del sistema de un contexto de dispositivo especificado en una región específica.

Sintaxis

int GetRandomRgn(
  [in] HDC  hdc,
  [in] HRGN hrgn,
  [in] INT  i
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[in] hrgn

Un identificador de una región. Antes de llamar a la función , esto identifica una región existente. Una vez que se devuelve la función, esto identifica una copia de la región del sistema actual. La región antigua identificada por hrgn se sobrescribe.

[in] i

Este parámetro debe ser SYSRGN.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es 1. Si se produce un error en la función, el valor devuelto es -1. Si la región que se va a recuperar es NULL, el valor devuelto es 0. Si se produce un error en la función o la región que se va a recuperar es NULL, hrgn no se inicializa.

Comentarios

Al usar la marca SYSRGN, tenga en cuenta que es posible que la región de recorte del sistema no esté actualizada debido a los movimientos de ventana. No obstante, es seguro recuperar y usar la región de recorte del sistema dentro del bloque BeginPaint-EndPaint durante el procesamiento de WM_PAINT . En este caso, la región del sistema es la intersección de la región de actualización y el área visible actual de la ventana. Cualquier movimiento de ventana después de la devolución de GetRandomRgn y antes de EndPaint dará como resultado un nuevo mensaje de WM_PAINT . Cualquier otro uso de la marca SYSRGN puede dar lugar a errores de pintura en la aplicación.

La región devuelta está en coordenadas de pantalla.

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