GetBoundsRect 関数 (wingdi.h)

GetBoundsRect 関数は、指定されたデバイス コンテキストの現在の累積外接する四角形を取得します。

システムは、各アプリケーションに対して累積された外接する四角形を保持します。 アプリケーションは、この四角形を取得して設定できます。

構文

UINT GetBoundsRect(
  [in]  HDC    hdc,
  [out] LPRECT lprect,
  [in]  UINT   flags
);

パラメーター

[in] hdc

関数が返す外接する四角形を持つデバイス コンテキストへのハンドル。

[out] lprect

現在の外接する四角形を受け取る RECT 構造体へのポインター。 アプリケーションの四角形は論理座標で返され、外接する四角形は画面座標で返されます。

[in] flags

GetBoundsRect 関数の動作方法を指定します。 このパラメーターには、次の値を指定できます。

値	意味
DCB_RESET	四角形を返した後、外接する四角形をクリアします。 このフラグが設定されていない場合、外接する四角形はクリアされません。

戻り値

戻り値は、累積された外接する四角形の状態を指定します。次のいずれかの値を指定できます。

値	意味
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

こちらもご覧ください

描画関数と描画関数

描画と描画の概要

SetBoundsRect