Freigeben über


Bildlaufleiste

Dieser Abschnitt enthält Informationen zu den Programmierelementen, die mit Bildlaufleisten verwendet werden. Ein Fenster kann ein Datenobjekt wie ein Dokument oder eine Bitmap anzeigen, das größer als der Clientbereich des Fensters ist. Wenn er mit einer Bildlaufleiste bereitgestellt wird, kann der Benutzer ein Datenobjekt im Clientbereich scrollen, um die Teile des Objekts anzuzeigen, die über die Grenzen des Fensters hinausgehen.

Übersichten

Thema Inhalte
Informationen zu Bildlaufleisten Eine Scrollleiste besteht aus einer schattierten Welle mit einer Pfeilschaltfläche an jedem Ende und einem Scrollfeld (manchmal auch als Daumen bezeichnet) zwischen den Pfeiltasten.
Verwenden von Bildlaufleisten Beim Erstellen eines überlappenden, Popup- oder untergeordneten Fensters können Sie Standard-Bildlaufleisten hinzufügen, indem Sie die CreateWindowEx-Funktion verwenden und WS_HSCROLL, WS_VSCROLL oder beide Formatvorlagen angeben.

Functions

Thema Inhalte
EnableScrollBar Die EnableScrollBar-Funktion aktiviert oder deaktiviert einen oder beide Scrollleistenpfeile.
GetScrollBarInfo Die GetScrollBarInfo-Funktion ruft Informationen zur angegebenen Bildlaufleiste ab.
GetScrollInfo Die GetScrollInfo-Funktion ruft die Parameter einer Bildlaufleiste ab, einschließlich der minimalen und maximalen Bildlaufposition, der Seitengröße und der Position des Scrollfelds (Daumen).
GetScrollPos Die GetScrollPos-Funktion ruft die aktuelle Position des Bildlauffelds (Thumb) in der angegebenen Bildlaufleiste ab. Die aktuelle Position ist ein relativer Wert, der vom aktuellen Bildlaufbereich abhängt. Wenn der Bildlaufbereich beispielsweise 0 bis 100 ist und sich das Bildlauffeld in der Mitte des Balkens befindet, ist die aktuelle Position 50. Hinweis: 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 Bildlauffeldpositionen (Thumb) für die angegebene Bildlaufleiste ab. Hinweis: Die GetScrollRange-Funktion wird nur aus Gründen der Kompatibilität bereitgestellt. Neue Anwendungen sollten die GetScrollInfo-Funktion verwenden.
ScrollDC Die ScrollDC-Funktion scrollt horizontal und vertikal ein Rechteck von Bits.
ScrollWindow Die ScrollWindow-Funktion scrollt den Inhalt des Clientbereichs des angegebenen Fensters. Hinweis: Die ScrollWindow-Funktion wird aus Gründen der Abwärtskompatibilität bereitgestellt. Neue Anwendungen sollten die ScrollWindowEx-Funktion verwenden.
ScrollWindowEx Die ScrollWindowEx-Funktion scrollt den Inhalt des Clientbereichs des angegebenen Fensters.
SetScrollInfo 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.
SetScrollPos Die SetScrollPos-Funktion legt die Position des Bildlauffelds (Thumb) in der angegebenen Bildlaufleiste fest und schränkt die Bildlaufleiste bei Bedarf neu, um die neue Position des Scrollfelds widerzuspiegeln. Hinweis: 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 Bildlaufleiste fest. Hinweis: 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 Bildlaufleiste an oder blendet sie aus.

Nachrichten

Thema Inhalte
SBM_ENABLE_ARROWS Eine Anwendung sendet die SBM_ENABLE_ARROWS-Nachricht , um einen oder beide Pfeile eines Bildlaufleistensteuerelements zu aktivieren oder zu deaktivieren.
SBM_GETPOS Die SBM_GETPOS Nachricht wird gesendet, um die aktuelle Position des Bildlauffelds eines Bildlaufleistensteuerelements abzurufen. Die aktuelle Position ist ein relativer Wert, der vom aktuellen Bildlaufbereich abhängt. Wenn der Bildlaufbereich beispielsweise 0 bis 100 ist und sich das Bildlauffeld in der Mitte des Balkens 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 Meldung über die WindowProc-Funktion. Anwendungen, die ein benutzerdefiniertes Scrollleistensteuerelement implementieren, müssen auf diese Meldungen reagieren, damit die GetScrollPos-Funktion ordnungsgemäß funktioniert.
SBM_GETRANGE Die SBM_GETRANGE Nachricht wird gesendet, um die Mindest- und Höchstpositionswerte für das Scrollleistensteuerelement abzurufen.
Anwendungen sollten diese Nachricht nicht direkt senden. Stattdessen sollten sie die GetScrollRange-Funktion verwenden. Ein Fenster empfängt diese Meldung über die WindowProc-Funktion. Anwendungen, die ein benutzerdefiniertes Scrollleistensteuerelement implementieren, müssen auf diese Meldungen reagieren, damit die GetScrollRange-Funktion ordnungsgemäß funktioniert.
SBM_GETSCROLLBARINFO Wird von einer Anwendung gesendet, um Informationen zur angegebenen Bildlaufleiste abzurufen.
SBM_GETSCROLLINFO Die SBM_GETSCROLLINFO Nachricht wird gesendet, um die Parameter einer Bildlaufleiste abzurufen.
Anwendungen sollten diese Nachricht nicht direkt senden. Stattdessen sollten sie die GetScrollInfo-Funktion verwenden. Ein Fenster empfängt diese Meldung über die WindowProc-Funktion. Anwendungen, die ein benutzerdefiniertes Scrollleistensteuerelement 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 (Daumen) festzulegen, und bei Bedarf die Bildlaufleiste neu zu zeichnen, um die neue Position des Scrollfelds widerzuspiegeln.
Anwendungen sollten diese Nachricht nicht direkt senden. Stattdessen sollten sie die SetScrollPos-Funktion verwenden. Ein Fenster empfängt diese Meldung über die WindowProc-Funktion. Anwendungen, die ein benutzerdefiniertes Scrollleistensteuerelement implementieren, müssen auf diese Meldungen reagieren, damit die SetScrollPos-Funktion ordnungsgemäß funktioniert.
SBM_SETRANGE Die SBM_SETRANGE Nachricht wird gesendet, um die Mindest- und Höchstpositionswerte für das Scrollleistensteuerelement festzulegen.
Anwendungen sollten diese Nachricht nicht direkt senden. Stattdessen sollten sie die SetScrollRange-Funktion verwenden. Ein Fenster empfängt diese Meldung über die WindowProc-Funktion. Anwendungen, die ein benutzerdefiniertes Scrollleistensteuerelement implementieren, müssen auf diese Meldungen reagieren, damit die SetScrollRange-Funktion ordnungsgemäß funktioniert.
SBM_SETRANGEREDRAW Eine Anwendung sendet die SBM_SETRANGEREDRAW Nachricht an ein Bildlaufleistensteuerelement, um die minimalen und maximalen Positionswerte festzulegen und das Steuerelement neu zu zeichnen.
SBM_SETSCROLLINFO Die SBM_SETSCROLLINFO Nachricht wird gesendet, um die Parameter einer Bildlaufleiste festzulegen.
Anwendungen sollten diese Nachricht nicht direkt senden. Stattdessen sollten sie die SetScrollInfo-Funktion verwenden. Ein Fenster empfängt diese Meldung über die WindowProc-Funktion. Anwendungen, die ein benutzerdefiniertes Scrollleistensteuerelement 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 Bildlaufleistensteuerelements gesendet, wenn das Steuerelement gezeichnet werden soll. Wenn sie auf diese Meldung reagieren, kann das übergeordnete Fenster das Anzeigekontexthandle verwenden, um die Hintergrundfarbe des Bildlaufleistensteuerelements festzulegen.
Ein Fenster empfängt diese Meldung über die WindowProc-Funktion.
WM_HSCROLL Die WM_HSCROLL Nachricht wird an ein Fenster gesendet, wenn ein Bildlaufereignis in der horizontalen Standardlaufleiste des Fensters auftritt. Diese Nachricht wird auch an den Besitzer eines horizontalen Bildlaufleistensteuerelements gesendet, wenn im Steuerelement ein Bildlaufereignis auftritt.
Ein Fenster empfängt diese Meldung über die WindowProc-Funktion.
WM_VSCROLL Die WM_VSCROLL Nachricht wird an ein Fenster gesendet, wenn ein Bildlaufereignis in der vertikalen Standardlaufleiste des Fensters auftritt. Diese Nachricht wird auch an den Besitzer eines vertikalen Bildlaufleistensteuerelements gesendet, wenn im Steuerelement ein Bildlaufereignis auftritt.
Ein Fenster empfängt diese Meldung über die WindowProc-Funktion.

Strukturen

Thema Inhalte
SCROLLBARINFO Die SCROLLBARINFO-Struktur enthält Bildlaufleisteninformationen.
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 Bildlaufleistensteuerelement mit der Funktion CreateWindow oder CreateWindowEx zu erstellen, geben Sie die SCROLLBAR-Klasse, die entsprechenden Fensterformatkonstanten und eine Kombination aus den folgenden Bildlaufleistensteuerelementstilen an. Einige Der Stile erstellen ein Bildlaufleistensteuerelement, das eine Standardbreite oder -höhe verwendet. Sie müssen jedoch immer die x- und y-Koordinaten und die anderen Dimensionen der Bildlaufleiste angeben, wenn Sie CreateWindow oder CreateWindowEx aufrufen.