滾動條

本節包含與滾動條搭配使用之程式設計項目的相關信息。 視窗可以顯示大於視窗工作區的數據物件，例如檔或點陣圖。 當提供 滾動條時，使用者可以捲動工作區中的數據物件，以檢視超出視窗框線的物件部分。

綜述

主題	內容
關於滾動條 的	滾動條由每個結尾有箭頭按鈕的陰影軸和 滾動盒（有時稱為拇指）之間的箭號按鈕組成。
使用滾動條	建立重疊、彈出視窗或子視窗時，您可以使用 CreateWindowEx 函式來新增標準滾動條，並指定 WS_HSCROLL、WS_VSCROLL或兩種樣式。

功能

主題	內容
EnableScrollBar	EnableScrollBar 函式會啟用或停用一個或兩個滾動條箭號。
GetScrollBarInfo	GetScrollBarInfo 函式會擷取指定滾動條的相關信息。
GetScrollInfo	GetScrollInfo 函式會擷取滾動條的參數，包括滾動條的最小和最大卷動位置、頁面大小，以及滾動盒（thumb） 的位置。
GetScrollPos	GetScrollPos 函式會擷取指定滾動條中滾動盒 （thumb） 的目前位置。 目前的位置是相依於目前卷動範圍的相對值。 例如，如果卷動範圍是 0 到 100，而滾動盒位於長條中間，則目前的位置為 50。 注意： 提供 GetScrollPos 函式以提供回溯兼容性。 新的應用程式應該使用 GetScrollInfo 函式。
GetScrollRange	GetScrollRange 函式會擷取指定滾動條的目前最小和最大滾動盒 （thumb） 位置。 注意： 僅針對相容性提供 GetScrollRange 函式。 新的應用程式應該使用 GetScrollInfo 函式。
ScrollDC	ScrollDC 函式會水平和垂直捲動位的矩形。
ScrollWindow	ScrollWindow 函式會捲動指定視窗工作區的內容。 注意： 提供 ScrollWindow 函式以提供回溯兼容性。 新的應用程式應該使用 ScrollWindowEx 函式。
ScrollWindowEx	ScrollWindowEx 函式會捲動指定視窗工作區的內容。
SetScrollInfo	SetScrollInfo 函式會設定滾動條的參數，包括滾動條的最小和最大卷動位置、頁面大小，以及滾動盒 （thumb） 的位置。 如果要求，函式也會重新繪製滾動條。
SetScrollPos	SetScrollPos 函式會設定滾動盒 （thumb） 在指定滾動條中的位置，如果要求，請重新繪製滾動條以反映滾動盒的新位置。 注意： 提供 SetScrollPos 函式以提供回溯兼容性。 新的應用程式應該使用 SetScrollInfo 函式。
SetScrollRange	SetScrollRange 函式會設定指定滾動條的最小和最大滾動盒位置。 注意： 提供 SetScrollRange 函式以提供回溯兼容性。 新的應用程式應該使用 SetScrollInfo 函式。
ShowScrollBar	ShowScrollBar 函式會顯示或隱藏指定的滾動條。

消息

主題	內容
SBM_ENABLE_ARROWS	應用程式會傳送 SBM_ENABLE_ARROWS 訊息，以啟用或停用滾動條控件的一或兩個箭號。
SBM_GETPOS	傳送 SBM_GETPOS 訊息，以擷取滾動條控件之滾動盒的目前位置。 目前的位置是相依於目前卷動範圍的相對值。 例如，如果卷動範圍是 0 到 100，而滾動盒位於長條中間，則目前的位置為 50。 應用程式不應該直接傳送此訊息。 相反地，他們應該使用 GetScrollPos 函式。 視窗會透過其 WindowProc 函式接收此訊息。 實作自定義滾動條控件的應用程式必須回應這些訊息，GetScrollPos 函式才能正常運作。
SBM_GETRANGE	系統會傳送 SBM_GETRANGE 訊息，以擷取滾動條控件的最小和最大位置值。 應用程式不應該直接傳送此訊息。 相反地，他們應該使用 GetScrollRange 函式。 視窗會透過其 WindowProc 函式接收此訊息。 實作自定義滾動條控件的應用程式必須回應這些訊息，GetScrollRange 函式才能正常運作。
SBM_GETSCROLLBARINFO	應用程式傳送以擷取指定滾動條的相關信息。
SBM_GETSCROLLINFO	傳送 SBM_GETSCROLLINFO 訊息以擷取滾動條的參數。 應用程式不應該直接傳送此訊息。 相反地，它們應該使用 GetScrollInfo 函式。 視窗會透過其 WindowProc 函式接收此訊息。 實作自定義滾動條控件的應用程式必須回應這些訊息，GetScrollInfo 函式才能正常運作。
SBM_SETPOS	系統會傳送 SBM_SETPOS 訊息來設定滾動盒 （thumb） 的位置，如果要求，請重新繪製滾動條以反映滾動盒的新位置。 應用程式不應該直接傳送此訊息。 相反地，他們應該使用 SetScrollPos 函式。 視窗會透過其 WindowProc 函式接收此訊息。 實作自定義滾動條控件的應用程式必須回應這些訊息，SetScrollPos 函式才能正常運作。
SBM_SETRANGE	系統會傳送 SBM_SETRANGE 訊息，以設定滾動條控件的最小和最大位置值。 應用程式不應該直接傳送此訊息。 相反地，他們應該使用 SetScrollRange 函式。 視窗會透過其 WindowProc 函式接收此訊息。 實作自定義滾動條控件的應用程式必須回應這些訊息，SetScrollRange 函式才能正常運作。
SBM_SETRANGEREDRAW	應用程式會將 SBM_SETRANGEREDRAW 訊息傳送至滾動條控件，以設定最小和最大位置值，以及重新繪製控件。
SBM_SETSCROLLINFO	傳送 SBM_SETSCROLLINFO 訊息來設定滾動條的參數。 應用程式不應該直接傳送此訊息。 相反地，他們應該使用 SetScrollInfo 函式。 視窗會透過其 WindowProc 函式接收此訊息。 實作自定義滾動條控件的應用程式必須回應這些訊息，SetScrollInfo 函式才能正常運作。

通知

主題	內容
WM_CTLCOLORSCROLLBAR	當控件即將繪製時，會將 WM_CTLCOLORSCROLLBAR 訊息傳送至滾動條控件的父視窗。 透過回應此訊息，父視窗可以使用顯示內容句柄來設定滾動條控件的背景色彩。 視窗會透過其 WindowProc 函式接收此訊息。
WM_HSCROLL	當視窗的標準水準滾動條中發生捲動事件時，會將 WM_HSCROLL 訊息傳送至視窗。 當控件中發生滾動事件時，此訊息也會傳送給水準滾動條控件的擁有者。 視窗會透過其 WindowProc 函式接收此訊息。
WM_VSCROLL	當視窗的標準垂直滾動條中發生捲動事件時，會將 WM_VSCROLL 訊息傳送至視窗。 當控件中發生滾動事件時，此訊息也會傳送給垂直滾動條控件的擁有者。 視窗會透過其 WindowProc 函式接收此訊息。

結構

主題	內容
SCROLLBARINFO	SCROLLBARINFO 結構包含滾動條資訊。
SCROLLINFO	SCROLLINFO 結構包含由 SetScrollInfo 函式（或 SBM_SETSCROLLINFO 訊息）所設定的滾動條參數，或由 GetScrollInfo 函式（或 SBM_GETSCROLLINFO 訊息）所擷取。

常數

主題	內容
滾動條控件樣式	若要使用 CreateWindow 或 CreateWindowEx 函式來建立滾動條控件，請指定 SCROLLBAR 類別、適當的視窗樣式常數，以及下列滾動條控件樣式的組合。 某些樣式會建立使用預設寬度或高度的滾動條控件。 不過，當您 呼叫 createWindow 或 CreateWindowEx時，必須一律指定 x 坐標和滾動條的其他維度。