Input e interazioni

Le app WinUI gestiscono automaticamente un'ampia gamma di input ed vengono eseguiti in un'ampia gamma di dispositivi, ad esempio non è necessario eseguire alcuna operazione aggiuntiva per abilitare l'input tocco. In alcuni casi, tuttavia, potresti voler ottimizzare l'app per determinati tipi di input o dispositivi. Ad esempio, se stai creando un'app di disegno, potresti voler personalizzare il modo in cui gestisci l'input penna.

Le istruzioni di progettazione e scrittura del codice in questa sezione consentono di personalizzare l'app WinUI per tipi specifici di input.

Uso delle API di input Windows Runtime nelle app desktop WinUI 3

Le app desktop WinUI 3 possono usare direttamente la maggior parte delle API di Windows Runtime (WinRT), incluse molte API relative all'input degli spazi dei nomi Windows.Devices.Input, Windows.Gaming.Input e Windows.UI.Input. Non è necessario creare un'app UWP per accedere a queste funzionalità.

Ci sono alcuni aspetti da tenere presenti:

  • Funziona in qualsiasi app WinUI 3 — le proprietà del puntatore (pressione, inclinazione, pulsante laterale), il rilevamento dei dispositivi, l'accesso all'hardware del gamepad (Windows.Gaming.Input) e l'input tramite tocco e mouse funzionano tutti senza alcuna configurazione speciale.
  • Richiede l'identità del pacchetto (MSIX): alcune API, ad esempio SpeechRecognizer e SpeechSynthesizer, richiedono che l'app disponga dell'identità del pacchetto. Il modello di progetto WinUI 3 predefinito usa la creazione di pacchetti MSIX, quindi questo requisito viene soddisfatto automaticamente per la maggior parte delle app.
  • Solo UWP : le API che dipendono da ApplicationView, CoreWindow o il GetForCurrentView modello non sono disponibili nelle app desktop. Questo include il rilevamento dello sguardo (GazeInputSourcePreview) e l'iniezione di input (InputInjector). Per queste funzionalità, la documentazione di riferimento UWP rimane la risorsa migliore.

Per l'elenco completo delle API WinRT supportate e non supportate nelle app desktop, vedi Windows Runtime API supportate nelle app desktop.

Suggerimento

Negli argomenti di questa sezione che si collegano alla documentazione UWP vengono illustrate le funzionalità che usano le API solo UWP. È comunque possibile fare riferimento a questi argomenti per linee guida e concetti di progettazione, anche se le API non sono direttamente disponibili nelle app desktop WinUI 3.

Get started

Topic Description
Introduzione all'input Acquisire familiarità con ogni tipo di dispositivo di input e con i relativi comportamenti, funzionalità e limitazioni quando associati a determinati fattori di forma.
Input tramite sguardo Tenere traccia dello sguardo fisso di un utente in base alla posizione e al movimento degli occhi e della testa. Le API di rilevamento dello sguardo richiedono UWP; vedere il riferimento UWP collegato.

Dispositivi di input

Topic Description
Identificare i dispositivi di input Identificare i dispositivi di input connessi a un dispositivo app Windows e identificarne le funzionalità e gli attributi.
Puntatore Ricevere, elaborare e gestire i dati di input dai dispositivi di puntamento come contatto, mouse, penna o stilo e touchpad.
Penna e Windows Ink Gestire proprietà di immissione specifiche della penna, ad esempio pressione, inclinazione, pulsante laterale e rilevamento dell'estremità di gomma.
Touch Gestite l'input touch per offrire esperienze immersive che gli utenti possono esplorare in tutta sicurezza.
mouse Gestire l'input del mouse nell'app, inclusi i clic del pulsante, la rotellina di scorrimento e lo spostamento del puntatore.
Keyboard Gestire l'input della tastiera, una parte essenziale dell'esperienza di interazione e indispensabile per l'accessibilità.
Game pad e telecomando Progettazione per l'input del gamepad Xbox e del telecomando. Le API Windows.Gaming.Input funzionano direttamente nelle app desktop WinUI 3; l'articolo UWP collegato illustra gli schemi di progettazione per interfacce a 10 piedi.
Touchpad Gestire l'input del touchpad, che combina il multitocco indiretto con la precisione di un dispositivo di puntamento.
Ingressi multipli Progettare l'app per lavorare con il maggior numero possibile di tipi di input per ottimizzare la flessibilità, l'usabilità e l'accessibilità.
Input di testo personalizzato Usare le API di base per il testo per ricevere input di testo da qualsiasi servizio di testo supportato nei dispositivi Windows, in qualsiasi lingua e da qualsiasi tipo di input.

Interazioni

Topic Description
Trascina e rilascia Abilita le interazioni drag-and-drop nella tua app.
Panning Linee guida per l'implementazione delle interazioni di panoramica.
Rotazione Linee guida per l'implementazione delle interazioni di rotazione.
Selezione di testo e immagini Linee guida per la selezione e la modifica di testo, immagini e controlli.
Targeting Linee guida per le aree di tocco e il feedback visivo.
Feedback visivo Fornire feedback visivo agli utenti durante le interazioni.
Zoom ottico e ridimensionamento Linee guida per lo zoom e il ridimensionamento degli elementi.

Voce e feedback

Topic Description
Discorso Integrare il riconoscimento vocale e la sintesi vocale direttamente nell'esperienza utente dell'app. Richiede l'identità del pacchetto.
Aptica Aggiungere feedback tattile per confermare l'input dell'utente e creare interazioni più reattive e intuitive.
  • Last updated on