指定された点が、指定された長方形の内側にあるかどうかを調べます。長方形の左辺と上辺は、長方形の内側と見なされます。長方形の右辺と下辺は、長方形の外側と見なされます。

BOOL PtInRect(
  CONST RECT *lprc,  // 長方形
  POINT pt           // 点
);

パラメータ

lprc

長方形の座標を保持している 1 個の 構造体へのポインタを指定します。

pt

調査対象の点の座標を保持している 1 個の 構造体を指定します。

戻り値

指定された点が長方形の内側にある場合、0 以外の値が返ります。

指定された点が長方形の外側にある場合、0 が返ります。

Windows NT/2000：拡張エラー情報を取得するには、 関数を使います。

解説

PtInRect を呼び出す前に、長方形を正規化しておかなければなりません。つまり、lprc.right は lprc.left より大きくなければならず、lprc.bottom は lprc.top より大きくなければなりません。長方形が正規化されていない場合、どのような点を指定しても、その点は長方形の内部にあると見なされません。

対応情報

Windows NT/2000：Windows NT 3.1 以降
Windows 95/98：Windows 95 以降
ヘッダー：Winuser.h 内で宣言、Windows.h をインクルード
インポートライブラリ：User32.lib を使用

参照

EqualRect, IsRectEmpty, ,