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 です。

注釈

このプロパティは、ユーザーがアイテムをスクロールし、新しい項目を ItemsSource に追加したときに ItemsStackPanel がどのように応答するかを制御します。

たとえば、ユーザーがメールの一覧を下にスクロールし、 ItemsSource が 更新された場合、リストの先頭に新しいメールを追加します。

• ItemsUpdatingScrollMode が KeepItemsInView の場合、スクロール オフセットが調整され、最初に表示される項目がビューの上部に表示されます。
• ItemsUpdatingScrollMode が KeepScrollOffset の場合、リストの先頭からの相対スクロール オフセットが維持されます。 その結果、画面上部の項目は、上部に追加された新しい項目を考慮してプッシュダウンされます。

チャット アプリのように、他の場合は、リストの下部に項目が追加されます。 この場合、ItemsUpdatingScrollMode を KeepLastItemInView に設定できます。 これにより、スクロール オフセットが調整され、最後に表示される項目がビューの下部に表示されます。 (KeepLastItemInView は、Windows 10 バージョン 1607 以降で使用できます)。

ヒント

Windows 8では、ListView コントロールは既定の ItemsPanel として VirtualizingStackPanelを使用します。Windows 8.1では、ListView コントロールは ItemsStackPanel を既定の ItemsPanel として使用します。 Windows 8 アプリで ListView をアップグレードして ItemsStackPanel を使用する場合は、Windows 8 ListView の動作を維持する必要がある場合は、ItemsUpdatingScrollMode プロパティを KeepScrollOffset に設定します。