OffsetRect 関数 (winuser.h)

OffsetRect 関数は、指定した四角形を指定したオフセットだけ移動します。

構文

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

[in, out] lprc

移動する四角形の論理座標を含む RECT 構造体へのポインター。

[in] dx

四角形を左右に移動する量を指定します。四角形を左に移動するには、このパラメーターは負の値である必要があります。

[in] dy

四角形を上下に移動する量を指定します。四角形を上に移動するには、このパラメーターは負の値である必要があります。

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。

アプリケーションではさまざまな目的で四角形を使用できるため、四角形関数では明示的な測定単位は使用されません。代わりに、すべての四角形の座標と寸法が符号付きの論理値で指定されます。マッピングモードと四角形を使用する関数によって、測定単位が決まります。

例については、「四角形の使用」を参照してください。


サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	winuser.h (Windows.h を含む)
Library	User32.lib
[DLL]	User32.dll