Invoer en interacties

WinUI-apps verwerken automatisch een grote verscheidenheid aan invoer en worden uitgevoerd op verschillende apparaten. U hoeft niets extra's te doen om bijvoorbeeld aanraakinvoer in te schakelen. Maar soms wilt u uw app optimaliseren voor bepaalde typen invoer of apparaten. Als u bijvoorbeeld een schilderij-app maakt, kunt u de manier aanpassen waarop u peninvoer verwerkt.

Met de ontwerp- en coderingsinstructies in deze sectie kunt u uw WinUI-app aanpassen voor specifieke typen invoer.

Windows Runtime invoer-API's gebruiken in WinUI 3-bureaublad-apps

WinUI 3-desktop-apps kunnen de meeste Windows Runtime (WinRT)-API's rechtstreeks gebruiken, waaronder veel invoergerelateerde API's uit de naamruimtes Windows.Devices.Input, Windows.Gaming.Input en Windows.UI.Input. U hoeft geen UWP-app te bouwen om toegang te krijgen tot deze mogelijkheden.

Er zijn enkele dingen waar u rekening mee moet houden:

  • Werkt in elke WinUI 3-app : aanwijzereigenschappen (druk, kantelen, vatknop), apparaatdetectie, gamepad hardwaretoegang (Windows.Gaming.Input) en aanraak-/muisinvoer werken allemaal zonder speciale configuratie.
  • Vereist pakketidentiteit (MSIX): voor sommige API's, zoals SpeechRecognizer en SpeechSynthesizer, moet uw app een pakketidentiteit hebben. De standaard WinUI 3-projectsjabloon maakt gebruik van MSIX-pakketten, dus aan deze vereiste wordt automatisch voldaan voor de meeste apps.
  • ALLEEN-UWP- API's die afhankelijk zijn van ApplicationView, CoreWindow of het GetForCurrentView patroon zijn niet beschikbaar in bureaublad-apps. Dit omvat blikregistratie (GazeInputSourcePreview) en invoerinjectie (InputInjector). Voor deze functies blijft de REFERENTIEdocumentatie voor UWP de beste resource.

Zie Windows Runtime API's die worden ondersteund in desktop-apps voor een volledige lijst met ondersteunde en niet-ondersteunde WinRT-API's.

Hint

Onderwerpen in deze sectie die zijn gekoppeld aan UWP-documentatie, hebben betrekking op functies die gebruikmaken van UWP-API's. U kunt nog steeds verwijzen naar deze onderwerpen voor ontwerprichtlijnen en concepten, ook al zijn de API's niet rechtstreeks beschikbaar in WinUI 3-desktop-apps.

Get started

Onderwerp Beschrijving
Invoer primer Zorg dat u vertrouwd raakt met elk type invoerapparaat en het gedrag, de mogelijkheden en beperkingen wanneer u met bepaalde formulierfactoren bent gekoppeld.
Oogbeweginginvoer Houd de blik van een gebruiker bij op basis van de locatie en beweging van hun ogen en hoofd. Gaze-API’s vereisen UWP; zie de gekoppelde UWP-referentie.

Invoerapparaten

Onderwerp Beschrijving
Invoerapparaten identificeren Identificeer de invoerapparaten die zijn verbonden met een Windows-app-apparaat en identificeer hun mogelijkheden en kenmerken.
Aanwijzer Invoergegevens ontvangen, verwerken en beheren vanaf aanwijzende apparaten, zoals aanraken, muis, pen/stylus en touchpad.
Pen en Windows Ink Verwerk penspecifieke invoereigenschappen zoals druk, hellingshoek, zijknop en gumdetectie.
Touch Omgaan met aanraakinvoer, waardoor insluitende ervaringen mogelijk zijn die uw gebruikers met vertrouwen kunnen verkennen.
muis Verwerk muisinvoer in uw app, waaronder muisklikken, het scrollwiel en bewegingen van de aanwijzer.
Toetsenbord Omgaan met toetsenbordinvoer, een essentieel onderdeel van de interactie-ervaring en onmisbaar voor toegankelijkheid.
Gamepad en afstandsbediening Ontwerp voor Xbox gamepad- en afstandsbedieningsinvoer. De Windows. Gaming.Input-API's werken rechtstreeks in WinUI 3-desktop-apps; het gekoppelde UWP-onderwerp behandelt ontwerppatronen van 10 voet.
Touchpad Verwerk touchpad-invoer, die indirecte multi-touchinvoer combineert met de precisie van een aanwijsapparaat.
Meerdere invoer Ontwerp uw app om met zoveel mogelijk invoertypen te werken om de flexibiliteit, bruikbaarheid en toegankelijkheid te maximaliseren.
Aangepaste tekstinvoer Gebruik de kerntekst-API's om tekstinvoer te ontvangen van elke tekstservice die wordt ondersteund op Windows apparaten, in elke taal en van elk invoertype.

Interacties

Onderwerp Beschrijving
slepen en neerzetten Schakel interacties voor slepen en neerzetten in uw app in.
Panning Richtlijnen voor het implementeren van panning-interacties.
Rotatie Richtlijnen voor het implementeren van rotatieinteracties.
Tekst en afbeeldingen selecteren Richtlijnen voor het selecteren en bewerken van tekst, afbeeldingen en besturingselementen.
Doelgroepbepaling Richtlijnen voor aanraakgebieden en visuele feedback.
Visuele feedback Geef visuele feedback aan gebruikers tijdens interacties.
Optische zoom en grootte aanpassen Richtlijnen voor het in- en verkleinen van elementen.

Spraak en feedback

Onderwerp Beschrijving
Spraak Integreer spraakherkenning en tekst-naar-spraak rechtstreeks in de gebruikerservaring van uw app. Vereist pakketidentiteit.
Haptiek Voeg aanraakfeedback toe om gebruikersinvoer te versterken en responsievere, intuïtievere interacties te creëren.
  • Last updated on