ItemsStackPanel.ItemsUpdatingScrollMode Свойство

Определение

Пространство имен:

Microsoft.UI.Xaml.Controls

Возвращает или задает значение, указывающее поведение прокрутки при обновлении ItemsSource .

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" />

Значение свойства

ItemsUpdatingScrollMode

Значение перечисления. Значение по умолчанию — KeepItemsInView.

Комментарии

Это свойство определяет, как ItemsStackPanel реагирует, когда пользователь прокручивает элементы и добавляет новые элементы в ItemsSource.

Например, если пользователь прокрутит список сообщений электронной почты вниз, а ItemsSource обновится, добавьте новое сообщение в начало списка:

• Если itemsUpdatingScrollMode имеет значение KeepItemsInView, смещение прокрутки корректируется таким образом, чтобы первый видимый элемент отображался в верхней части представления.
• Если itemsUpdatingScrollMode имеет значение KeepScrollOffset, то смещение прокрутки относительно верхней части списка сохраняется. В результате элементы на экране помещаются вниз, чтобы учесть новый элемент, добавленный в верхней части экрана.

В других случаях, например в приложении чата, элементы добавляются в нижнюю часть списка. В этом случае можно задать для ItemsUpdatingScrollMode значение KeepLastItemInView. Это корректирует смещение прокрутки, чтобы последний видимый элемент отображалось в нижней части представления. (KeepLastItemInView доступен начиная с Windows 10 версии 1607.)

Совет

В Windows 8 элемент управления ListView использует VirtualizingStackPanel в качестве элемента управления ItemsPanel по умолчанию. В Windows 8.1 элемент управления ListView использует ItemsStackPanel по умолчанию. При обновлении ListView в приложении Windows 8 для использования ItemsStackPanel присвойте свойству ItemsUpdatingScrollMode значение KeepScrollOffset, если необходимо сохранить поведение Windows 8 ListView.