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 |