Compartilhar via

Função GetBoundsRect (wingdi.h)

  • Artigo

A função GetBoundsRect obtém o retângulo delimitador acumulado atual para um contexto de dispositivo especificado.

O sistema mantém um retângulo delimitador acumulado para cada aplicativo. Um aplicativo pode recuperar e definir esse retângulo.

Sintaxe

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

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo cujo retângulo delimitador a função retornará.

[out] lprect

Um ponteiro para a estrutura RECT que receberá o retângulo delimitador atual. O retângulo do aplicativo é retornado em coordenadas lógicas e o retângulo delimitador é retornado em coordenadas de tela.

[in] flags

Especifica como a função GetBoundsRect se comportará. Esse parâmetro pode ser o valor a seguir.

Valor Significado
DCB_RESET
 Limpa o retângulo delimitador depois de retorná-lo. Se esse sinalizador não estiver definido, o retângulo delimitador não será limpo.

Retornar valor

O valor retornado especifica o estado do retângulo delimitador acumulado; pode ser um dos valores a seguir.

Valor Significado
0 Ocorreu um erro. O identificador de contexto do dispositivo especificado é inválido.
DCB_DISABLE O acúmulo de limites está desativado.
DCB_ENABLE O acúmulo de limites está ativado.
DCB_RESET O retângulo delimitador está vazio.
DCB_SET O retângulo delimitador não está vazio.

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

Requisito Valor
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

Funções de pintura e desenho

Visão geral de pintura e desenho

SetBoundsRect