Função SetRect (winuser.h)

A função SetRect define as coordenadas do retângulo especificado. Isso equivale a atribuir os argumentos esquerdo, superior, direito e inferior aos membros apropriados da estrutura RECT .

Sintaxe

BOOL SetRect(
  [out] LPRECT lprc,
  [in]  int    xLeft,
  [in]  int    yTop,
  [in]  int    xRight,
  [in]  int    yBottom
);

Parâmetros

[out] lprc

Ponteiro para a estrutura RECT que contém o retângulo a ser definido.

[in] xLeft

Especifica a coordenada x do canto superior esquerdo do retângulo.

[in] yTop

Especifica a coordenada y do canto superior esquerdo do retângulo.

[in] xRight

Especifica a coordenada x do canto inferior direito do retângulo.

[in] yBottom

Especifica a coordenada y 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

Como os aplicativos podem usar retângulos para fins diferentes, as funções de retângulo não usam uma unidade de medida explícita. Em vez disso, todas as coordenadas e dimensões do retângulo são fornecidas em valores lógicos com sinal. O modo de mapeamento e a função na qual o retângulo é usado determinam as unidades de medida.

Exemplos

Para obter um exemplo, consulte Usando retângulos.

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 winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll

Confira também

CopyRect

RECT

Funções de retângulo

Visão geral dos retângulos

SetRectEmpty