Teilen über

Bildlaufleiste

  • Artikel

Dieser Abschnitt enthält Informationen zu den Programmierelementen, die mit Bildlaufleisten verwendet werden. Ein Fenster kann ein Datenobjekt anzeigen, z. B. ein Dokument oder eine Bitmap, die größer als der Clientbereich des Fensters ist. Wenn eine Bildlaufleistebereitgestellt wird, kann der Benutzer ein Datenobjekt im Clientbereich scrollen, um die Teile des Objekts anzuzeigen, die sich über die Rahmen des Fensters erstrecken.

Überblicke

Thema Inhalt
Über Bildlaufleisten Eine Bildlaufleiste besteht aus einer schattierten Welle mit einer Pfeilschaltfläche an jedem Ende und einem Bildlauffeld (manchmal als Daumen bezeichnet) zwischen den Pfeilschaltflächen.
Verwenden von Bildlaufleisten Beim Erstellen eines überlappenden, Popups oder untergeordneten Fensters können Sie Standard-Bildlaufleisten hinzufügen, indem Sie die CreateWindowEx--Funktion verwenden und WS_HSCROLL, WS_VSCROLLoder beide Formatvorlagen angeben.

Funktionen

Thema Inhalt
EnableScrollBar- Die EnableScrollBar--Funktion aktiviert oder deaktiviert einen oder beide Bildlaufleistenpfeile.
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 Bildlaufpositionen, der Seitengröße und der Position des Bildlauffelds (Daumen).
GetScrollPos- Die GetScrollPos-Funktion ruft die aktuelle Position des Bildlauffelds (Daumen) 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 beträgt und sich das Bildlauffeld in der Mitte der Leiste 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 Minimal- und Maximalen Bildlauffeldpositionen (Daumen) für die angegebene Bildlaufleiste ab. Hinweis: Die GetScrollRange-Funktion wird nur aus Kompatibilitätsgründen bereitgestellt. Neue Anwendungen sollten die GetScrollInfo--Funktion verwenden.
ScrollDC- Die ScrollDC- Funktion scrollt horizontal und vertikal in einem Rechteck mit 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 Bildlaufleiste fest, einschließlich der minimalen und maximalen Bildlaufpositionen, der Seitengröße und der Position des Bildlauffelds (Daumen). Bei Bedarf wird auch die Bildlaufleiste von der Funktion neu gezeichnet.
SetScrollPos- Die SetScrollPos--Funktion legt die Position des Bildlauffelds (Daumen) in der angegebenen Bildlaufleiste fest. Bei Bedarf wird die Bildlaufleiste neu gezeichnet, um die neue Position des Bildlauffelds 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 Bildlauffeldpositionen 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 blendet die angegebene Bildlaufleiste ein oder aus.

Meldungen

Thema Inhalt
SBM_ENABLE_ARROWS Eine Anwendung sendet die SBM_ENABLE_ARROWS Nachricht, 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 0 bis 100 beträgt 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 die WindowProc--Funktion. Anwendungen, die ein benutzerdefiniertes Bildlaufleisten-Steuerelement implementieren, müssen auf diese Meldungen reagieren, damit die funktion GetScrollPos ordnungsgemäß funktioniert.
SBM_GETRANGE Die SBM_GETRANGE Nachricht wird gesendet, um die Minimal- und Höchstpositionswerte 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 die WindowProc--Funktion. Anwendungen, die ein benutzerdefiniertes Bildlaufleisten-Steuerelement implementieren, müssen auf diese Meldungen reagieren, damit die GetScrollRange--Funktion ordnungsgemäß funktioniert.
SBM_GETSCROLLBARINFO Gesendet von einer Anwendung zum Abrufen von Informationen über die angegebene Bildlaufleiste.
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 Nachricht über die 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 (Daumen) festzulegen und bei Bedarf die Bildlaufleiste neu zu zeichnen, um die neue Position des Bildlauffelds widerzuspiegeln.
Anwendungen sollten diese Nachricht nicht direkt senden. Stattdessen sollten sie die SetScrollPos--Funktion verwenden. Ein Fenster empfängt diese Nachricht über die WindowProc--Funktion. Anwendungen, die ein benutzerdefiniertes Bildlaufleisten-Steuerelement implementieren, müssen auf diese Meldungen reagieren, damit die SetScrollPos--Funktion ordnungsgemäß funktioniert.
SBM_SETRANGE Die SBM_SETRANGE Nachricht wird gesendet, um die Minimal- und Höchstpositionswerte für das Bildlaufleisten-Steuerelement festzulegen.
Anwendungen sollten diese Nachricht nicht direkt senden. Stattdessen sollten sie die SetScrollRange--Funktion verwenden. Ein Fenster empfängt diese Nachricht über die WindowProc--Funktion. Anwendungen, die ein benutzerdefiniertes Bildlaufleisten-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 Minimal- und Höchstpositionswerte 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 Nachricht über die WindowProc--Funktion. Anwendungen, die ein benutzerdefiniertes Bildlaufleisten-Steuerelement implementieren, müssen auf diese Meldungen reagieren, damit die SetScrollInfo--Funktion ordnungsgemäß funktioniert.

Benachrichtigungen

Thema Inhalt
WM_CTLCOLORSCROLLBAR Die WM_CTLCOLORSCROLLBAR Nachricht wird an das übergeordnete Fenster eines Bildlaufleisten-Steuerelements gesendet, wenn das Steuerelement gezeichnet werden soll. Durch Reaktion auf diese Meldung kann das übergeordnete Fenster das Anzeigekontexthandle verwenden, um die Hintergrundfarbe des Bildlaufleisten-Steuerelements festzulegen.
Ein Fenster empfängt diese Nachricht über die WindowProc--Funktion.
WM_HSCROLL Die WM_HSCROLL Nachricht wird an ein Fenster gesendet, wenn ein Bildlaufereignis in der standardmäßigen horizontalen Bildlaufleiste des Fensters auftritt. Diese Nachricht wird auch an den Besitzer eines horizontalen Bildlaufleisten-Steuerelements gesendet, wenn ein Bildlaufereignis im Steuerelement auftritt.
Ein Fenster empfängt diese Nachricht über die 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 Nachricht wird auch an den Besitzer eines vertikalen Bildlaufleisten-Steuerelements gesendet, wenn ein Bildlaufereignis im Steuerelement auftritt.
Ein Fenster empfängt diese Nachricht über die WindowProc--Funktion.

Strukturen

Thema Inhalt
SCROLLBARINFO- Die SCROLLBARINFO- Struktur enthält Bildlaufleisteninformationen.
SCROLLINFO- Die SCROLLINFO Struktur enthält Bildlaufleistenparameter, die von der SetScrollInfo-Funktion (oder SBM_SETSCROLLINFO Nachricht) festgelegt oder von der GetScrollInfo-Funktion (oder SBM_GETSCROLLINFO Nachricht) abgerufen werden sollen.

Konstanten

Thema Inhalt
Formatvorlagen für Bildlaufleisten-Steuerelemente Zum Erstellen eines Bildlaufleisten-Steuerelements mithilfe der CreateWindow oder CreateWindowEx Funktion geben Sie die SCROLLBAR-Klasse, die entsprechenden Fensterformatkonstanten und eine Kombination der folgenden Bildlaufleisten-Steuerelementarten an. Einige der Formatvorlagen 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 Bildlaufleiste angeben, wenn Sie CreateWindow- oder CreateWindowEx-aufrufen.