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_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 |