ItemsStackPanel.ItemsUpdatingScrollMode Properti

Definisi

Ruang nama:

Microsoft.UI.Xaml.Controls

Mendapatkan atau menetapkan nilai yang menentukan perilaku pengguliran saat ItemsSource diperbarui.

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

Nilai Properti

ItemsUpdatingScrollMode

Nilai enumerasi. Defaultnya adalah KeepItemsInView.

Keterangan

Properti ini mengontrol bagaimana ItemsStackPanel merespons ketika pengguna telah menggulir item, dan item baru ditambahkan ke ItemsSource.

Misalnya, jika pengguna menggulir daftar email ke bawah, dan itemSource diperbarui, menambahkan email baru ke bagian atas daftar:

• Jika ItemsUpdatingScrollMode adalah KeepItemsInView, maka offset gulir disesuaikan untuk mempertahankan item pertama yang terlihat yang ditampilkan di bagian atas tampilan.
• Jika ItemUpdatingScrollMode adalah KeepScrollOffset, maka offset gulir relatif terhadap bagian atas daftar dipertahankan. Akibatnya, item di layar didorong ke bawah untuk memperkirakan item baru yang ditambahkan di bagian atas.

Dalam kasus lain, seperti di aplikasi obrolan, item ditambahkan ke bagian bawah daftar. Dalam hal ini, Anda dapat mengatur ItemsUpdatingScrollMode ke KeepLastItemInView. Ini menyesuaikan offset gulir untuk mempertahankan item terakhir yang terlihat ditampilkan di bagian bawah tampilan. (KeepLastItemInView tersedia dimulai dengan Windows 10, versi 1607.)

Tip

Dalam Windows 8, kontrol ListView menggunakan VirtualizingStackPanel sebagai ItemPanel defaultnya; di Windows 8.1, kontrol ListView menggunakan ItemsStackPanel sebagai ItemPanel defaultnya. Saat meningkatkan ListView di aplikasi Windows 8 untuk menggunakan ItemsStackPanel, atur properti ItemsUpdatingScrollMode ke KeepScrollOffset jika Anda perlu menjaga perilaku Windows 8 ListView.