Compartilhar via

Função SetBoundsRect (wingdi.h)

  • Artigo

A função SetBoundsRect controla o acúmulo de informações de retângulo delimitador para o contexto do dispositivo especificado. O sistema pode manter um retângulo delimitador para todas as operações de desenho. Um aplicativo pode examinar e definir esse retângulo. Os limites de desenho são úteis para invalidar caches de bitmap.

Sintaxe

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

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo para o qual acumular retângulos delimitados.

[in] lprect

Um ponteiro para uma estrutura RECT usada para definir o retângulo delimitador. As dimensões do retângulo estão em coordenadas lógicas. Este parâmetro pode ser NULL.

[in] flags

Especifica como o novo retângulo será combinado com o retângulo acumulado. Esse parâmetro pode ser um dos valores a seguir.

Valor Significado
DCB_ACCUMULATE
 Adiciona o retângulo especificado pelo parâmetro lprcBounds ao retângulo delimitador (usando uma operação de união de retângulo). Usar DCB_RESET e DCB_ACCUMULATE define o retângulo delimitador para o retângulo especificado pelo parâmetro lprcBounds .
DCB_DISABLE
 Desativa o acúmulo de limites.
DCB_ENABLE
 Ativa o acúmulo de limites, que está desabilitado por padrão.
DCB_RESET
 Limpa o retângulo delimitador.

Valor retornado

Se a função for bem-sucedida, o valor retornado especificará o estado anterior do retângulo delimitador. Esse estado pode ser uma combinação dos valores a seguir.

Valor Significado
DCB_DISABLE O acúmulo de limites está desativado.
DCB_ENABLE O acúmulo de limites está ativado. DCB_ENABLE e DCB_DISABLE são mutuamente exclusivos.
DCB_RESET O retângulo delimitador está vazio.
DCB_SET O retângulo delimitador não está vazio. DCB_SET e DCB_RESET são mutuamente exclusivos.
 

Se a função falhar, o valor retornado será zero.

Comentários

O valor DCB_SET é uma combinação dos valores de bit DCB_ACCUMULATE e DCB_RESET. Os aplicativos que marcar o bit DCB_RESET para determinar se o retângulo delimitador está vazio também devem marcar o bit DCB_ACCUMULATE. O retângulo delimitador só estará vazio se o DCB_RESET bit for 1 e o DCB_ACCUMULATE bit for 0.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wingdi.h (inclua Windows.h)
Biblioteca Gdi32.lib
DLL Gdi32.dll

Confira também

GetBoundsRect

Funções de pintura e desenho

Visão geral de pintura e desenho

RECT