SetScrollPos

SetScrollPos 関数は指定されたスクロールバーのスクロールボックスの位置を設定し、要求された場合は新位置を反映するためにスクロールバーを再描画する。

SetScrollPos hWnd, nBar, nPos, bRedraw

hWnd : [intptr] 型: HWND スクロールバーコントロールまたは標準スクロールバーを持つウィンドウへのハンドル。
nBar : [int] 型: int
nPos : [int] 型: int スクロールボックスの新しい位置。スクロール範囲内になければならない。
bRedraw : [int] 型: BOOL スクロールボックスの新位置を反映するためにスクロールバーを再描画するかを指定する。

(プラグイン / モジュール : user32.dll)

解説

SetScrollPos
関数は指定されたスクロールバーのスクロールボックスの位置を設定し、要求された場合は新位置を反映するためにスクロールバーを再描画する。

[戻り値]
型: int 関数が成功した場合、戻り値はスクロールボックスの以前の位置。
失敗した場合、戻り値は 0。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
スクロールバーが後続の関数呼び出しで再描画される場合、bRedraw を FALSE にするのが有用である。SetScrollInfo
などは 32 ビットのスクロールバー位置データをサポートするので、WM_HSCROLL/WM_VSCROLL メッセージの 16
ビット制限を回避できる。

情報