Compartilhar via


Função retângulo (wingdi.h)

A função Rectangle desenha um retângulo. O retângulo é descrito usando a caneta atual e preenchido usando o pincel atual.

Sintaxe

BOOL Rectangle(
  [in] HDC hdc,
  [in] int left,
  [in] int top,
  [in] int right,
  [in] int bottom
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] left

A coordenada x, em coordenadas lógicas, do canto superior esquerdo do retângulo.

[in] top

A coordenada y, em coordenadas lógicas, do canto superior esquerdo do retângulo.

[in] right

A coordenada x, em coordenadas lógicas, do canto inferior direito do retângulo.

[in] bottom

A coordenada y, em coordenadas lógicas, do canto inferior direito do retângulo.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

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

Comentários

A posição atual não é usada nem atualizada pelo Retângulo.

O retângulo desenhado exclui as bordas inferior e direita.

Se uma caneta PS_NULL for usada, as dimensões do retângulo serão 1 pixel a menos de altura e 1 pixel a menos de largura.

Exemplos

Para obter um exemplo, consulte Usando formas preenchidas.

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 forma preenchidas

Visão geral das formas preenchidas

Roundrect