GetBoundsRect 関数 (wingdi.h)
GetBoundsRect 関数は、指定されたデバイス コンテキストの現在の累積外接する四角形を取得します。
システムは、各アプリケーションに対して累積された外接する四角形を保持します。 アプリケーションは、この四角形を取得して設定できます。
構文
UINT GetBoundsRect(
[in] HDC hdc,
[out] LPRECT lprect,
[in] UINT flags
);
パラメーター
[in] hdc
関数が返す外接する四角形を持つデバイス コンテキストへのハンドル。
[out] lprect
現在の外接する四角形を受け取る RECT 構造体へのポインター。 アプリケーションの四角形は論理座標で返され、外接する四角形は画面座標で返されます。
[in] flags
GetBoundsRect 関数の動作方法を指定します。 このパラメーターには、次の値を指定できます。
値 | 意味 |
---|---|
|
四角形を返した後、外接する四角形をクリアします。 このフラグが設定されていない場合、外接する四角形はクリアされません。 |
戻り値
戻り値は、累積された外接する四角形の状態を指定します。次のいずれかの値を指定できます。
値 | 意味 |
---|---|
0 | エラーが発生しました。 指定されたデバイス コンテキスト ハンドルが無効です。 |
DCB_DISABLE | 境界の累積はオフです。 |
DCB_ENABLE | 境界の累積がオンになっている。 |
DCB_RESET | 外接する四角形が空です。 |
DCB_SET | 外接する四角形は空ではありません。 |
注釈
DCB_SET値は、DCB_ACCUMULATEビット値とDCB_RESETの組み合わせです。 外接する四角形が空かどうかを判断するためにDCB_RESET ビットをチェックするアプリケーションも、DCB_ACCUMULATE ビットをチェックする必要があります。 外接する四角形は、DCB_RESET ビットが 1 で、DCB_ACCUMULATE ビットが 0 の場合にのみ空になります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | wingdi.h (Windows.h を含む) |
Library | Gdi32.lib |
[DLL] | Gdi32.dll |