FlatSB_SetScrollInfo函式 (commctrl.h)
設定平面滾動條的資訊。 如果未初始化視窗的平面滾動條,此函式會呼叫標準 SetScrollInfo 函 式。
語法
int FlatSB_SetScrollInfo(
HWND unnamedParam1,
int code,
LPSCROLLINFO psi,
BOOL fRedraw
);
參數
unnamedParam1
類型: HWND
包含平面滾動條之視窗的句柄。 這個視窗句柄必須先前在 呼叫 InitializeFlatSB 中傳遞。
code
類型: int
滾動條類型。 它可能是下列其中一個值:
值 | 意義 |
---|---|
|
設定水平滾動條的資訊。 |
|
設定垂直滾動條的資訊。 |
psi
類型: LPSCROLLINFO
SCROLLINFO 結構的指標,其中包含指定滾動條的新資訊。 在呼叫 FlatSB_SetScrollInfo 之前,必須先填入 結構的 cbSize 和 fMask 成員。 fMask 成員會指定結構的哪些成員包含有效資訊,而且可以是下列值的任何組合:
值 | 意義 |
---|---|
|
如果新的資訊會導致移除滾動條,請停用滾動條。 |
|
設定平面滾動條的頁面資訊。 SCROLLINFO 結構的 nPage 成員必須包含新的頁面值。 |
|
設定平面滾動條的位置資訊。 SCROLLINFO 結構的 nPos 成員必須包含新的位置值。 |
|
設定平面滾動條的範圍資訊。 SCROLLINFO 結構的 nMin 和 nMax 成員必須包含新的範圍值。 |
|
SIF_PAGE、SIF_POS和SIF_RANGE的組合。 |
fRedraw
類型: BOOL
指定是否應立即重新繪製滾動條以反映變更。 如果此參數為 TRUE,滾動條會重新繪製;如果為 FALSE,則不會重新繪製滾動條。
傳回值
類型: int
傳回目前的捲動位置。 如果呼叫 FlatSB_SetScrollInfo 變更捲動位置,則會傳回上一個位置。
備註
注意 平面滾動條函式會在 4.71 到 5.82 版 Comctl32.dll 實作。 Comctl32.dll 6.00 版和更新版本不支援平面滾動條。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | commctrl.h |
程式庫 | Comctl32.lib |
Dll | Comctl32.dll (4.71 版或更新版本) |