ItemsStackPanel.ItemsUpdatingScrollMode Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Ruft einen Wert ab, der das Scrollverhalten angibt, wenn ItemsSource aktualisiert wird, oder legt diesen fest.

public:
 property ItemsUpdatingScrollMode ItemsUpdatingScrollMode { ItemsUpdatingScrollMode get(); void set(ItemsUpdatingScrollMode value); };

ItemsUpdatingScrollMode ItemsUpdatingScrollMode();

void ItemsUpdatingScrollMode(ItemsUpdatingScrollMode value);

public ItemsUpdatingScrollMode ItemsUpdatingScrollMode { get; set; }

var itemsUpdatingScrollMode = itemsStackPanel.itemsUpdatingScrollMode;
itemsStackPanel.itemsUpdatingScrollMode = itemsUpdatingScrollMode;

Public Property ItemsUpdatingScrollMode As ItemsUpdatingScrollMode

<ItemsStackPanel ItemsUpdatingScrollMode="itemsUpdatingScrollModeMemberName" />

Eigenschaftswert

ItemsUpdatingScrollMode

Ein Wert aus der Enumeration. Der Standardwert ist KeepItemsInView.

Hinweise

Diese Eigenschaft steuert, wie ItemsStackPanel reagiert, wenn der Benutzer die Elemente scrollt und der ItemsSource neue Elemente hinzugefügt werden.

Wenn ein Benutzer z. B. eine Liste mit E-Mails nach unten scrollt und die ItemsSource aktualisiert wird, fügen Sie oben in der Liste eine neue E-Mail hinzu:

• Wenn ItemsUpdatingScrollMode KeepItemsInView ist, wird der Bildlaufoffset so angepasst, dass das erste sichtbare Element oben in der Ansicht angezeigt wird.
• Wenn ItemsUpdatingScrollMode KeepScrollOffset ist, wird der Bildlaufoffset relativ zum Anfang der Liste beibehalten. Infolgedessen werden die Elemente auf dem Bildschirm nach unten gedrückt, um das neue Element zu berücksichtigen, das oben hinzugefügt wurde.

In anderen Fällen, z. B. in einer Chat-App, werden Elemente am Ende der Liste hinzugefügt. In diesem Fall können Sie ItemsUpdatingScrollMode auf KeepLastItemInView festlegen. Dadurch wird der Bildlaufoffset so angepasst, dass das letzte sichtbare Element am unteren Rand der Ansicht angezeigt wird. (KeepLastItemInView ist ab Windows 10 Version 1607 verfügbar.)

Tipp

In Windows 8 verwendet das ListView-SteuerelementVirtualizingStackPanel als ItemsPanel-Standard. In Windows 8.1 verwendet das ListView-SteuerelementItemsStackPanel als ItemsPanel-Standard. Legen Sie beim Aktualisieren einer ListView in einer Windows 8-App auf die Verwendung von ItemsStackPanel die ItemsUpdatingScrollMode-Eigenschaft auf KeepScrollOffset fest, wenn Sie das Verhalten des Windows 8 ListView beibehalten müssen.