PtInRect 関数 (winuser.h)

PtInRect 関数は、指定した点が指定した四角形内にあるかどうかを判断します。ポイントが左辺または上辺にある場合、または 4 つの辺すべて内にある場合、点は四角形内にあります。右側または下側の点は、四角形の外側と見なされます。

構文

BOOL PtInRect(
  [in] const RECT *lprc,
  [in] POINT      pt
);

[in] lprc

指定した四角形を含む RECT 構造体へのポインター。

[in] pt

指定したポイントを含む POINT 構造体。

指定した点が四角形内にある場合、戻り値は 0 以外です。

指定した点が四角形内にない場合、戻り値は 0 になります。

四角形は、 PtInRect が呼び出される前に正規化する必要があります。つまり、lprc.right は lprc.left より大きく、lprc.bottom は lprc.top より大きくする必要があります。四角形が正規化されていない場合、四角形の内部ではポイントは考慮されません。

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

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


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