Función GetRandomRgn (wingdi.h)
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 |