SetScrollInfo

Die Funktion SetScrollInfo setzt die Parameter für eine Bildlaufleiste, einschließlich dem Minimum und Maximum Scrollen Positionen, die Größe und die Position von dem Bildlauffeld (Ziehpunkt) an. Die Funktion zeichnet auch die Schriftrolle-Bar, auf Wunsch.

Int SetScrollInfo) HWND  Hwnd, / / handle zum Fenster mit BildlaufleisteintfnBar, / / scroll bar FlaggeLPSCROLLINFOlpsi,  / / Zeiger auf die Struktur mit Scroll-ParameterBOOLfRedraw / / redraw Flag);
 

Parameter

hwnd
Handle für ein ScrollBar-Steuerelement oder ein Fenster mit einer standard-Bildlaufleiste, abhängig vom Wert des Parameters fnBar.
fnBar
Gibt den Typ der Bildlaufleiste für den Parameter festgelegt. Dieser Parameter kann eine der folgenden Werte sein:
Wert Bedeutung
SB_CTL Setzt die Parameter eines Bildlaufleisten-Steuerelements. Der Hwnd -Parameter muss das Handle für das ScrollBar-Steuerelement sein.
SB_HORZ Setzt die Parameter des angegebenen Fensters standard horizontalen Bildlaufleiste.
SB_VERT Setzt die Parameter des angegebenen Fensters standard vertikalen Bildlaufleiste.

lpsi
Zeiger auf eine Struktur SCROLLINFO . Vor dem Aufruf von SetScrollInfo, den CbSize -Member der Struktur auf Sizeof(SCROLLINFO), den fMask -Member an die Parameter fest, und geben Sie die neuen Parameterwerte in die entsprechenden Member.

Der fMask -Member kann eine Kombination der folgenden Werte sein.:
Wert Bedeutung
SIF_DISABLENOSCROLL Deaktiviert die Bildlaufleiste statt entfernen, wenn die Bildlaufleiste neue Parameter die Bildlaufleiste überflüssig machen.
SIF_PAGE Die Scroll-Seite festgelegt in das nPage -Mitglied der SCROLLINFO -Struktur, auf die Lpsi angegebenen Wert.
SIF_POS Legt den Wert in der gemeinnützigen Organisationen Mitglied der SCROLLINFO -Struktur, die auf Lpsi verweist die Bildlaufposition fest.
SIF_RANGE Setzt den Scroll-Bereich auf den Wert gemäß der nMin und nMax Mitglieder der SCROLLINFO -Struktur, auf die Lpsi.

fRedraw
Gibt an, ob die Bildlaufleiste neu gezeichnet wird, um die Änderungen auf die Bildlaufleiste. Wenn dieser Parameter auf true festgelegt ist, die Bildlaufleiste wird neu gezeichnet, andernfalls es wird nicht neu gezeichnet.

Rückgabewerte

Der Rückgabewert ist die aktuelle Position des Bildlauffelds.

Bemerkungen

Die SetScrollInfo -Funktion führt Bereichsprüfung auf die angegebenen Werte von den nPage und gemeinnützigen Organisationen Mitglieder der SCROLLINFO -Struktur. Das nPage -Element muss einen Wert zwischen 0 und nMax - nMin + 1 angeben. Das gemeinnützigen Organisationen Mitglied muss einen Wert zwischen nMin und nMax - max(nPage -1, 0) angeben. Wenn entweder Wert außerhalb seiner Reichweite ist, legt die Funktion es auf einen Wert, der nur innerhalb des Bereichs liegt.

Windows CE: In Windows CE 2.0 Wenn wird Sie einen null-Zeiger im Lpsi -Parameter übergeben SetScrollInfo 0 (null), anstatt die aktuelle Position des Bildlauffelds.

QuickInfo

&Nbsp; Windows NT: Version 3.51 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Version 1.0 oder höher benötigt.
Header:In winuser.h deklarierten.
Importieren Bibliothek:Verwenden Sie user32.lib.

Siehe auch

Übersicht über die Bildlaufleisten, Scroll Bar Funktionen, GetScrollInfo, SCROLLINFO