Entrada e interações

As aplicações WinUI lidam automaticamente com uma grande variedade de entradas e funcionam em vários dispositivos — por exemplo, não há nada extra que precise de fazer para ativar a entrada por toque. Mas há momentos em que pode querer otimizar a sua aplicação para certos tipos de entrada ou dispositivos. Por exemplo, se estiver a criar uma aplicação de pintura, pode querer personalizar a forma como lida com a entrada da caneta.

As instruções de design e codificação nesta secção ajudam-no a personalizar a sua aplicação WinUI para tipos específicos de entradas.

Utilização de APIs de entrada do Windows Runtime nas aplicações de ambiente de trabalho do WinUI 3

As aplicações de ambiente de trabalho do WinUI 3 podem utilizar diretamente a maioria das APIs do Windows Runtime (WinRT), incluindo muitas APIs relacionadas com a entrada dos espaços de nomes Windows.Devices.Input, Windows.Gaming.Input e Windows.UI.Input. Não precisas de criar uma aplicação UWP para aceder a estas capacidades.

Há algumas coisas a ter em conta:

  • Funciona em qualquer app WinUI 3 — As propriedades do ponteiro (pressão, inclinação, botão lateral), a deteção de dispositivos, o acesso ao hardware do gamepad (Windows.Gaming.Input) e a entrada por toque e rato funcionam sem necessidade de qualquer configuração especial.
  • Requer identidade de pacote (MSIX) — Algumas APIs, como SpeechRecognizer e SpeechSynthesizer, exigem que a sua aplicação tenha identidade de pacote. O modelo de projeto predefinido do WinUI 3 usa a embalagem MSIX, pelo que este requisito é cumprido automaticamente para a maioria das aplicações.
  • Apenas UWP — APIs que dependem do ApplicationView, CoreWindow ou do GetForCurrentView padrão não estão disponíveis em aplicações de ambiente de trabalho. Isto inclui o seguimento do olhar (GazeInputSourcePreview) e a injeção de entradas (InputInjector). Para estas funcionalidades, a documentação de referência do UWP continua a ser o melhor recurso.

Para a lista completa de APIs WinRT suportadas e não suportadas em aplicações de ambiente de trabalho, consulte APIs do Windows Runtime suportadas em aplicações de ambiente de trabalho.

Tip

Os tópicos desta secção que ligam à documentação do UWP abrangem funcionalidades que utilizam APIs exclusivas do UWP. Ainda podes consultar estes tópicos para orientações e conceitos de design, mesmo que as APIs não estejam diretamente disponíveis nas aplicações de desktop do WinUI 3.

Introdução

Topic Description
Preparador de entrada Familiarize-se com cada tipo de dispositivo de entrada e os seus comportamentos, capacidades e limitações quando emparelhados com determinados formatos.
Entrada do olhar Acompanhe o olhar do utilizador com base na localização e movimento dos seus olhos e cabeça. As APIs do Gaze requerem UWP; ver a referência UWP ligada.

Dispositivos de entrada

Topic Description
Identificar dispositivos de entrada Identifique os dispositivos de entrada ligados a um dispositivo de aplicação Windows e identifique as suas capacidades e atributos.
Ponteiro Receber, processar e gerir dados de entrada de dispositivos apontadores como tátil, rato, caneta/stylus e touchpad.
Caneta e Tinta do Windows Processa propriedades de entrada específicas de canetas, como pressão, inclinação, botão lateral e deteção da borracha.
Touch Trate da entrada por toque, permitindo experiências imersivas que os seus utilizadores possam explorar com confiança.
Rato Processe a entrada do rato na sua aplicação, incluindo cliques em botões, a roda de deslocamento e o movimento do ponteiro.
Teclado Gerir a entrada do teclado, uma componente essencial da experiência de interação e indispensável para a acessibilidade.
Gamepad e comando remoto Design para comando Xbox e comando remoto. As APIs Windows.Gaming.Input funcionam diretamente em aplicações de ambiente de trabalho do WinUI 3; o tópico UWP associado aborda padrões de design para ecrãs a 10 pés.
Touchpad Processe a entrada do touchpad, que combina entrada multitoque indireta com a precisão de um dispositivo apontador.
Múltiplas entradas Desenhe a sua aplicação para funcionar com o maior número possível de tipos de entrada, maximizando a flexibilidade, usabilidade e acessibilidade.
Introdução de texto personalizada Use as APIs de texto essenciais para receber entrada de texto de qualquer serviço de texto suportado em dispositivos Windows, em qualquer língua e de qualquer tipo de entrada.

Interações

Topic Description
Arraste e solte Ativa as interações de arrastar e largar na tua aplicação.
Panorâmica Diretrizes para implementar interações panorâmicas.
Rotação Diretrizes para implementar interações de rotação.
Seleção de texto e imagens Diretrizes para selecionar e manipular texto, imagens e controlos.
Segmentação Diretrizes para direcionamento por toque e feedback visual.
Feedback visual Forneça feedback visual aos utilizadores durante as interações.
Zoom ótico e redimensionamento Diretrizes para ampliar e redimensionar elementos.

Voz e comentários

Topic Description
Discurso Integre o reconhecimento de voz e o texto para fala diretamente na experiência do utilizador da sua aplicação. Requer identidade do pacote.
Háptica Adicione feedback tátil para reforçar a entrada do utilizador e crie interações mais responsivas e intuitivas.
  • Last updated on