FlatSB_SetScrollInfo-Funktion (commctrl.h)

Artikel
02/24/2024

Legt die Informationen für eine flache Bildlaufleiste fest. Wenn flache Bildlaufleisten für das Fenster nicht initialisiert werden, ruft diese Funktion die Standardfunktion SetScrollInfo auf.

Syntax

int FlatSB_SetScrollInfo(
  HWND         unnamedParam1,
  int          code,
  LPSCROLLINFO psi,
  BOOL         fRedraw
);

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.

code

Typ: int

Der Scrollleistentyp. Es kann sich um einen der folgenden Werte handeln:

Wert	Bedeutung
SB_HORZ	Legt die Informationen für die horizontale Bildlaufleiste fest.
SB_VERT	Legt die Informationen für die vertikale Bildlaufleiste fest.

psi

Typ: LPSCROLLINFO

Ein Zeiger auf eine SCROLLINFO-Struktur , die die neuen Informationen für die angegebene Bildlaufleiste enthält. Die elemente cbSize und fMask der Struktur müssen ausgefüllt werden, bevor sie FlatSB_SetScrollInfo aufrufen. Das fMask-Element gibt an, welche Elemente der Struktur gültige Informationen enthalten und eine beliebige Kombination der folgenden Werte sein können:

Wert	Bedeutung
SIF_DISABLENOSCROLL	Deaktiviert die Bildlaufleiste, wenn die neuen Informationen dazu führen würden, dass die Bildlaufleiste entfernt wird.
SIF_PAGE	Legt die Seiteninformationen für die flache Bildlaufleiste fest. Das nPage-Element der SCROLLINFO-Struktur muss den neuen Seitenwert enthalten.
SIF_POS	Legt die Positionsinformationen für die flache Bildlaufleiste fest. Das nPos-Element der SCROLLINFO-Struktur muss den neuen Positionswert enthalten.
SIF_RANGE	Legt die Bereichsinformationen für die flache Bildlaufleiste fest. Die nMin - und nMax-Member der SCROLLINFO-Struktur müssen die neuen Bereichswerte enthalten.
SIF_ALL	Eine Kombination aus SIF_PAGE, SIF_POS und SIF_RANGE.

fRedraw

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: int

Gibt die aktuelle Bildlaufposition zurück. Wenn der Aufruf von FlatSB_SetScrollInfo die Bildlaufposition ändert, wird die vorherige Position zurückgegeben.

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