SetBoundsRect 関数 (wingdi.h)

  • [アーティクル]

SetBoundsRect 関数は、指定されたデバイス コンテキストの外接する四角形情報の蓄積を制御します。 システムは、すべての描画操作に対して外接する四角形を維持できます。 アプリケーションは、この四角形を調べて設定できます。 描画境界は、ビットマップ キャッシュを無効にする場合に役立ちます。

構文

UINT SetBoundsRect(
  [in] HDC        hdc,
  [in] const RECT *lprect,
  [in] UINT       flags
);

パラメーター

[in] hdc

外接する四角形を累積するデバイス コンテキストへのハンドル。

[in] lprect

外接する四角形を設定するために使用される RECT 構造体へのポインター。 四角形の寸法は論理座標です。 このパラメーターは、NULL でもかまいません。

[in] flags

新しい四角形を累積四角形と組み合わせる方法を指定します。 このパラメーターには、次のいずれかの値を指定できます。

値 説明
DCB_ACCUMULATE
 lprcBounds パラメーターで指定された四角形を外接する四角形に追加します (四角形の和集合演算を使用)。 DCB_RESETとDCB_ACCUMULATEの両方を使用すると、外接する四角形が lprcBounds パラメーターで指定された四角形に設定されます。
DCB_DISABLE
 境界の累積をオフにします。
DCB_ENABLE
 境界の累積をオンにします。これは既定で無効になっています。
DCB_RESET
 外接する四角形をクリアします。

戻り値

関数が成功した場合、戻り値は外接する四角形の以前の状態を指定します。 この状態は、次の値の組み合わせにすることができます。

値 説明
DCB_DISABLE 境界の累積はオフです。
DCB_ENABLE 境界の累積がオンになっている。 DCB_ENABLEとDCB_DISABLEは相互に排他的です。
DCB_RESET 外接する四角形は空です。
DCB_SET 外接する四角形は空ではありません。 DCB_SETとDCB_RESETは相互に排他的です。
 

関数が失敗した場合は、0 を返します。

解説

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

関連項目

GetBoundsRect

描画関数と描画関数

描画と描画の概要

Rect