<Return[S]><Top>

ScrollWindowEx

Declare Function Api_ScrollWindowEx& Lib "user32" Alias "ScrollWindowEx" (ByVal hWnd&, ByVal dx&, ByVal dy&, prcScroll As RECT, prcClip As RECT, ByVal hrgnUpdate&, prcUpdate As RECT, ByVal Flags&)

Declare Function ScrollWindowEx Lib "user32" (ByVal hWnd As Long, ByVal dx As Long, ByVal dy As Long, prcScroll As RECT, prcClip As RECT, ByVal hrgnUpdate As Long, prcUpdate As RECT, ByVal Flags As Long) As Long

パラメータ
dx
    水平方向のスクロール量をデバイス単位で指定する。左にスクロールするには、負の値を指定する。
dy
    垂直方向のスクロール量をデバイス単位で指定する。上にスクロールするには、負の値を指定する。
lpRectScroll
    スクロールするクライアント領域の部分を指定する RECT 構造体を指す。

    このパラメータが NULL の場合は、クライアント領域全体がスクロールする。
lpRectClip
    スクロールのためのクリッピング四角形を示す RECT 構造体を指す。この構造体は、lpRectScroll で指される四角形よりも優先される。

    この四角形の内側のビットだけがスクロールする。

    この四角形の外側のビットは、lpRectScroll で指定された四角形の内側にあっても、影響を受けない。このパラメータが NULL のときは、

    スクロールする四角形はクリッピングされない。
prgnUpdate
    スクロールにより無効となる領域を保持するために、修正される領域を識別する。このパラメータは NULL でもかまわない。
lpRectUpdate
    スクロールにより無効となる四角形の境界を受け取る RECT 構造体を指する。このパラメータは NULL でもかまわない。
flags
    次のいずれかの値になる。

    値                                     

意味                                                                                                                                 

    SW_ERASE

SW_INVALIDATE で指定された場合、ウィンドウに WM_ERASEBKGND メッセージを送信して、

新しく無効になった領域を消去する。

    SW_INVALIDATE

スクロール後、prgnUpdate で識別される領域を無効にする。

    SW_SCROLLCHILDREN

 

 

 

lpRectScroll が指す四角形と交わるすべての子ウィンドウを dx と dy で指定したピクセル数だけスクロールす

る。lpRectScroll と交わるすべての子ウィンドウが移動しない場合でも、Windows は WM_MOVE メッセージ

をそれらの子ウィンドウに送信する。子ウィンドウがスクロールされ、カーソル四角形がスクロール四角形と交

差するときに、カレットの位置は再設定される。

 

戻り値
    関数が正常終了した場合は、SIMPLEREGION (無効化された四角形領域)、COMPLEXREGION (無効化された四角形でない領域;

    重なり合った四角形)、または NULLREGION (無効化される領域なし) のいずれかを返す。それ以外の場合は、ERROR を返す。