GetScrollPos

Die GetScrollPos -Funktion Ruft die aktuelle Position des Bildlauffelds (Daumen) auf die angegebene Bildlaufleiste. Die aktuelle Position ist ein relativer Wert, der den Bildlauf Strombereich abhängt. Beispielsweise wird wenn scrollende Bereich liegt zwischen 0 und 100 und das Bildlauffeld mitten in der Bar ist, die aktuelle Position 50.

Die GetScrollPos -Funktion wird aus Kompatibilitätsgründen bereitgestellt. Neue Anwendungen sollten die GetScrollInfo -Funktion verwenden.

Int GetScrollPos) HWND  hWnd, / / handle zum Fenster mit BildlaufleisteintnBar / / scroll bar Flaggen);
 

Parameter

hWnd

Handle für ein ScrollBar-Steuerelement oder ein Fenster mit einer standard-Bildlaufleiste, abhängig vom Wert des Parameters nBar.

nBar

Gibt die Bildlaufleiste geprüft werden. Dieser Parameter kann eine der folgenden Werte sein:

Wert	Bedeutung
SB_CTL	Ruft die Position des Bildlauf-Felds in einem Bildlaufleisten-Steuerelement. Der hWnd -Parameter muss das Handle für das ScrollBar-Steuerelement sein.
SB_HORZ	Ruft die Position des Bildlauffelds auf standard horizontalen Bildlaufleiste eines Fensters.
SB_VERT	Ruft die Position des Bildlauffelds auf standard vertikalen Bildlaufleiste eines Fensters.

Rückgabewerte

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die aktuelle Position des Bildlauffelds.

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (null). Rufen Sie Fehlerinformationen verlängert bekommen, GetLastError.

Bemerkungen

Die GetScrollPos -Funktion ermöglicht Anwendungen, verwenden Sie 32-Bit-Scroll-Positionen. Obwohl die Nachrichten, die Bildlaufleiste anzeigen positionieren, WM_HSCROLL und WM_VSCROLL, sind begrenzt auf 16 Bits der Positionsdaten, die Funktionen SetScrollPos, SetScrollRange, GetScrollPosund GetScrollRange unterstützen 32-Bit-Scroll Bar Positionsdaten. Daher kann eine Anwendung aufrufen GetScrollPos während der Verarbeitung der WM_HSCROLL oder WM_VSCROLL Nachrichten zu 32-Bit-Scroll Bar Positionsdaten.

Verwenden Sie die 32-Bit-Position über dem Bildlauffeld (Ziehpunkt) während eine SB_THUMBTRACK-Benachrichtigung in einer WM_HSCROLL oder WM_VSCROLL Nachricht bekommen, die GetScrollInfo -Funktion.

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Nicht unterstützt.
Header:In winuser.h deklarierten.
Importieren Bibliothek:Verwenden Sie user32.lib.

Siehe auch

Übersicht über die Bildlaufleisten, Scroll Bar Funktionen, GetScrollInfo, GetScrollRange, SetScrollInfo, SetScrollPos, SetScrollRange, WM_HSCROLL, WM_VSCROLL

Index