SBM_GETSCROLLINFO訊息

系統會傳送 SBM_GETSCROLLINFO 訊息，以擷取捲軸的參數。

應用程式不應該直接傳送此訊息。 相反地，它們應該使用 GetScrollInfo 函式。 視窗會透過 其 WindowProc 函 式接收此訊息。 實作自訂捲軸控制項的應用程式必須回應這些訊息， GetScrollInfo 函式才能正常運作。

參數

wParam

不使用這個參數。

lParam

SCROLLINFO結構的指標。 呼叫 GetScrollInfo之前，請將 結構的 cbSize 成員設定為 sizeof (SCROLLINFO) ，並將 fMask 成員設定為指定要擷取的捲軸參數。 傳回之前，訊息會將指定的參數複製到結構的適當成員。

fMask成員可以是下列一或多個值。

值	意義
SIF_ALL	SIF_PAGE、SIF_POS、SIF_RANGE和SIF_TRACKPOS的組合。
SIF_PAGE	將捲動頁面複製到 nPage 成員。
SIF_POS	將捲動位置複製到 nPos 成員。
SIF_RANGE	將捲動範圍複製到 nMin 和 nMax 成員。
SIF_TRACKPOS	將目前的捲動方塊追蹤位置複製到 nTrackPos 成員。

傳回值

如果訊息擷取任何值，則傳回值為 TRUE;否則為 FALSE。

備註

指出捲軸位置 的訊息，WM_HSCROLL 和 WM_VSCROLL，只提供 16 位的位置資料。 不過，SBM_GETSCROLLINFO、SBM_SETSCROLLINFO、GetScrollInfo 和 SetScrollInfo所使用的SCROLLINFO結構提供 32 位的捲軸位置資料。 您可以在處理 WM_HSCROLL 或 WM_VSCROLL 訊息時使用這些訊息和函式，以取得 32 位捲軸位置資料。

若要在WM_HSCROLL或WM_VSCROLL訊息的SB_THUMBTRACK要求程式碼期間，取得捲動方塊 (指) 的 32 位位置，請使用SCROLLINFO結構的fMask成員中的SIF_TRACKPOS值傳送SBM_GETSCROLLINFO。 訊息會傳回SCROLLINFO結構的nTrackPos成員中捲動方塊的追蹤位置。 這可讓您在使用者移動捲動方塊時取得捲動方塊的位置。 或者，您可以使用 GetScrollInfo 函式來取得相同的資訊。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
標頭	Winuser.h (包括 Windows.h)

另請參閱

參考

GetScrollInfo

SBM_SETSCROLLINFO

SCROLLINFO

SetScrollInfo