Función GetBoundsRect (wingdi.h)

  • Artículo

La función GetBoundsRect obtiene el rectángulo de límite acumulado actual para un contexto de dispositivo especificado.

El sistema mantiene un rectángulo delimitador acumulado para cada aplicación. Una aplicación puede recuperar y establecer este rectángulo.

Sintaxis

UINT GetBoundsRect(
  [in]  HDC    hdc,
  [out] LPRECT lprect,
  [in]  UINT   flags
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo cuyo rectángulo delimitador devolverá la función.

[out] lprect

Puntero a la estructura RECT que recibirá el rectángulo delimitador actual. El rectángulo de la aplicación se devuelve en coordenadas lógicas y el rectángulo delimitador se devuelve en coordenadas de pantalla.

[in] flags

Especifica cómo se comportará la función GetBoundsRect . Este parámetro puede ser el siguiente valor.

Valor Significado
DCB_RESET
 Borra el rectángulo delimitador después de devolverlo. Si no se establece esta marca, no se borrará el rectángulo delimitador.

Valor devuelto

El valor devuelto especifica el estado del rectángulo delimitador acumulado; puede ser uno de los siguientes valores.

Valor Significado
0 Se produjo un error. El identificador de contexto del dispositivo especificado no es válido.
DCB_DISABLE La acumulación de límites está desactivada.
DCB_ENABLE La acumulación de límites está activada.
DCB_RESET El rectángulo delimitador está vacío.
DCB_SET : el rectángulo delimitador no está vacío.

Comentarios

El valor de DCB_SET es una combinación de los valores de bits DCB_ACCUMULATE y DCB_RESET. Las aplicaciones que comprueban el bit de DCB_RESET para determinar si el rectángulo delimitador está vacío también debe comprobar el bit de DCB_ACCUMULATE. El rectángulo delimitador está vacío solo si el bit de DCB_RESET es 1 y el DCB_ACCUMULATE bit es 0.

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

Funciones de dibujo y pintura

Información general sobre la pintura y el dibujo

SetBoundsRect