Entrada e interações

Os aplicativos WinUI lidam automaticamente com uma ampla variedade de entradas e são executados em uma variedade de dispositivos. Não há nada extra que você precise fazer para habilitar a entrada por toque, por exemplo. Mas há momentos em que talvez você queira otimizar seu aplicativo para determinados tipos de entrada ou dispositivos. Por exemplo, se você estiver criando um aplicativo de pintura, talvez queira personalizar a maneira como lida com a entrada de caneta.

As instruções de design e codificação nesta seção ajudam você a personalizar seu aplicativo WinUI para tipos específicos de entradas.

Usando APIs de entrada Windows Runtime em aplicativos da área de trabalho do WinUI 3

Os aplicativos da área de trabalho do WinUI 3 podem usar diretamente a maioria das APIs do Windows Runtime (WinRT), incluindo muitas APIs relacionadas a entrada dos namespaces Windows.Devices.Input, Windows.Gaming.Input e Windows.UI.Input. Você não precisa criar um aplicativo UWP para acessar esses recursos.

Há algumas coisas que devem ser observadas:

  • Funciona em qualquer aplicativo WinUI 3 — As propriedades do ponteiro (pressão, inclinação, botão lateral), detecção de dispositivo, acesso ao hardware do gamepad (Windows.Gaming.Input) e entrada por toque/mouse funcionam sem configuração especial.
  • Requer a identidade do pacote (MSIX) – algumas APIs, como SpeechRecognizer e SpeechSynthesizer, exigem que seu aplicativo tenha a identidade do pacote. O modelo de projeto padrão do WinUI 3 usa o empacotamento MSIX, portanto, esse requisito é atendido automaticamente para a maioria dos aplicativos.
  • Somente UWP – APIs que dependem de ApplicationView, CoreWindow ou o GetForCurrentView padrão não estão disponíveis em aplicativos da área de trabalho. Isso inclui o rastreamento de foco (GazeInputSourcePreview) e a injeção de entrada (InputInjector). Para esses recursos, a documentação de referência da UWP continua sendo o melhor recurso.

Para obter a lista completa de APIs WinRT com suporte e sem suporte em aplicativos da área de trabalho, consulte Windows Runtime APIs com suporte em aplicativos da área de trabalho.

Tip

Os tópicos desta seção que vinculam à documentação da UWP abrangem recursos que usam APIs somente UWP. Você ainda pode referenciar esses tópicos para diretrizes de design e conceitos, mesmo que as APIs não estejam diretamente disponíveis em aplicativos da área de trabalho do WinUI 3.

Introdução

Tópico Description
Guia de entrada Familiarize-se com cada tipo de dispositivo de entrada e seus comportamentos, capacidades e limitações quando combinados com determinados fatores de forma.
Entrada de foco Acompanhe o olhar de um usuário com base no local e no movimento de seus olhos e cabeça. As APIs de rastreamento do olhar exigem UWP; consulte a referência da UWP no link.

Dispositivos de entrada

Tópico Description
Identificar dispositivos de entrada Identifique os dispositivos de entrada conectados a um dispositivo de aplicativo Windows e identifique seus recursos e atributos.
Ponteiro Receba, processe e gerencie dados de entrada de dispositivos apontadores, como toque, mouse, caneta/stylus e touchpad.
Caneta e Tinta do Windows Gerencie propriedades de entrada específicas da caneta, como pressão, inclinação, botão lateral e detecção da borracha da caneta.
Touch Manipule a entrada por toque, permitindo experiências imersivas que seus usuários podem explorar com confiança.
mouse Manipule a entrada do mouse em seu aplicativo, incluindo cliques de botão, roda de rolagem e movimento do ponteiro.
Keyboard Manipule a entrada do teclado, uma parte essencial da experiência de interação e indispensável para acessibilidade.
Gamepad e controle remoto Projete para entrada via gamepad e controle remoto do Xbox. As APIs do Windows.Gaming.Input funcionam diretamente em aplicativos WinUI 3 para desktop; o tópico vinculado do UWP aborda padrões de design para 10 pés.
Touchpad Trate a entrada do touchpad, que combina entrada multitoque indireta com a precisão de um dispositivo apontador.
Várias entradas Crie seu aplicativo para trabalhar com o maior número possível de tipos de entrada para maximizar a flexibilidade, a usabilidade e a acessibilidade.
Entrada de texto personalizada Use as APIs principais de texto para receber entrada de texto de qualquer serviço de texto compatível com dispositivos Windows, em qualquer idioma e de qualquer tipo de entrada.

Interações

Tópico Description
Arrastar e soltar Habilite interações de arrastar e soltar em seu aplicativo.
Panning Diretrizes para implementar interações de panoramização.
Rotação Diretrizes para implementar interações de rotação.
Selecionando texto e imagens Diretrizes para selecionar e manipular texto, imagens e controles.
Direcionamento Diretrizes para direcionamento de toque e comentários visuais.
Comentários visuais Forneça comentários visuais aos usuários durante as interações.
Zoom óptico e redimensionamento Diretrizes para ampliar e redimensionar elementos.

Fala e comentários

Tópico Description
Discurso Integre o reconhecimento de fala e a conversão de texto em fala diretamente à experiência do usuário do seu aplicativo. Requer a identidade do pacote.
Hápticos Adicione comentários por toque para reforçar a entrada do usuário e criar interações intuitivas e mais responsivas.
  • Last updated on