Xamarin.Forms Selecionador
O modo de exibição Seletor é um controle para selecionar um item de texto em uma lista de dados.
O exibe Xamarin.FormsPicker
uma pequena lista de itens, a partir da qual o usuário pode selecionar um item. Picker
define as propriedades a seguir:
CharacterSpacing
, do tipodouble
, é o espaçamento entre os caracteres do item exibido peloPicker
.FontAttributes
do tipoFontAttributes
, cujo padrão éFontAtributes.None
.FontFamily
do tipostring
, cujo padrão énull
.FontSize
do tipodouble
, cujo padrão é -1,0.HorizontalTextAlignment
, do tipoTextAlignment
, é o alinhamento horizontal do texto exibido peloPicker
.ItemsSource
do tipoIList
, a lista de origem de itens a serem exibidos, que usanull
como padrão.SelectedIndex
do tipoint
, o índice do item selecionado, cujo padrão é -1.SelectedItem
do tipoobject
, o item selecionado, cujo padrão énull
.TextColor
do tipoColor
, a cor usada para exibir o texto, cujo padrão éColor.Default
.Title
do tipostring
, cujo padrão énull
.TitleColor
do tipoColor
, a cor usada para exibir o texto doTitle
.VerticalTextAlignment
, do tipoTextAlignment
, é o alinhamento vertical do texto exibido peloPicker
.
Todas as propriedades são apoiadas por BindableProperty
objetos, o que significa que elas podem ser estilizadas e as propriedades podem ser destinos de associações de dados. As SelectedIndex
propriedades and SelectedItem
têm um modo de associação padrão de BindingMode.TwoWay
, o que significa que elas podem ser destinos de associações de dados em um aplicativo que usa a arquitetura MVVM (Model-View-ViewModel). Para obter informações sobre como definir propriedades de fonte, veja Fontes.
Um Picker
não mostra nenhum dado quando é exibido pela primeira vez. Em vez disso, o valor de sua Title
propriedade é mostrado como um espaço reservado nas plataformas iOS e Android:
Quando o Picker
ganha focus, seus dados são exibidos e o usuário pode selecionar um item:
O Picker
dispara um evento SelectedIndexChanged
quando o usuário seleciona um item. Após a seleção, o item selecionado é exibido pelo Picker
:
Há duas técnicas para preencher um Picker
com dados:
- Definindo a propriedade
ItemsSource
para os dados a serem exibidos. Essa é a técnica recomendada. Para obter mais informações, consulte Definindo a propriedade ItemsSource de um seletor. - Adicionando os dados a serem exibidos à coleção
Items
. Essa técnica foi o processo original para preencher umPicker
com dados. Para obter mais informações, consulte Adicionando dados à coleção de itens de um seletor.