FlatSB_SetScrollProp-Funktion (commctrl.h)

Artikel
02/26/2024

Legt die Eigenschaften für eine flache Scrollleiste fest.

Syntax

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

Parameter

unnamedParam1

Typ: HWND

Ein Handle für das Fenster, das die flache Bildlaufleiste enthält. Dieses Fensterhandle muss zuvor in einem Aufruf von InitializeFlatSB übergeben worden sein.

index

Typ: UINT

Bestimmt, was newValue darstellt und welche Eigenschaft festgelegt wird. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
WSB_PROP_CXHSCROLL	newValue ist ein INT_PTR Wert, der die Breite der Richtungsschaltflächen in einer horizontalen Bildlaufleiste in Pixel darstellt.
WSB_PROP_CXHTHUMB	newValue ist ein INT_PTR Wert, der die Breite des Daumens in Pixel in einer horizontalen Bildlaufleiste darstellt.
WSB_PROP_CXVSCROLL	newValue ist ein INT_PTR Wert, der die Breite der vertikalen Bildlaufleiste in Pixel darstellt.
WSB_PROP_CYHSCROLL	newValue ist ein INT_PTR Wert, der die Höhe der horizontalen Bildlaufleiste in Pixel darstellt.
WSB_PROP_CYVSCROLL	newValue ist ein INT_PTR Wert, der die Höhe der Richtungsschaltflächen in einer vertikalen Bildlaufleiste in Pixel darstellt.
WSB_PROP_CYVTHUMB	newValue ist ein INT_PTR Wert, der die Höhe des Daumens in Pixel in einer vertikalen Bildlaufleiste darstellt.
WSB_PROP_HBKGCOLOR	newValue ist ein COLORREF-Wert , der die Hintergrundfarbe in einer horizontalen Bildlaufleiste darstellt.
WSB_PROP_HSTYLE	newValue ist einer der folgenden Werte, der die visuellen Effekte für die horizontale Bildlaufleiste ändert. FSB_ENCARTA_MODE Eine standardmäßige flache Scrollleiste wird angezeigt. Wenn die Maus über eine Richtungstaste oder den Daumen bewegt, wird dieser Teil der Scrollleiste in 3D angezeigt. FSB_FLAT_MODE Eine standardmäßige flache Scrollleiste wird angezeigt. Wenn die Maus über eine Richtungsschaltfläche oder den Daumen bewegt wird, wird dieser Teil der Bildlaufleiste in invertierten Farben angezeigt. FSB_REGULAR_MODE Es wird eine normale, nicht aufgeblähte Bildlaufleiste angezeigt. Es werden keine speziellen visuellen Effekte angewendet.
WSB_PROP_PALETTE	newValue ist ein HPALETTE-Wert , der die neue Palette darstellt, die die Bildlaufleiste beim Zeichnen verwenden soll.
WSB_PROP_VBKGCOLOR	newValue ist ein COLORREF-Wert , der die Hintergrundfarbe in einer vertikalen Bildlaufleiste darstellt.
WSB_PROP_VSTYLE	newValue ist einer der folgenden Werte, der die visuellen Effekte für die vertikale Bildlaufleiste ändert: FSB_ENCARTA_MODE Eine standardmäßige flache Scrollleiste wird angezeigt. Wenn die Maus über eine Richtungstaste oder den Daumen bewegt, wird dieser Teil der Scrollleiste in 3D angezeigt. FSB_FLAT_MODE Eine standardmäßige flache Scrollleiste wird angezeigt. Wenn die Maus über eine Richtungsschaltfläche oder den Daumen bewegt wird, wird dieser Teil der Bildlaufleiste in invertierten Farben angezeigt. FSB_REGULAR_MODE Es wird eine normale, nicht aufgeblähte Bildlaufleiste angezeigt. Es werden keine speziellen visuellen Effekte angewendet.

newValue

Typ: INT_PTR

Ein neuer Wert, der festgelegt werden soll. Dieser Parameter hängt von dem im Index übergebenen Flag ab.

unnamedParam4

Typ: BOOL

Gibt an, ob die Bildlaufleiste sofort neu gezeichnet werden soll, um die Änderung widerzuspiegeln. Wenn dieser Parameter TRUE ist, wird die Bildlaufleiste neu gezeichnet. wenn sie FALSE ist, wird die Bildlaufleiste nicht neu gezeichnet.

Rückgabewert

Typ: BOOL

Gibt bei erfolgreicher Ausführung nonzero zurück, oder andernfalls null.

Hinweise

Hinweis Flache Scrollleistenfunktionen werden in Comctl32.dll Versionen 4.71 bis 5.82 implementiert. Comctl32.dll Versionen 6.00 und höher unterstützen keine flachen Bildlaufleisten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	commctrl.h
Bibliothek	Comctl32.lib
DLL	Comctl32.dll (Version 4.71 oder höher)

Freigeben über