Compartilhar via


Rolagem rápida do ListView no Android

Esta interface do usuário do aplicativo multiplataforma .NET (.NET Maui) específica da plataforma Android é usada para habilitar a rolagem rápida pelos dados em um ListViewarquivo . Ele é consumido em XAML definindo a propriedade anexada ListView.IsFastScrollEnabled como um boolean valor:

<ContentPage ...
             xmlns:android="clr-namespace:Microsoft.Maui.Controls.PlatformConfiguration.AndroidSpecific;assembly=Microsoft.Maui.Controls"
             xmlns:local="clr-namespace:PlatformSpecifics"
             x:DataType="local:ListViewViewModel">
    <StackLayout>
        ...
        <ListView ItemsSource="{Binding GroupedEmployees}"
                  GroupDisplayBinding="{Binding Key}"
                  IsGroupingEnabled="true"
                  android:ListView.IsFastScrollEnabled="true">
            ...
        </ListView>
    </StackLayout>
</ContentPage>

Como alternativa, ele pode ser consumido do C# usando a API fluente:

using Microsoft.Maui.Controls.PlatformConfiguration.AndroidSpecific;
...

var listView = new Microsoft.Maui.Controls.ListView { IsGroupingEnabled = true, ItemTemplate = personDataTemplate };
listView.SetBinding(ItemsView<Cell>.ItemsSourceProperty, static (ListViewViewModel vm) => vm.GroupedEmployees); // .NET 9+ compiled binding
listView.GroupDisplayBinding = Binding.Create(static (Grouping<char, Person> g) => g.Key); // .NET 9+ compiled binding
listView.On<Microsoft.Maui.Controls.PlatformConfiguration.Android>().SetIsFastScrollEnabled(true);

O ListView.On<Microsoft.Maui.Controls.PlatformConfiguration.Android> método especifica que essa plataforma específica só será executada no Android. O ListView.SetIsFastScrollEnabled método, no namespace, é usado para habilitar a Microsoft.Maui.Controls.PlatformConfiguration.AndroidSpecific rolagem rápida pelos dados em um ListViewarquivo . Além disso, o método pode ser usado para alternar a rolagem rápida chamando o método para retornar se a SetIsFastScrollEnabled IsFastScrollEnabled rolagem rápida está habilitada:

listView.On<Microsoft.Maui.Controls.PlatformConfiguration.Android>().SetIsFastScrollEnabled(!listView.On<Microsoft.Maui.Controls.PlatformConfiguration.Android>().IsFastScrollEnabled());

O resultado é que a rolagem rápida pelos dados em um ListView pode ser habilitada, o que altera o tamanho do polegar de rolagem:

ListView FastScroll Platform-Specific.