New to Telerik UI for .NET MAUI? Start a free 30-day trial

Selection

The ListPicker for .NET MAUI enables the application users to quickly and easily select an item from a list of items. This topic will go through the provided by the ListPicker API related to item selection.

SelectedItem Properties

The SelectedItem(object) property specifies the selected item of the ListPicker.

Clear Button

You can enable a Clear button which can be used to quickly remove the selected value. To enable the button, set IsClearButtonVisible property of the DateTimePicker:

<telerik:RadListPicker IsClearButtonVisible="True" />

Methods

The ListPicker for .NET MAUI allows you to clear the selected date/time through its ClearSelection method.

The following example demonstrates how to use the ClearSelection method of the ListPicker.

  1. Define the ListPicker:

    <VerticalStackLayout>
      <Button Text="Clear Selection" Clicked="OnClearSelectionClicked"/>
      <telerik:RadListPicker x:Name="listPicker"
                                  Placeholder="Pick a name!"
                                  ItemsSource="{Binding Items}"
                                  DisplayMemberPath="FullName">
          <telerik:RadListPicker.BindingContext>
              <local:ViewModel/>
          </telerik:RadListPicker.BindingContext>
          <telerik:RadListPicker.ItemTemplate>
              <DataTemplate>
                  <Label Text="{Binding Name}"
                         HorizontalTextAlignment="Center"
                         VerticalTextAlignment="Center"/>
              </DataTemplate>
          </telerik:RadListPicker.ItemTemplate>
      </telerik:RadListPicker>
    </VerticalStackLayout>
    
  2. Clear the selection inside the button click event:

    private void OnClearSelectionClicked(object sender, EventArgs e)
    {
    this.listPicker.ClearSelection();
    }
    
  3. Set a sample ViewModel:

    public class PeopleViewModel
    {
    public PeopleViewModel()
    {
        this.Items = new ObservableCollection<Person>()
        {
            new Person("Freda","Curtis"),
            new Person("Jeffery","Francis"),
            new Person("Ema","Lawson"),
            new Person("Niki","Samaniego"),
            new Person("Jenny","Santos"),
            new Person("Eric","Wheeler"),
            new Person("Emmett","Fuller"),
            new Person("Brian","Johnas"),
        };
    }
    
    public ObservableCollection<Person> Items { get; set; }
    }
    
  4. Define the Business model:

    public class Person
    {
    public Person(string name, string lastName)
    {
        this.Name = name;
        this.LastName = lastName;
    }
    
    public string Name { get; set; }
    
    public string LastName { get; set; }
    
    public string FullName
    {
        get
        {
            return $"{this.Name} {this.LastName}";
        }
    }
    }
    
  5. Add the following namespace:

    xmlns:telerik="http://schemas.telerik.com/2022/xaml/maui"
    

    Events

The ListPicker for .NET MAUI exposes a SelectionChanged event which is raised when the user confirms the selected item.

The following example demonstrates how to use the SelectionChanged event of the ListPicker.

  1. Define the ListPicker:

    <telerik:RadListPicker Placeholder="Pick a name!"
                              ItemsSource="{Binding Items}"
                              SelectionChanged="RadListPicker_SelectionChanged"
                              DisplayMemberPath="FullName">
      <telerik:RadListPicker.BindingContext>
          <local:ViewModel/>
      </telerik:RadListPicker.BindingContext>
      <telerik:RadListPicker.ItemTemplate>
          <DataTemplate>
              <Label Text="{Binding Name}"
                     HorizontalTextAlignment="Center"
                     VerticalTextAlignment="Center"/>
          </DataTemplate>
      </telerik:RadListPicker.ItemTemplate>
    </telerik:RadListPicker>
    
  2. Set the SelectionChanged event, where sender corresponds to the ListPicker control:

    private void RadListPicker_SelectionChanged(object sender, System.EventArgs e)
    {
    // implement your logic here
    }
    
  3. Define a sample ViewModel:

    public class PeopleViewModel
    {
    public PeopleViewModel()
    {
        this.Items = new ObservableCollection<Person>()
        {
            new Person("Freda","Curtis"),
            new Person("Jeffery","Francis"),
            new Person("Ema","Lawson"),
            new Person("Niki","Samaniego"),
            new Person("Jenny","Santos"),
            new Person("Eric","Wheeler"),
            new Person("Emmett","Fuller"),
            new Person("Brian","Johnas"),
        };
    }
    
    public ObservableCollection<Person> Items { get; set; }
    }
    
  4. Set the Business model. In the example, the sender is the ListPicker control.

    public class Person
    {
    public Person(string name, string lastName)
    {
        this.Name = name;
        this.LastName = lastName;
    }
    
    public string Name { get; set; }
    
    public string LastName { get; set; }
    
    public string FullName
    {
        get
        {
            return $"{this.Name} {this.LastName}";
        }
    }
    }
    
  5. Add the following namespace:
xmlns:telerik="http://schemas.telerik.com/2022/xaml/maui"

See Also

In this article
Not finding the help you need?