SetScrollInfo-Funktion (winuser.h)
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.
[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 |
|---|---|
|
Deaktiviert die Bildlaufleiste, anstatt sie zu entfernen, wenn die neuen Parameter der Bildlaufleiste die Bildlaufleiste unnötig machen. |
|
Legt die Bildlaufseite auf den Wert fest, der im nPage-Member der SCROLLINFO-Struktur angegeben ist, auf die von lpsi verwiesen wird. |
|
Legt die Bildlaufposition auf den Wert fest, der im nPos-Member der SCROLLINFO-Struktur angegeben ist, auf die von lpsi verwiesen wird. |
|
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
Referenz