ListView_Scroll Makro (commctrl.h)

Scrollt den Inhalt eines Listenansicht-Steuerelements. Sie können dieses Makro verwenden oder die LVM_SCROLL Nachricht explizit senden.

Syntax

BOOL ListView_Scroll(
   HWND hwndLV,
   int  dx,
   int  dy
);

Parameter

hwndLV

Typ: HWND-

Ein Handle für das Listenansicht-Steuerelement.

dx

Typ: int

Ein Wert vom Typ int, der die Größe des horizontalen Bildlaufs relativ zur aktuellen Position des Listenansichtsinhalts in Pixel angibt. Wenn sich das Listenansicht-Steuerelement in der Listenansicht befindet, wird dieser Wert auf die nächste Anzahl von Pixeln aufgerundet, die eine ganze Spalte bilden.

dy

Typ: int

Ein Wert vom Typ int, der die Größe des vertikalen Bildlaufs relativ zur aktuellen Position des Listenansichtsinhalts in Pixel angibt.

Rückgabewert

Typ: BOOL-

Gibt TRUE zurück, wenn dies erfolgreich ist, oder FALSE andernfalls.

Bemerkungen

Wenn sich das Listenansicht-Steuerelement in der Berichtsansicht befindet, kann das Steuerelement nur vertikal in ganzen Zeilenschritten gescrollt werden. Daher wird der dy-Parameter auf die nächste Anzahl von Pixeln gerundet, die eine ganze Linie inkrementieren. Wenn beispielsweise die Höhe einer Linie 16 Pixel und 8 für dyübergeben wird, wird die Liste um 16 Pixel (1 Zeile) gescrollt. Wenn 7 für dyübergeben wird, wird die Liste um 0 Pixel gescrollt (0 Zeilen).

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2003 [Nur Desktop-Apps]
Zielplattform- Fenster
Header- commctrl.h