共用方式為


Scroll Bar

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

概觀

主題 目錄
關於滾動條 滾動條由每個結尾有箭號按鈕的陰影軸和 箭號按鈕之間的滾動盒 (有時稱為拇指)組成。
使用滾動條 建立重疊、彈出視窗或子視窗時,您可以使用 CreateWindowEx 函式來新增標準滾動條,並指定WS_HSCROLLWS_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 函式才能正常運作。

Notifications

主題 目錄
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 和 y 座標和滾動條的其他維度。