Compartilhar via


Função OffsetRect (winuser.h)

A função OffsetRect move o retângulo especificado pelos deslocamentos especificados.

Sintaxe

BOOL OffsetRect(
  [in, out] LPRECT lprc,
  [in]      int    dx,
  [in]      int    dy
);

Parâmetros

[in, out] lprc

Ponteiro para uma estrutura RECT que contém as coordenadas lógicas do retângulo a ser movido.

[in] dx

Especifica o valor para mover o retângulo para a esquerda ou direita. Esse parâmetro deve ser um valor negativo para mover o retângulo para a esquerda.

[in] dy

Especifica o valor para mover o retângulo para cima ou para baixo. Esse parâmetro deve ser um valor negativo para mover o retângulo para cima.

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 diferentes finalidades, 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

   
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

InflateRect

IntersectRect

RECT

Funções de retângulo

Visão geral dos retângulos

UnionRect