> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Suporte ao teclado virtual

> Suporte ao teclado virtual

Embora um teclado fisicamente conectado seja uma suposição comum no PC, novas modalidades de entrada, como gamepads e toque, desafiam essa suposição. Isso é especialmente importante para jogadores de dispositivos portáteis e de console. Dependendo da plataforma, há diferentes soluções para exibir o teclado virtual. Embora o título possa implementar e criar seu próprio teclado virtual, o sistema fornece suas próprias alternativas de teclado virtual, otimizadas para a plataforma e que oferecem uma experiência do usuário consistente em todos os jogos.

No Windows, a API `TryShow` pode ser utilizada com a nova opção `CoreInputViewKind::Gamepad`. A API `TryHide` pode então ser usada para fechar o teclado quando ele não for necessário. Isso é demonstrado no seguinte exemplo de código:

```C theme={null}
#include <winrt/windows.ui.viewmanagement.core.h>
using namespace winrt::Windows::UI::ViewManagement::Core;

// CoreInputViewKind::Gamepad enum requires headers from 26100.3624 Windows SDK or greater
// Otherwise, use static_cast<CoreInputViewKind>(7) for earlier SDKs

CoreInputView::GetForCurrentView().TryShow(CoreInputViewKind::Gamepad));

CoreInputView::GetForCurrentView().TryHide();
```

Para console, o GDK oferece duas soluções diferentes para lidar com a entrada de texto usando um teclado virtual. Para a maioria dos jogos, a melhor solução é usar [XGameUiShowTextEntryAsync](/pt-BR/reference/system/xgameui/functions/xgameuishowtextentryasync). Os jogos que precisam renderizar texto de várias linhas ou a entrada de mais de 1024 caracteres podem usar [XGameUiTextEntryOpen](/pt-BR/reference/system/xgameui/functions/xgameuitextentryopen).

A tabela a seguir fornece uma comparação entre essas duas soluções.

| Descrição | XGameUiShowTextEntryAsync | XGameUiTextEntryOpen |
| - | - | - |
| Suporte a várias linhas | Não | Sim |
| Número máximo de caracteres | 1024 | 1024 \* 32 |
| Foco de entrada | O teclado virtual recebe o foco de entrada | O teclado virtual recebe o foco de entrada |
| Posicionamento | Posição fixa | Posicionado pelo jogo |
| Renderização de texto | Realizada pelo teclado virtual | Realizada pelo jogo |
| Comportamento em streaming na nuvem | Utiliza o teclado virtual no cliente | Renderizado pelo servidor de streaming |

## Confira também

[Lista de verificação para jogos do GDK em dispositivos portáteis Windows - Verificação 3: Entrada de texto](/pt-BR/build/gdk-and-engines/handheld/handheld-guidance) [XGameUiShowTextEntryAsync](/pt-BR/reference/system/xgameui/functions/xgameuishowtextentryasync) [XGameUiTextEntryOpen](/pt-BR/reference/system/xgameui/functions/xgameuitextentryopen)


## Related topics

- [Compatibilidad con el teclado virtual](/es/build/core-features/common/input/overviews/virtualkeyboardsupport.md)
- [XBOX Accessibility Guidelines (XAG)](/pt-BR/build/game-principles/accessibility/xbox-accessibility-guidelines.md)
- [Conteúdo de suporte aos requisitos e políticas do XBOX](/pt-BR/publishing/certification/xr/overview.md)
- [Directrices del programa Handheld Compatibility](/es/build/gdk-and-engines/handheld/handheld-guidance.md)
- [Acesse recursos e downloads do GDK](/pt-BR/home/onboarding-access/access-resources.md)