SubtractRect 関数 (winuser.h)
SubtractRect 関数は、ある四角形を別の四角形から減算することによって形成される四角形の座標を決定します。
構文
BOOL SubtractRect(
[out] LPRECT lprcDst,
[in] const RECT *lprcSrc1,
[in] const RECT *lprcSrc2
);
パラメーター
[out] lprcDst
lprcSrc1 が指す四角形から lprcSrc2 が指す四角形を減算することによって決定される四角形の座標を受け取る RECT 構造体へのポインター。
[in] lprcSrc1
関数が lprcSrc2 が指す四角形を減算する RECT 構造体へのポインター。
[in] lprcSrc2
関数が lprcSrc1 が指す四角形から減算する RECT 構造体へのポインター。
戻り値
結果の四角形が空の場合、戻り値は 0 になります。
結果の四角形が空でない場合、戻り値は 0 以外です。
解説
関数は、 lprcSrc1 で指定された四角形から lprcSrc2 で指定された四角形を、x 方向または y 方向のいずれかで完全に交差する場合にのみ減算します。 たとえば、*lprcSrc1 に座標 (10,10,100,100) があり、*lprcSrc2 に座標 (50,50,150,150,150) がある場合、関数は lprcDst が指す四角形の座標を (10,10,100,100,100) に設定します。 *lprcSrc1 に座標 (10,10,100,100) があり、*lprcSrc2 に座標 (50,10,150,150) がある場合、関数は lprcDst が指す四角形の座標を (10,10,50,100)に設定します。 つまり、結果として得られる四角形は、幾何学的差の境界ボックスになります。
アプリケーションではさまざまな目的で四角形を使用できるため、四角形関数では明示的な測定単位は使用されません。 代わりに、すべての四角形の座標と寸法が符号付きの論理値で指定されます。 マッピング モードと四角形を使用する関数によって、測定単位が決まります。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winuser.h (Windows.h を含む) |
| Library | User32.lib |
| [DLL] | User32.dll |