Xamarin.Forms Selezione

La visualizzazione Selezione è un controllo per la selezione di un elemento di testo da un elenco di dati.

Xamarin.FormsPicker Visualizza un breve elenco di elementi, da cui l'utente può selezionare un elemento. Picker definisce le proprietà seguenti:

  • CharacterSpacing, di tipo double, è la spaziatura tra i caratteri dell'elemento visualizzato da Picker.
  • FontAttributes di tipo FontAttributes, che per impostazione predefinita è FontAtributes.None.
  • FontFamily di tipo string, che per impostazione predefinita è null.
  • FontSize di tipo double, che per impostazione predefinita è -1.0.
  • HorizontalTextAlignment, di tipo TextAlignment, è l'allineamento orizzontale del testo visualizzato da Picker.
  • ItemsSource di tipo IList, l'elenco di origine di elementi da visualizzare, che per impostazione predefinita è null.
  • SelectedIndex di tipo int, l'indice dell'elemento selezionato, che per impostazione predefinita è -1.
  • SelectedItem di tipo object, l'elemento selezionato, che per impostazione predefinita è null.
  • TextColor di tipo Color, il colore utilizzato per visualizzare il testo, che per impostazione predefinita è Color.Default.
  • Title di tipo string, che per impostazione predefinita è null.
  • TitleColor di tipo Color, il colore utilizzato per visualizzare il Title testo.
  • VerticalTextAlignment, di tipo TextAlignment, è l'allineamento verticale del testo visualizzato da Picker.

Tutte le proprietà sono supportate da BindableProperty oggetti, il che significa che possono essere stilizzati e che le proprietà possono essere destinazioni di data binding. Le SelectedIndex proprietà e SelectedItem hanno una modalità di associazione predefinita di BindingMode.TwoWay, il che significa che possono essere destinazioni di data binding in un'applicazione che usa l'architettura Model-View-ViewModel (MVVM). Per informazioni sull'impostazione delle proprietà dei tipi di carattere, vedere Tipi di carattere.

Un Picker oggetto non mostra dati quando viene visualizzato per la prima volta. Il valore della proprietà Title viene invece visualizzato come segnaposto nelle piattaforme iOS e Android:

Initial Picker Display

Quando si ottiene lo Picker stato attivo, vengono visualizzati i dati e l'utente può selezionare un elemento:

Picker Selecting an Item

Genera Picker un SelectedIndexChanged evento quando l'utente seleziona un elemento. Dopo la selezione, l'elemento selezionato viene visualizzato da Picker:

Picker after Selection

Esistono due tecniche per popolare un oggetto Picker con i dati:

  • Impostazione della ItemsSource proprietà sui dati da visualizzare. Questa è la tecnica consigliata. Per altre informazioni, vedere Impostazione della proprietà ItemsSource di una selezione.
  • Aggiunta dei dati da visualizzare alla Items raccolta. Questa tecnica era il processo originale per popolare un oggetto Picker con i dati. Per altre informazioni, vedere Aggiunta di dati alla raccolta di elementi di una selezione.