Indata och interaktioner

WinUI-appar hanterar automatiskt en mängd olika indata och körs på en mängd olika enheter– det finns inget extra du behöver göra för att aktivera pekindata, till exempel. Men det finns tillfällen då du kanske vill optimera din app för vissa typer av indata eller enheter. Om du till exempel skapar en måleriapp kanske du vill anpassa hur du hanterar pennindata.

Design- och kodningsinstruktionerna i det här avsnittet hjälper dig att anpassa Din WinUI-app för specifika typer av indata.

Använda Windows Runtime-API:er för indata i WinUI 3-skrivbordsappar

WinUI 3-skrivbordsappar kan använda de flesta Windows Runtime-API:er (WinRT) direkt, inklusive många indatarelaterade API:er från Windows.Devices.Inputnamnrymderna , Windows.Gaming.Inputoch Windows.UI.Input . Du behöver inte skapa en UWP-app för att få åtkomst till dessa funktioner.

Det finns några saker att tänka på:

  • Fungerar i alla WinUI 3-appar – Pekareegenskaper (tryck, lutning, fatknapp), enhetsidentifiering, gamepad-maskinvaruåtkomst (Windows.Gaming.Input) och touch-/musinmatning fungerar utan någon speciell konfiguration.
  • Kräver paketidentitet (MSIX) – Vissa API:er, till exempel SpeechRecognizer och SpeechSynthesizer, kräver att din app har paketidentitet. Standardprojektmallen för WinUI 3 använder MSIX-paketering, så det här kravet uppfylls automatiskt för de flesta appar.
  • Endast UWP – API:er som är beroende av ApplicationView, CoreWindow eller GetForCurrentView mönstret är inte tillgängliga i skrivbordsappar. Detta inkluderar blickspårning (GazeInputSourcePreview) och inmatning (InputInjector). För dessa funktioner är UWP-referensdokumentationen fortfarande den bästa resursen.

En fullständig lista över WinRT-API:er som stöds och inte stöds i skrivbordsappar finns i Windows Runtime API:er som stöds i skrivbordsappar.

Tip

Avsnitt i det här avsnittet som länkar till UWP-dokumentationen beskriver funktioner som endast använder API:er för UWP. Du kan fortfarande referera till de här avsnitten för designvägledning och begrepp, även om API:erna inte är direkt tillgängliga i WinUI 3-skrivbordsappar.

Get started

Topic Description
Indataprimör Bekanta dig med varje typ av indataenhet och dess beteenden, funktioner och begränsningar när de kombineras med vissa formfaktorer.
Blickinmatning Spåra en användares blick baserat på deras ögons och huvuds plats och rörelse. Gaze API:er kräver UWP; se den länkade UWP-referensen.

Inmatningsenheter

Topic Description
Identifiera inmatningsenheter Identifiera de indataenheter som är anslutna till en Windows-appenhet och identifiera deras funktioner och attribut.
Pekare Ta emot, bearbeta och hantera indata från pekande enheter som touch, mus, penna och pekplatta.
Penna och Windows-pennanteckning Hantera pennspecifika indataegenskaper som tryck, lutning, sidoknapp och identifiering av sudd.
Touch Hantera pekindata, vilket möjliggör uppslukande upplevelser som användarna kan utforska med tillförsikt.
Mus Hantera musinmatning i din app, inklusive knappklickningar, mushjul och pekarens rörelser.
tangentbord Hantera tangentbordsinmatning, en viktig del av interaktionsupplevelsen och oumbärlig för tillgänglighet.
Gamepad och fjärrstyrning Design för Xbox gamepad och fjärrstyrningsinmatning. Windows.Gaming.Input-API:erna fungerar direkt i WinUI 3-skrivbordsappar; det länkade UWP-avsnittet behandlar designmönster för 10-fotsupplevelser.
Pekplatta Hantera pekplattans indata, som kombinerar indirekta multi-touch-indata med precisionen hos en pekenhet.
Flera indata Utforma din app så att den fungerar med så många indatatyper som möjligt för att maximera flexibilitet, användbarhet och tillgänglighet.
Anpassad textinmatning Använd api:erna för kärntext för att ta emot textindata från alla texttjänster som stöds på Windows enheter, på valfritt språk och från valfri indatatyp.

Interaktioner

Topic Description
Dra och släpp Aktivera dra och släpp interaktioner i din app.
Panorering Riktlinjer för att implementera panoreringsinteraktioner.
Rotation Riktlinjer för att implementera rotationsinteraktioner.
Markera text och bilder Riktlinjer för att välja och ändra text, bilder och kontroller.
Målinriktning Riktlinjer för pekinriktning och visuell feedback.
Visuell återkoppling Ge visuell feedback till användare under interaktioner.
Optisk zoom och storleksändring Riktlinjer för att zooma och ändra storlek på element.

Tal och feedback

Topic Description
Tal Integrera taligenkänning och text-till-tal direkt i appens användarupplevelse. Kräver paketidentitet.
Haptics Lägg till beröringsåterkoppling för att förstärka användarens inmatning och skapa mer responsiva, intuitiva interaktioner.
  • Last updated on