SetScrollInfo-Funktion (winuser.h)

  • Artikel

Die SetScrollInfo-Funktion legt die Parameter einer Scrollleiste fest, einschließlich der minimalen und maximalen Bildlaufposition, der Seitengröße und der Position des Scrollfelds (Daumen). Die Funktion zeichnet die Bildlaufleiste bei Bedarf auch neu.

Syntax

int SetScrollInfo(
  [in] HWND          hwnd,
  [in] int           nBar,
  [in] LPCSCROLLINFO lpsi,
  [in] BOOL          redraw
);

Parameter

[in] hwnd

Typ: HWND

Führen Sie je nach Wert des fnBar-Parameters ein Bildlaufleistensteuerelement oder ein Fenster mit einer Standardlaufleiste durch.

[in] nBar

Typ: int

Gibt den Typ der Bildlaufleiste an, für die Parameter festgelegt werden sollen. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert Bedeutung
SB_CTL
 Legt die Parameter eines Bildlaufleistensteuerelements fest. Der hwnd-Parameter muss das Handle für das Scrollleistensteuerelement sein.
SB_HORZ
 Legt die Parameter der horizontalen Standardlaufleiste des Fensters fest.
SB_VERT
 Legt die Parameter der vertikalen Standardlaufleiste des Fensters fest.

[in] lpsi

Typ: LPCSCROLLINFO

Zeiger auf eine SCROLLINFO-Struktur . Legen Sie vor dem Aufrufen von SetScrollInfo das cbSize-Element der Struktur auf sizeof(SCROLLINFO) fest, legen Sie das fMask-Element fest, um die festzulegenden Parameter anzugeben, und geben Sie die neuen Parameterwerte in den entsprechenden Membern an.

Das fMask-Element kann mindestens einer der folgenden Werte sein.

Wert Bedeutung
SIF_DISABLENOSCROLL
 Deaktiviert die Bildlaufleiste, anstatt sie zu entfernen, wenn die neuen Parameter der Bildlaufleiste die Bildlaufleiste unnötig machen.
SIF_PAGE
 Legt die Bildlaufseite auf den Wert fest, der im nPage-Member der SCROLLINFO-Struktur angegeben ist, auf die von lpsi verwiesen wird.
SIF_POS
 Legt die Bildlaufposition auf den Wert fest, der im nPos-Member der SCROLLINFO-Struktur angegeben ist, auf die von lpsi verwiesen wird.
SIF_RANGE
 Legt den Bildlaufbereich auf den Wert fest, der in den Membern nMin und nMax der SCROLLINFO-Struktur angegeben ist, auf die von lpsi verwiesen wird.

[in] redraw

Typ: BOOL

Gibt an, ob die Bildlaufleiste neu gezeichnet wird, um die Änderungen an der Bildlaufleiste widerzuspiegeln. Wenn dieser Parameter TRUE ist, wird die Bildlaufleiste neu gezeichnet, andernfalls wird sie nicht neu gezeichnet.

Rückgabewert

Typ: int

Der Rückgabewert ist die aktuelle Position des Bildlauffelds.

Hinweise

Die SetScrollInfo-Funktion führt die Bereichsüberprüfung für die Werte durch, die von den nPage - und nPos-Membern der SCROLLINFO-Struktur angegeben werden. Das nPage-Element muss einen Wert von 0 bis nMax - nMin +1 angeben. Das nPos-Element muss einen Wert zwischen nMin und nMax - max( nPage – 1, 0) angeben. Wenn ein Wert außerhalb seines Bereichs liegt, legt die Funktion ihn auf einen Wert fest, der sich nur innerhalb des Bereichs befindet.

Wenn der fnBar-Parameter SB_CTL ist und das vom hwnd-Parameter angegebene Fenster kein Systemlaufleistensteuerelement ist, sendet das System die SBM_SETSCROLLINFO Nachricht an das Fenster, um Bildlaufleisteninformationen festzulegen (Das System kann die Nachricht auf SBM_SETPOS oder SBM_SETRANGE optimieren, wenn die Anforderung nur für die Position oder den Bereich gilt). Dadurch kann SetScrollInfo mit einem benutzerdefinierten Steuerelement arbeiten, das eine Bildlaufleiste imitiert. Wenn das Fenster SBM_SETSCROLLINFO (oder die optimierte SBM_SETPOS Nachricht oder SBM_SETRANGE Nachricht) nicht verarbeitet, schlägt die SetScrollInfo-Funktion fehl.

Ein Beispiel finden Sie unter Scrolling Text mit der WM_PAINT Nachricht.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winuser.h (einschließlich Windows.h)
Bibliothek User32.lib
DLL User32.dll
APIs ext-ms-win-ntuser-misc-l1-2-0 (eingeführt in Windows 8.1)

Weitere Informationen

GetScrollInfo

Referenz

SCROLLINFO