Compartilhar via

Teclado virtual

  • Aplica-se a: ✅ Windows 11, ✅ Windows 10

O Windows IoT Enterprise fornece aos desenvolvedores muitos recursos de teclado na tela para aprimorar a experiência do usuário.

Principais recursos

A implementação do teclado oferece os seguintes benefícios para o desenvolvimento do seu dispositivo periférico:

Habilitar teclado virtual

O Windows tem uma ferramenta interna de Facilidade de Acesso chamada Teclado Na Tela que pode ser usada em vez de um teclado físico. Você não precisa de uma tela sensível ao toque para usar o teclado virtual. Ele exibe um teclado visual com todas as teclas padrão, para que você possa usar o mouse ou outro dispositivo apontando para selecionar teclas ou usar uma chave única física ou um grupo de teclas para percorrer as teclas na tela.

Para abrir o Teclado na Tela

Acesse Iniciar>, selecione Configurações>Facilidade de Acesso>Teclado e ative a alternância em Usar o Teclado Virtual. Um teclado que pode ser usado para se mover pela tela e inserir texto será exibido na tela. O teclado permanecerá na tela até que você o feche.

Nota

Para abrir o Teclado na Tela a partir da tela de login, selecione o botão Facilidade de Acesso no canto inferior direito da tela de login e, em seguida, selecione Teclado na Tela.

Para alterar como as informações são inseridas no teclado virtual

Com o teclado na tela aberto, selecione a tecla Opções e escolha as opções desejadas:

  • Usar o som de clique. Use essa opção se quiser ouvir um som quando pressionar uma tecla.

  • Mostrar chaves para facilitar a movimentação da tela. Use esta opção se você quiser que as teclas se acendam conforme você digita.

  • Ative o teclado numérico. Use essa opção para expandir o teclado virtual para mostrar um teclado numérico.

  • Clique em teclas. Use esse modo se preferir clicar ou tocar nas teclas na tela para inserir texto.

  • Passe o mouse sobre as teclas. Use este modo ao usar um mouse ou joystick para indicar uma tecla. Os caracteres que você aponta são inseridos automaticamente quando você aponta para eles por um tempo especificado.

  • Examinar as teclas. Use esse modo se quiser que o teclado virtual examine continuamente o teclado. O modo de varredura realça as áreas em que você pode digitar caracteres do teclado pressionando um atalho de teclado, usando um dispositivo de entrada por acionamento ou usando um dispositivo que simula um clique do mouse.

  • Usar a previsão de texto. Use essa opção se você quiser que o teclado na tela sugira palavras para você conforme você digitar para que você não precise digitar cada palavra completa.

Nota

  • A Previsão de Texto está disponível em inglês, francês, italiano, alemão e espanhol. Se você quiser usar um desses idiomas e ele não estiver instalado, instale os arquivos de idioma para esse idioma.
  • Se você estiver usando o modo de focalização ou o modo de verificação e minimizar acidentalmente o teclado virtual, poderá restaurá-lo apontando para ele na barra de tarefas (para o modo de focalização) ou pressionando a tecla de verificação (para o modo de verificação).
  • Se você minimizar o teclado virtual e alternar para o modo tablet, use o botão Modo de Exibição de Tarefa para voltar ao teclado virtual.

Pacotes de recursos

Para prototipagem de imagens (desenvolvimento), o recurso de teclado na tela já está incluído, mas você precisará habilitá-lo nas Configurações do Dispositivo no do Portal de Dispositivos do Windows.

Para comercialização, os seguintes pacotes de recursos opcionais adicionarão o teclado virtual à sua imagem:

  • IOT_SHELL_ONSCREEN_KEYBOARD
  • IOT_SHELL_ONSCREEN_KEYBOARD_FOLLOWFOCUS

Layouts de linguagem de teclado do Windows

Com esta versão, os layouts de idioma com suporte se expandiram para incluir o conjunto completo daqueles disponíveis na edição desktop do Windows. Para permitir que os usuários selecionem entre layouts de idioma diferentes, você normalmente incluiria opções de seleção na interface do usuário na área de Configurações do aplicativo. A API a seguir é fornecida para permitir que seu aplicativo defina o idioma que o teclado na tela usará:

Windows.Globalization.Language.TrySetInputMethodLanguageTag

Um exemplo dessa API pode ser visto no exemplo de aplicativo padrão do IoT Enterprise , no arquivo LanguageManager.cs.

Suporte para escopos de entrada

Nas versões anteriores, apenas o escopo de entrada EmailSmtpAddress estava disponível. Nesta versão, o conjunto completo de escopos de entrada está disponível. O tópico a seguir explica os escopos de entrada e como usá-los em seus aplicativos:

Usar o escopo de entrada para alterar o teclado virtual

Editor do Método de Entrada (IME)

Esta versão fornece um Editor de Método de Entrada, que é necessário para qualquer idioma que tenha mais grafemes do que teclas no teclado, como chinês, japonês e coreano.

Campos de entrada de texto não obscurecidos

Nas versões anteriores, o teclado virtual pode obscurecer o campo de texto focalizado para que o usuário não consiga ver o que estava digitando. Essa versão corrige esse problema rolando automaticamente o campo de texto para exibição para que ele não seja mais obscurecido pelo teclado virtual.

Modo de ditado

Quando o idioma de entrada é definido como o idioma do sistema operacional, que é o padrão, o recurso de entrada de reconhecimento de voz está disponível. Para mostrar o botão de ditado no teclado, consulte a próxima seção na configuração da Interface do Usuário .

Configuração da Interface do Usuário

O teclado virtual fornece várias opções configuráveis para sua interface do usuário. Elas são configuradas por meio do registro. Durante o desenvolvimento, você pode usar PowerShell ou Secure Shell (SSH). Para criar uma imagem OEM, o mecanismo preferencial para definir valores do Registro é o arquivo OEMInput.xml discutido aqui:

Personalizações de runtime

Nota

A maioria das configurações do Registro documentadas aqui entrará em vigor enquanto o teclado na tela estiver visível. Isso permite que você durante o desenvolvimento tente facilmente diferentes combinações de valores de configurações, vendo imediatamente as alterações resultantes em tempo real. Se uma configuração não entrar em vigor imediatamente, você precisará reinicializar o dispositivo para ver as alterações na interface do usuário do teclado.

Altura do teclado

Por padrão, o teclado virtual ocupará os 45% inferiores da altura da tela. Isso pode parecer muito grande ou pequeno em seu dispositivo, dependendo de seu tamanho e resolução. Você pode ajustar a altura até um máximo de dois terços da altura da tela. Qualquer valor que não esteja no intervalo será fixado no intervalo. Como isso é especificado como um valor de ponto flutuante, ele permite a precisão no nível do pixel.

Aplique a seguinte fórmula para calcular a porcentagem: percentage = (100 - <desired_pixel_height>) / <screen_height>

Por exemplo, para alterar a altura para 56.783%, você definirá o seguinte valor do Registro:

set OskRootKey=HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon\IoTShellExtension\OSK
reg.exe ADD "%OskRootKey%" /v MaxHeightPercentage /t REG_SZ /d "56.783" /f

ou a partir do PowerShell:

set OskRootKey "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon\IoTShellExtension\OSK"
cd $OskRootKey
Set-ItemProperty -Path . -Name MaxHeightPercentage -Type String -Value 56.783

Nota

O tipo de valor do Registro deve ser uma cadeia de caracteres (REG_SZ), para que os valores fracionários possam ser representados. um ponto decimal. O uso de DWord (REG_DWORD) não funcionará, mesmo para percentuais de números inteiros.

Preferências adicionais

O conjunto restante de preferências é valores de cadeia de caracteres na subchave Preferências:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon\IoTShellExtension\OSK\Preferences
Valor de Registro Valor Padrão Descrição
AudioFeedback_Disabled "0" "0" ativa o som de clique do teclado; "1" o desativa.
Dictation_Disabled "1" "0" mostra o botão ditado (reconhecimento de voz) ; "1" o oculta. (veja a observação abaixo)
KeyboardModeEnabled_full "0" "0" desabilita o modo de teclado completo; "1" permite isso.
KeyboardModeEnabled_narrow "1" "0" desabilita o modo de teclado estreito; "1" permite isso.
KeyboardModeEnabled_wide "1" "0" desabilita o modo de teclado largo; "1" permite isso.
ModeOrder "wide;narrow;full" A ordem (da esquerda para a direita) na qual os modos são listados no menu suspenso do modo, se habilitado
SettingsMenuKey_Collapsed "0" Oculta o menu suspenso do modo. Defina isso como "1" se apenas um modo estiver habilitado.
Paste_Disabled "0" "0" mostra o botão Colar; "1" o oculta. A alteração entra em vigor após a reinicialização.
CloseButton_Disabled "0" "0" mostra o botão Fechar; "1" oculta o botão Fechar. A alteração entra em vigor após a reinicialização.
EmojiKeyEnabled "0" "0" oculta a chave Emoji; "1" mostra isso, permitindo que o usuário insira caracteres Emoji.

Nota

O modo de ditado requer que um pacote de fala seja instalado para o idioma de entrada selecionado, bem como um dispositivo de entrada de áudio. Se um pacote de fala correspondente não estiver instalado, o botão de ditado não será mostrado.

Todas as imagens incluem a idioma de fala en-US. Outros pacotes de fala são instalados como recursos opcionais. Para obter mais informações sobre os recursos da IoT, confira Guia de fabricação da IoT Enterprise.

Por exemplo, para habilitar apenas wide modo de teclado, no PowerShell, você pode fazer o seguinte:

set OskRootKey "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon\IoTShellExtension\OSK"
cd $OskRootKey
mkdir Preferences
cd Preferences
Set-ItemProperty . -Name KeyboardModeEnabled_full -Value "0"      # Optional, since the default is "0"
Set-ItemProperty . -Name KeyboardModeEnabled_narrow -Value "0"
Set-ItemProperty . -Name KeyboardModeEnabled_wide -Value "1"      # Optional, since the default is "1"
Set-ItemProperty . -Name SettingsMenuKey_Collapsed -Value "1"

Recursos adicionais