Función SetBoundsRect (wingdi.h)

La función SetBoundsRect controla la acumulación de información de rectángulo delimitador para el contexto de dispositivo especificado. El sistema puede mantener un rectángulo delimitador para todas las operaciones de dibujo. Una aplicación puede examinar y establecer este rectángulo. Los límites de dibujo son útiles para invalidar las memorias caché de mapa de bits.

Sintaxis

UINT SetBoundsRect(
  [in] HDC        hdc,
  [in] const RECT *lprect,
  [in] UINT       flags
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo para el que se van a acumular rectángulos delimitadores.

[in] lprect

Puntero a una estructura RECT utilizada para establecer el rectángulo delimitador. Las dimensiones del rectángulo están en coordenadas lógicas. Este parámetro puede ser NULL.

[in] flags

Especifica cómo se combinará el nuevo rectángulo con el rectángulo acumulado. Este parámetro puede ser uno de los siguientes valores.

Valor Significado
DCB_ACCUMULATE
Agrega el rectángulo especificado por el parámetro lprcBounds al rectángulo delimitador (mediante una operación de unión de rectángulo). Con DCB_RESET y DCB_ACCUMULATE establece el rectángulo delimitador en el rectángulo especificado por el parámetro lprcBounds .
DCB_DISABLE
Desactiva la acumulación de límites.
DCB_ENABLE
Activa la acumulación de límites, que está deshabilitada de forma predeterminada.
DCB_RESET
Borra el rectángulo delimitador.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto especifica el estado anterior del rectángulo delimitador. Este estado puede ser una combinación de los valores siguientes.

Valor Significado
DCB_DISABLE La acumulación de límites está desactivada.
DCB_ENABLE La acumulación de límites está activada. DCB_ENABLE y DCB_DISABLE son mutuamente excluyentes.
DCB_RESET : el rectángulo delimitador está vacío.
DCB_SET : el rectángulo delimitador no está vacío. DCB_SET y DCB_RESET son mutuamente excluyentes.
 

Si la función no se realiza correctamente, el valor devuelto es cero.

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

   
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

GetBoundsRect

Funciones de dibujo y pintura

Información general sobre la pintura y el dibujo

RECT