GetScrollPos

GetScrollPos 関数は指定スクロールバーのスクロールボックス(サム)の現在位置を取得する。

GetScrollPos hWnd, nBar

hWnd : [intptr] 型: HWND nBar パラメータの値により、スクロールバーコントロールへのハンドル、または標準スクロールバーを持つウィンドウへのハンドル。
nBar : [int] 型: int

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

解説

GetScrollPos 関数は指定スクロールバーのスクロールボックス(サム)の現在位置を取得する。

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

[備考]
GetScrollPos はアプリケーションが 32 ビットのスクロール位置を使えるようにする。スクロールバー位置を示すメッセージである
WM_HSCROLL や WM_VSCROLL は 16 ビットの位置データに制限されているが、SetScrollPos,
SetScrollRange, GetScrollPos, GetScrollRange は 32
ビットのスクロールバー位置データをサポートする。したがって、WM_HSCROLL または WM_VSCROLL メッセージの処理中に
GetScrollPos を呼ぶことで 32 ビットのスクロール位置データを取得できる。WM_HSCROLL または WM_VSCROLL
メッセージ内で SB_THUMBTRACK リクエストコードを処理中にスクロールボックス(サム)の 32 ビット位置を取得するには
GetScrollInfo 関数を使う。nBar が SB_CTL で、hWnd
が示すウィンドウがシステムスクロールバーコントロールでない場合、システムはそのウィンドウに SBM_GETPOS
メッセージを送ってスクロールバー情報を取得する。これにより GetScrollPos
はスクロールバーを模倣したカスタムコントロールでも動作する。ウィンドウが SBM_GETPOS を処理しない場合、GetScrollPos
は失敗する。

情報