GetScrollRange-Funktion (winuser.h)

Artikel
08/27/2023

Die GetScrollRange-Funktion ruft die aktuellen minimalen und maximalen Bildlauffeldpositionen (Thumb) für die angegebene Bildlaufleiste ab.

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

Syntax

BOOL GetScrollRange(
  [in]  HWND  hWnd,
  [in]  int   nBar,
  [out] LPINT lpMinPos,
  [out] LPINT lpMaxPos
);

Parameter

[in] hWnd

Typ: HWND

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

[in] nBar

Typ: int

Gibt die Bildlaufleiste an, von der die Positionen abgerufen werden. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
SB_CTL	Ruft die Positionen eines Bildlaufleisten-Steuerelements ab. Der hWnd-Parameter muss das Handle für das Bildlaufleisten-Steuerelement sein.
SB_HORZ	Ruft die Positionen der standardmäßigen horizontalen Bildlaufleiste des Fensters ab.
SB_VERT	Ruft die Positionen der standardmäßigen vertikalen Bildlaufleiste des Fensters ab.

[out] lpMinPos

Typ: LPINT

Zeiger auf die ganzzahlige Variable, die die Mindestposition empfängt.

[out] lpMaxPos

Typ: LPINT

Zeiger auf die ganzzahlige Variable, die die maximale Position empfängt.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn das angegebene Fenster keine Standardlaufleisten enthält oder kein Bildlaufleisten-Steuerelement ist, kopiert die GetScrollRange-Funktion null in die Parameter lpMinPos und lpMaxPos .

Der Standardbereich für eine Standardlaufleiste beträgt 0 bis 100. Der Standardbereich für ein Bildlaufleistensteuerelement ist leer (beide Werte sind null).

Die Meldungen, die die Position der Bildlaufleiste angeben, WM_HSCROLL und WM_VSCROLL, sind auf 16 Bits an Positionsdaten beschränkt. Da SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPos und GetScrollRange jedoch 32-Bit-Bildlaufleistenpositionsdaten unterstützen, gibt es eine Möglichkeit, die 16-Bit-Barriere der WM_HSCROLL - und WM_VSCROLL-Nachrichten zu umgehen. Eine Beschreibung der Technik finden Sie in der GetScrollInfo-Funktion .

Wenn der nBar-Parameter SB_CTL ist und das vom hWnd-Parameter angegebene Fenster kein Systemlaufleistensteuerelement ist, sendet das System die SBM_GETRANGE Meldung an das Fenster, um Informationen zur Bildlaufleiste abzurufen. Dadurch kann GetScrollRange mit einem benutzerdefinierten Steuerelement arbeiten, das eine Bildlaufleiste imitiert. Wenn das Fenster die SBM_GETRANGE Meldung nicht verarbeitet, schlägt die GetScrollRange-Funktion fehl.

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 (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll