<Return[S]><Top>

SetBoundsRect

Declare Function Api_SetBoundsRect& Lib "gdi32" Alias "SetBoundsRect" (ByVal hDC&, lprcBounds As RECT, ByVal flags&)

Declare Function SetBoundsRect Lib "gdi32" Alias "SetBoundsRect" (ByVal hdc As Long, lprcBounds As RECT, ByVal flags As Long) As Long

指定されたデバイスコンテキスト（DC）の外接四角形の重ね合わせ情報を操作する。システムは、すべての描画処理のために外接四角形を維持することがでる。アプリケーションはこの四角形を調べ、設定することができる。境界の描画は、ビットマップキャッシュを無効にするのに役立つ。

パラメータ
hdc
    ［入力］外接四角形の重ね合わせを制御する DC のハンドルを指定する。
lprcBounds
    ［入力］境界四角形を設定するために使われる 構造体へのポインタを指定する。四角形の大きさは論理座標で表現される。NULL を指定することもできる。
flags
    ［入力］新しい四角形を重ね合わされている四角形と組み合わせる方法を指定する。次の 1 つ以上の値を指定する。

    値                                 

意味                                                                                                                    

    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

    の場合に限り、外接四角形は空となる。