ItemsStackPanel.ItemsUpdatingScrollMode Propriedade

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Obtém ou define um valor que especifica o comportamento de rolagem quando o ItemsSource é atualizado.

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

Valor da propriedade

ItemsUpdatingScrollMode

Um valor da enumeração. O padrão é KeepItemsInView.

Comentários

Essa propriedade controla como o ItemsStackPanel responde quando o usuário rola os itens e novos itens são adicionados ao ItemsSource.

Por exemplo, se um usuário rolar para baixo uma lista de emails e o ItemsSource for atualizado, adicionando um novo email à parte superior da lista:

• Se ItemsUpdatingScrollMode for KeepItemsInView, o deslocamento de rolagem será ajustado para manter o primeiro item visível exibido na parte superior do modo de exibição.
• Se ItemsUpdatingScrollMode for KeepScrollOffset, o deslocamento de rolagem relativo à parte superior da lista será mantido. Como resultado, os itens na tela são enviados por push para baixo para considerar o novo item adicionado na parte superior.

Em outros casos, como em um aplicativo de chat, os itens são adicionados à parte inferior da lista. Nesse caso, você pode definir ItemsUpdatingScrollMode como KeepLastItemInView. Isso ajusta o deslocamento de rolagem para manter o último item visível exibido na parte inferior do modo de exibição. (KeepLastItemInView está disponível a partir do Windows 10, versão 1607.)

Dica

Em Windows 8, o controle ListView usa VirtualizingStackPanel como seu ItemsPanel padrão; em Windows 8.1, o controle ListView usa ItemsStackPanel como seu ItemsPanel padrão. Ao atualizar um ListView em um aplicativo Windows 8 para usar ItemsStackPanel, defina a propriedade ItemsUpdatingScrollMode como KeepScrollOffset se precisar manter o comportamento do Windows 8 ListView.