FlatSB_SetScrollProp函式 (commctrl.h)

設定平面滾動條的屬性。

語法

BOOL FlatSB_SetScrollProp(
  HWND    unnamedParam1,
  UINT    index,
  INT_PTR newValue,
  BOOL    unnamedParam4
);

參數

unnamedParam1

類型： HWND

包含平面滾動條之視窗的句柄。 這個視窗句柄必須先前在 呼叫 InitializeFlatSB 中傳遞。

index

類型： UINT

決定 newValue 所代表的內容，以及正在設定的屬性。 此參數可以是下列其中一個值：

值	意義
WSB_PROP_CXHSCROLL	newValue 是INT_PTR值，代表水準滾動條中方向按鈕的寬度，以像素為單位。
WSB_PROP_CXHTHUMB	newValue 是INT_PTR值，代表水準滾動條中指紋的寬度，以像素為單位。
WSB_PROP_CXVSCROLL	newValue 是INT_PTR值，代表垂直滾動條的寬度，以像素為單位。
WSB_PROP_CYHSCROLL	newValue 是INT_PTR值，代表水準滾動條的高度，以像素為單位。
WSB_PROP_CYVSCROLL	newValue 是一個INT_PTR值，代表垂直滾動條中方向按鈕的高度，以圖元為單位。
WSB_PROP_CYVTHUMB	newValue 是一個INT_PTR值，代表垂直滾動條中指紋的高度，以像素為單位。
WSB_PROP_HBKGCOLOR	newValue 是 COLORREF 值，代表水平滾動條中的背景色彩。
WSB_PROP_HSTYLE	newValue 是下列其中一個值，可變更水準滾動條的視覺效果。 FSB_ENCARTA_MODE 標準平面滾動條隨即顯示。 當滑鼠移至方向按鈕或指紋上方時，滾動條的該部分會顯示在 3D 中。 FSB_FLAT_MODE 標準平面滾動條隨即顯示。 當滑鼠移至方向按鈕或 Thumb 上方時，滾動條的該部分將會以反轉色彩顯示。 FSB_REGULAR_MODE 會顯示一般非擴充滾動條。 不會套用任何特殊的視覺效果。
WSB_PROP_PALETTE	newValue 是 HPALETTE 值，代表繪製時滾動條應該使用的新調色盤。
WSB_PROP_VBKGCOLOR	newValue 是 COLORREF 值，代表垂直滾動條中的背景色彩。
WSB_PROP_VSTYLE	newValue 是下列其中一個值，可變更垂直滾動條的視覺效果： FSB_ENCARTA_MODE 標準平面滾動條隨即顯示。 當滑鼠移至方向按鈕或指紋上方時，滾動條的該部分會顯示在 3D 中。 FSB_FLAT_MODE 標準平面滾動條隨即顯示。 當滑鼠移至方向按鈕或 Thumb 上方時，滾動條的該部分將會以反轉色彩顯示。 FSB_REGULAR_MODE 會顯示一般非擴充滾動條。 不會套用任何特殊的視覺效果。

newValue

類型： INT_PTR

要設定的新值。 此參數取決於傳入 索引的旗標。

unnamedParam4

類型： BOOL

指定是否應立即重新繪製滾動條以反映變更。 如果此參數為 TRUE，滾動條會重新繪製;如果為 FALSE，則不會重新繪製滾動條。

傳回值

類型： BOOL

如果成功，則傳回非零，否則傳回零。

備註

注意 平面滾動條函式會在 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 版或更新版本)