SBM_SETSCROLLINFO訊息
系統會傳送 SBM_SETSCROLLINFO 訊息,以設定捲軸的參數。
應用程式不應該直接傳送此訊息。 相反地,它們應該使用 SetScrollInfo 函 式。 視窗會透過 其 WindowProc 函 式接收此訊息。 實作自訂捲軸控制項的應用程式必須回應這些訊息, SetScrollInfo 函式才能正常運作。
參數
-
wParam
-
指定是否要重新繪製捲軸以反映新的捲動方塊位置。 如果此參數為 TRUE,則會重新繪製捲軸。 如果為 FALSE,則不會重新繪製捲軸。
-
lParam
-
SCROLLINFO結構的指標。 在呼叫 SetScrollInfo之前,請將 結構的 cbSize 成員設定為 sizeof (SCROLLINFO) 、設定 fMask 成員來指出要設定的參數,並在適當的成員中指定新的參數值。
fMask成員可以是下列一或多個值。
值 意義 - SIF_DISABLENOSCROLL
停用捲軸,而不是移除捲軸,如果捲軸的新參數使捲軸不必要。 - SIF_PAGE
將捲動頁面設定為 nPage 成員中指定的值。 - SIF_POS
將捲動位置設定為 nPos 成員中指定的值。 - SIF_RANGE
將捲動範圍設定為 nMin 和 nMax 成員中指定的值。
傳回值
傳回值是捲動方塊的目前位置。
備註
指出捲軸位置 的訊息,WM_HSCROLL 和 WM_VSCROLL,只提供 16 位的位置資料。 不過,SBM_GETSCROLLINFO、SBM_SETSCROLLINFO、GetScrollInfo 和 SetScrollInfo所使用的SCROLLINFO結構提供 32 位的捲軸位置資料。 您可以在處理 WM_HSCROLL 或 WM_VSCROLL 訊息時使用這些訊息和函式,以取得 32 位捲軸位置資料。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows Server 2003 [僅限桌面應用程式] |
標頭 |
|