ItemsStackPanel.ItemsUpdatingScrollMode プロパティ

定義

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

プロパティ値

列挙体の値。 既定値は KeepItemsInView です

注釈

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

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

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

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

ヒント

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

適用対象