Compartilhar via


Opções do Editor de Método de Entrada no Android

Este Android específico da plataforma define as opções do editor de método de entrada (IME) para o teclado virtual para um Entryarquivo . Isso inclui a configuração do botão de ação do usuário no canto inferior do teclado virtual e as interações com o Entry. Ele é consumido em XAML definindo a propriedade anexada Entry.ImeOptions como um valor da ImeFlags enumeração:

<ContentPage ...
             xmlns:android="clr-namespace:Xamarin.Forms.PlatformConfiguration.AndroidSpecific;assembly=Xamarin.Forms.Core">
    <StackLayout ...>
        <Entry ... android:Entry.ImeOptions="Send" />
        ...
    </StackLayout>
</ContentPage>

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

using Xamarin.Forms.PlatformConfiguration;
using Xamarin.Forms.PlatformConfiguration.AndroidSpecific;
...

entry.On<Android>().SetImeOptions(ImeFlags.Send);

O Entry.On<Android> método especifica que essa plataforma específica só será executada no Android. O Entry.SetImeOptions método, no Xamarin.Forms.PlatformConfiguration.AndroidSpecific namespace, é usado para definir a opção de ação do método de entrada para o teclado virtual para o Entry, com a ImeFlags enumeração fornecendo os seguintes valores:

  • Default – indica que nenhuma chave de ação específica é necessária e que o controle subjacente produzirá sua própria chave, se puder. Isso será Next ou Done.
  • None – indica que nenhuma chave de ação será disponibilizada.
  • Go – indica que a tecla de ação realizará uma operação "go", levando o usuário ao destino do texto digitado.
  • Search – indica que a tecla de ação realiza uma operação de "pesquisa", levando o usuário aos resultados da busca pelo texto digitado.
  • Send – indica que a tecla de ação realizará uma operação de "envio", entregando o texto ao seu destino.
  • Next – indica que a tecla de ação realizará uma operação "next", levando o usuário para o próximo campo que aceitará o texto.
  • Done – indica que a tecla de ação executará uma operação "concluída", fechando o teclado virtual.
  • Previous – indica que a tecla de ação realizará uma operação "anterior", levando o usuário ao campo anterior que aceitará texto.
  • ImeMaskAction – a máscara para selecionar opções de ação.
  • NoPersonalizedLearning – indica que o corretor ortográfico não aprenderá com o usuário, nem sugerirá correções com base no que o usuário digitou anteriormente.
  • NoFullscreen – indica que a interface do usuário não deve ficar em tela cheia.
  • NoExtractUi – indica que nenhuma interface do usuário será mostrada para o texto extraído.
  • NoAccessoryAction – indica que nenhuma interface do usuário será exibida para ações personalizadas.

O resultado é que um valor especificado ImeFlags é aplicado ao teclado virtual para o Entry, que define as opções do editor de método de entrada:

Editor de método de entrada de entrada específico da plataforma