Bildlaufleiste

Dieser Abschnitt enthält Informationen zu den Programmierelementen, die mit Bildlaufleisten verwendet werden. In einem Fenster kann ein Datenobjekt angezeigt werden, z. B. ein Dokument oder eine Bitmap, das größer als der Clientbereich des Fensters ist. Wenn eine Bildlaufleiste bereitgestellt wird, kann der Benutzer einen Bildlauf für ein Datenobjekt im Clientbereich durchführen, um die Teile des Objekts anzuzeigen, die über die Rahmen des Fensters hinausgehen.

Übersichten

Thema Inhalte
Informationen zu Scrollleisten Eine Scrollleiste besteht aus einem schattierten Strich mit einer Pfeilschaltfläche an jedem Ende und einem Bildlauffeld (manchmal als Strich bezeichnet) zwischen den Pfeilschaltflächen.
Verwenden von Bildlaufleisten Beim Erstellen eines überlappenden, Popup- oder untergeordneten Fensters können Sie Standardscrollleisten hinzufügen, indem Sie die CreateWindowEx-Funktion verwenden und WS _ HSCROLL, WS _ VSCROLLoder beide Stile angeben.

Functions

Thema Inhalte
EnableScrollBar Die EnableScrollBar-Funktion aktiviert oder deaktiviert einen oder beide Bildlaufleistenpfeile.
GetScrollBarInfo Die GetScrollBarInfo-Funktion ruft Informationen über die angegebene Scrollleiste ab.
GetScrollInfo Die GetScrollInfo-Funktion ruft die Parameter einer Scrollleiste ab, einschließlich der minimalen und maximalen Bildlaufpositionen, der Seitengröße und der Position des Bildlauffelds (Strich).
GetScrollPos Die GetScrollPos-Funktion ruft die aktuelle Position des Bildlauffelds (Strich) in der angegebenen Scrollleiste ab. Die aktuelle Position ist ein relativer Wert, der vom aktuellen Bildlaufbereich abhängt. Wenn der Bildlaufbereich beispielsweise zwischen 0 und 100 liegt und sich das Bildlauffeld in der Mitte der Leiste befindet, ist die aktuelle Position 50.
[!Note]
Die GetScrollPos-Funktion wird aus Gründen der Abwärtskompatibilität bereitgestellt. Neue Anwendungen sollten die GetScrollInfo-Funktion verwenden.


GetScrollRange Die GetScrollRange-Funktion ruft die aktuellen minimalen und maximalen Scrollfeldpositionen (Thumb) für die angegebene Scrollleiste ab.
[!Note]
Die GetScrollRange-Funktion wird nur zur Kompatibilität bereitgestellt. Neue Anwendungen sollten die GetScrollInfo-Funktion verwenden.


ScrollDC Die ScrollDC-Funktion führt einen horizontalen und vertikalen Bildlauf für ein Rechteck aus Bits durch.
ScrollWindow Die ScrollWindow-Funktion führt einen Bildlauf durch den Inhalt des Clientbereichs des angegebenen Fensters durch.
[!Note]
Die ScrollWindow-Funktion wird aus Gründen der Abwärtskompatibilität bereitgestellt. Neue Anwendungen sollten die ScrollWindowEx-Funktion verwenden.


ScrollWindowEx Die ScrollWindowEx-Funktion führt einen Bildlauf durch den Inhalt des Clientbereichs des angegebenen Fensters durch.
SetScrollInfo Die SetScrollInfo-Funktion legt die Parameter einer Bildlaufleiste fest, einschließlich der minimalen und maximalen Bildlaufpositionen, der Seitengröße und der Position des Bildlauffelds (Strich). Die Funktiondrawn auch die Scrollleiste neu, wenn dies angefordert wird.
SetScrollPos Die SetScrollPos-Funktion legt die Position des Bildlauffelds (Thumb) in der angegebenen Scrollleiste fest und zeichnet die Scrollleiste bei Entsprechender entsprechend der neuen Position des Bildlauffelds neu.
[!Note]
Die SetScrollPos-Funktion wird aus Gründen der Abwärtskompatibilität bereitgestellt. Neue Anwendungen sollten die SetScrollInfo-Funktion verwenden.


SetScrollRange Die SetScrollRange-Funktion legt die minimalen und maximalen Scrollfeldpositionen für die angegebene Scrollleiste fest.
[!Note]
Die SetScrollRange-Funktion wird aus Gründen der Abwärtskompatibilität bereitgestellt. Neue Anwendungen sollten die SetScrollInfo-Funktion verwenden.


ShowScrollBar Die ShowScrollBar-Funktion zeigt die angegebene Scrollleiste an oder blendet sie aus.

Nachrichten

Thema Inhalte
SBM _ ENABLE _ ARROWS Eine Anwendung sendet die SBM _ ENABLE _ ARROWS-Meldung, um einen oder beide Pfeile eines Bildlaufleisten-Steuerelements zu aktivieren oder zu deaktivieren.
SBM _ GETPOS Die SBM _ GETPOS-Nachricht wird gesendet, um die aktuelle Position des Bildlauffelds eines Bildlaufleisten-Steuerelements abzurufen. Die aktuelle Position ist ein relativer Wert, der vom aktuellen Bildlaufbereich abhängt. Wenn der Bildlaufbereich beispielsweise zwischen 0 und 100 liegt und sich das Bildlauffeld in der Mitte der Leiste befindet, ist die aktuelle Position 50.
Anwendungen sollten diese Nachricht nicht direkt senden. Stattdessen sollten sie die GetScrollPos-Funktion verwenden. Ein Fenster empfängt diese Nachricht über seine WindowProc-Funktion. Anwendungen, die ein benutzerdefiniertes Scrollleisten-Steuerelement implementieren, müssen auf diese Meldungen reagieren, damit die GetScrollPos-Funktion ordnungsgemäß funktioniert.
SBM _ GETRANGE Die SBM _ GETRANGE-Nachricht wird gesendet, um die minimalen und maximalen Positionswerte für das Bildlaufleisten-Steuerelement abzurufen.
Anwendungen sollten diese Nachricht nicht direkt senden. Stattdessen sollten sie die GetScrollRange-Funktion verwenden. Ein Fenster empfängt diese Nachricht über seine WindowProc-Funktion. Anwendungen, die ein benutzerdefiniertes Scrollleisten-Steuerelement implementieren, müssen auf diese Meldungen reagieren, damit die GetScrollRange-Funktion ordnungsgemäß funktioniert.
SBM _ GETSCROLLBARINFO Wird von einer Anwendung gesendet, um Informationen über die angegebene Scrollleiste abzurufen.
SBM _ GETSCROLLINFO Die SBM _ GETSCROLLINFO-Nachricht wird gesendet, um die Parameter einer Scrollleiste abzurufen.
Anwendungen sollten diese Nachricht nicht direkt senden. Stattdessen sollten sie die GetScrollInfo-Funktion verwenden. Ein Fenster empfängt diese Nachricht über seine WindowProc-Funktion. Anwendungen, die ein benutzerdefiniertes Bildlaufleisten-Steuerelement implementieren, müssen auf diese Meldungen reagieren, damit die GetScrollInfo-Funktion ordnungsgemäß funktioniert.
SBM _ SETPOS Die SBM _ SETPOS-Nachricht wird gesendet, um die Position des Bildlauffelds (Strich) und, falls angefordert, die Scrollleiste neu zu zeichnet, um die neue Position des Bildlauffelds widerzuerkennen.
Anwendungen sollten diese Nachricht nicht direkt senden. Stattdessen sollten sie die SetScrollPos-Funktion verwenden. Ein Fenster empfängt diese Nachricht über seine WindowProc-Funktion. Anwendungen, die ein benutzerdefiniertes Scrollleisten-Steuerelement implementieren, müssen auf diese Meldungen reagieren, damit die SetScrollPos-Funktion ordnungsgemäß funktioniert.
SBM _ SETRANGE Die SBM _ SETRANGE-Nachricht wird gesendet, um die minimalen und maximalen Positionswerte für das Bildlaufleisten-Steuerelement zu festlegen.
Anwendungen sollten diese Nachricht nicht direkt senden. Stattdessen sollten sie die SetScrollRange-Funktion verwenden. Ein Fenster empfängt diese Nachricht über seine WindowProc-Funktion. Anwendungen, die ein benutzerdefiniertes Scrollleisten-Steuerelement implementieren, müssen auf diese Meldungen reagieren, damit die SetScrollRange-Funktion ordnungsgemäß funktioniert.
SBM _ SETRANGEREDRAW Eine Anwendung sendet die SBM _ SETRANGEREDRAW-Nachricht an ein Bildlaufleisten-Steuerelement, um die minimalen und maximalen Positionswerte und das Steuerelement neu zu zeichnet.
SBM _ SETSCROLLINFO Die SBM _ SETSCROLLINFO-Nachricht wird gesendet, um die Parameter einer Bildlaufleiste festlegen.
Anwendungen sollten diese Nachricht nicht direkt senden. Stattdessen sollten sie die SetScrollInfo-Funktion verwenden. Ein Fenster empfängt diese Nachricht über seine WindowProc-Funktion. Anwendungen, die ein benutzerdefiniertes Scrollleisten-Steuerelement implementieren, müssen auf diese Meldungen reagieren, damit die SetScrollInfo-Funktion ordnungsgemäß funktioniert.

Benachrichtigungen

Thema Inhalte
WM _ CTLCOLORSCROLLBAR Die WM _ CTLCOLORSCROLLBAR-Nachricht wird an das übergeordnete Fenster eines Bildlaufleisten-Steuerelements gesendet, wenn das Steuerelement gezeichnet werden soll. Durch Reagieren auf diese Meldung kann das übergeordnete Fenster das Anzeigekontexthandle verwenden, um die Hintergrundfarbe des Bildlaufleisten-Steuerelements festzulegen.
Ein Fenster empfängt diese Meldung über seine WindowProc-Funktion.
WM _ HSCROLL Die WM _ HSCROLL-Nachricht wird an ein Fenster gesendet, wenn ein Bildlaufereignis in der standardmäßigen horizontalen Scrollleiste des Fensters auftritt. Diese Meldung wird auch an den Besitzer eines horizontalen Bildlaufleisten-Steuerelements gesendet, wenn ein Bildlaufereignis im -Steuerelement auftritt.
Ein Fenster empfängt diese Meldung über seine WindowProc-Funktion.
WM _ VSCROLL Die _ WM-VSCROLL-Nachricht wird an ein Fenster gesendet, wenn ein Bildlaufereignis in der standardmäßigen vertikalen Bildlaufleiste des Fensters auftritt. Diese Meldung wird auch an den Besitzer eines vertikalen Bildlaufleisten-Steuerelements gesendet, wenn ein Bildlaufereignis im -Steuerelement auftritt.
Ein Fenster empfängt diese Meldung über seine WindowProc-Funktion.

Strukturen

Thema Inhalte
SCROLLBARINFO Die SCROLLBARINFO-Struktur enthält Scrollleisteninformationen.
SCROLLINFO Die SCROLLINFO-Struktur enthält Scrollleistenparameter, die von der SetScrollInfo-Funktion (oder SBM _ SETSCROLLINFO-Nachricht) festgelegt oder von der GetScrollInfo-Funktion (oder SBM _ GETSCROLLINFO-Nachricht) abgerufen werden sollen.

Konstanten

Thema Inhalte
Bildlaufleisten-Steuerelementstile Um ein Bildlaufleisten-Steuerelement mit der CreateWindow- oder CreateWindowEx-Funktion zu erstellen, geben Sie die SCROLLBAR-Klasse, die entsprechenden Fensterformatkonstanten und eine Kombination der folgenden Bildlaufleisten-Steuerelementstile an. Einige der Stile erstellen ein Bildlaufleisten-Steuerelement, das eine Standardbreite oder -höhe verwendet. Sie müssen jedoch immer die x- und y-Koordinaten und die anderen Dimensionen der Scrollleiste angeben, wenn Sie CreateWindow oder CreateWindowEx aufrufen.