Función OffsetRect (winuser.h)

Artículo
08/27/2023

La función OffsetRect mueve el rectángulo especificado por los desplazamientos especificados.

Sintaxis

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

Parámetros

[in, out] lprc

Puntero a una estructura RECT que contiene las coordenadas lógicas del rectángulo que se va a mover.

[in] dx

Especifica la cantidad que se va a mover el rectángulo de izquierda o derecha. Este parámetro debe ser un valor negativo para mover el rectángulo a la izquierda.

[in] dy

Especifica la cantidad que se va a mover el rectángulo hacia arriba o hacia abajo. Este parámetro debe ser un valor negativo para subir el rectángulo.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

Dado que las aplicaciones pueden usar rectángulos para distintos propósitos, las funciones de rectángulo no usan una unidad de medida explícita. En su lugar, todas las coordenadas y dimensiones del rectángulo se proporcionan en valores lógicos con signo. El modo de asignación y la función en la que se usa el rectángulo determinan las unidades de medida.

Ejemplos

Para obtener un ejemplo, vea Uso de rectángulos.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll