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] |
| GetScrollRange | Die GetScrollRange-Funktion ruft die aktuellen minimalen und maximalen Scrollfeldpositionen (Thumb) für die angegebene Scrollleiste ab.[!Note] |
| 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] |
| 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] |
| SetScrollRange | Die SetScrollRange-Funktion legt die minimalen und maximalen Scrollfeldpositionen für die angegebene Scrollleiste fest.[!Note] |
| 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. |