Seleção de itens do TimePicker no iOS

  • Artigo

Esta interface do usuário do aplicativo multiplataforma .NET (.NET MAUI) controles específicos da plataforma iOS quando a seleção de itens ocorre em um TimePicker, permitindo que o usuário especifique que a seleção de item ocorre ao navegar por itens no controle ou apenas quando o botão Concluído é pressionado. Ele é consumido em XAML definindo a propriedade anexada TimePicker.UpdateMode como um valor da UpdateMode enumeração:

<ContentPage ...
             xmlns:ios="clr-namespace:Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific;assembly=Microsoft.Maui.Controls">
    <StackLayout>
       <TimePicker Time="14:00:00"
                   ios:TimePicker.UpdateMode="WhenFinished" />
       ...
    </StackLayout>
</ContentPage>

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

using Microsoft.Maui.Controls.PlatformConfiguration;
using Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific;
...

timePicker.On<iOS>().SetUpdateMode(UpdateMode.WhenFinished);

O TimePicker.On<iOS> método especifica que essa plataforma específica só será executada no iOS. O TimePicker.SetUpdateMode método, no Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific namespace, é usado para controlar quando a seleção de item ocorre, com a UpdateMode enumeração fornecendo dois valores possíveis:

  • Immediately – a seleção de itens ocorre à medida que o usuário navega pelos itens no TimePicker. Esse é o comportamento padrão.
  • WhenFinished – a seleção do item só ocorre depois que o usuário pressiona o botão Concluído no TimePicker.

Além disso, o método pode ser usado para alternar os valores de enumeração chamando o método, que retorna o SetUpdateModeUpdateMode atual UpdateMode:

switch (timePicker.On<iOS>().UpdateMode())
{
    case UpdateMode.Immediately:
        timePicker.On<iOS>().SetUpdateMode(UpdateMode.WhenFinished);
        break;
    case UpdateMode.WhenFinished:
        timePicker.On<iOS>().SetUpdateMode(UpdateMode.Immediately);
        break;
}

O resultado é que um especificado UpdateMode é aplicado ao , que controla quando ocorre a seleção de TimePickeritem:

Screenshot of TimePicker update modes.