SBM_GETSCROLLINFO Nachricht
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 seine WindowProc-Funktion . Anwendungen, die ein benutzerdefiniertes Bildlaufleistensteuerelement implementieren, müssen auf diese Nachrichten reagieren, damit die GetScrollInfo-Funktion ordnungsgemäß funktioniert.
Parameter
-
wParam
-
Dieser Parameter wird nicht verwendet.
-
lParam
-
Zeiger auf eine SCROLLINFO-Struktur . Legen Sie vor dem Aufrufen von GetScrollInfo den cbSize-Member der Struktur auf sizeof(SCROLLINFO) fest, und legen Sie das fMask-Element fest, um die abzurufenden Bildlaufleistenparameter anzugeben. Vor der Rückgabe kopiert die Nachricht die angegebenen Parameter in die entsprechenden Member der -Struktur.
Der fMask-Member kann mindestens einer der folgenden Werte sein.
Wert Bedeutung - SIF_ALL
Kombination aus SIF_PAGE, SIF_POS, SIF_RANGE und SIF_TRACKPOS. - SIF_PAGE
Kopiert die Bildlaufseite in das nPage-Element. - SIF_POS
Kopiert die Bildlaufposition in das nPos-Element. - SIF_RANGE
Kopiert den Bildlaufbereich in die Elemente nMin und nMax. - SIF_TRACKPOS
Kopiert die aktuelle Nachverfolgungsposition des Bildlauffelds in das nTrackPos-Element.
Rückgabewert
Wenn die Nachricht Werte abgerufen hat, ist der Rückgabewert TRUE; Andernfalls ist es FALSE.
Bemerkungen
Die Meldungen, die die Position der Bildlaufleiste angeben, WM_HSCROLL und WM_VSCROLL, stellen nur 16 Bits von Positionsdaten bereit. Die von SBM_GETSCROLLINFO, SBM_SETSCROLLINFO, GetScrollInfo und SetScrollInfo verwendete SCROLLINFO-Struktur stellt jedoch 32 Bits von Bildlaufleistenpositionsdaten bereit. Sie können diese Meldungen und Funktionen verwenden, während Sie entweder die WM_HSCROLL oder WM_VSCROLL Nachrichten verarbeiten, um 32-Bit-Bildlaufleistenpositionsdaten zu erhalten.
Um die 32-Bit-Position des Bildlauffelds (Thumb) während eines SB_THUMBTRACK Anforderungscodes in einer WM_HSCROLL - oder WM_VSCROLL-Nachricht abzurufen, senden Sie SBM_GETSCROLLINFO mit dem wert SIF_TRACKPOS im fMask-Element der SCROLLINFO-Struktur . Die Meldung gibt die Nachverfolgungsposition des Bildlauffelds im nTrackPos-Element der SCROLLINFO-Struktur zurück. Dadurch können Sie die Position des Bildlauffelds abrufen, während der Benutzer es bewegt. Alternativ können Sie die GetScrollInfo-Funktion verwenden, um die gleichen Informationen abzurufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
| Header |
|