SetScrollRange

Die Funktion SetScrollRange setzt die minimale und maximale Positionswerte für die angegebenen Bildlaufleiste.

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

 BOOL SetScrollRange) HWND  hWnd, / / handle zum Fenster mit BildlaufleisteintnBar, / / scroll bar FlaggeintnMinPos, / / mindestens Scrollen StellungintnMaxPos, / / maximale Position ScrollenBOOLbRedraw / / redraw Flag);
 

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 festgelegt werden. Dieser Parameter kann eine der folgenden Werte sein:
Wert Bedeutung
SB_CTL Den Bereich eines Bildlaufleisten-Steuerelements festgelegt. Der hWnd -Parameter muss das Handle für das ScrollBar-Steuerelement sein.
SB_HORZ Legt den Bereich der Norm horizontalen Bildlaufleiste des Fensters.
SB_VERT Legt den Bereich der Norm vertikalen Bildlaufleiste eines Fensters.

nMinPos
Gibt die minimale Position Scrollen.
nMaxPos
Gibt die maximale Position Scrollen.
bRedraw
Gibt an, ob die Bildlaufleiste neu gezeichnet werden sollten, um die Änderung widerzuspiegeln. Wenn dieser Parameter TRUE ist, wird die Bildlaufleiste neu gezeichnet. Wenn es FALSE ist, wird die Bildlaufleiste nicht neu gezeichnet.

Rückgabewerte

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

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

Bemerkungen

SetScrollRange können Sie die Bildlaufleiste von Einstellung nMinPos und nMaxPos auf den gleichen Wert ausblenden. Eine Anwendung sollte nicht die SetScrollRange -Funktion, um ein Scroll-Balken ausblenden beim Verarbeiten einer Nachricht Scroll Bar aufrufen. Neue Anwendungen sollten die ShowScrollBar -Funktion verwenden, um die Bildlaufleiste auszublenden.

Wenn der Aufruf von SetScrollRange einen Aufruf der Funktion SetScrollPos unmittelbar folgt, muss der bRedraw Parameter in SetScrollPos 0 (null), um zu verhindern, dass die Bildlaufleiste wird zweimal gezeichnet sein.

Der Standardbereich für eine standard-Bildlaufleisten-Bar liegt zwischen 0 und 100. Der Standardbereich für ein Bildlaufleisten-Steuerelement leer ist (die nMinPos und nMaxPos Parameter-Werte sind 0 (null)). Der Unterschied zwischen den Werten, die durch die Parameter nMinPos und nMaxPos darf nicht größer als der Wert der MAXLONG sein.

Da die Nachrichten, die angeben, Bar Bildlaufposition, WM_HSCROLL und WM_VSCROLL, 16 Bits der Positionsdaten beschränkt sind, haben Anwendungen, die ausschließlich auf diese Nachrichten für Positionsdaten verlassen einen praktischen maximalen Wert von 65.535 für die SetScrollRange -Funktion nMaxPos parameter.

Jedoch, da die SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPosund GetScrollRange Funktionen 32-Bit-Scroll Bar Positionsdaten unterstützen, gibt es eine Möglichkeit, die 16-Bit-Barriere die WM_HSCROLL und WM_VSCROLL-Meldungen zu umgehen. Eine Beschreibung der Technik finden Sie unter GetScrollInfo.

QuickInfo

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

Siehe auch

Übersicht über die Bildlaufleisten, Scroll Bar Funktionen, GetScrollInfo, GetScrollPos, GetScrollRange, SetScrollInfo, SetScrollPos, ShowScrollBar

Index