Bemenetek és interakciók

A WinUI-alkalmazások automatikusan kezelik a különféle bemeneteket, és különböző eszközökön futnak – nincs szükség például az érintéses bevitel engedélyezésére. Előfordulhat azonban, hogy bizonyos típusú bemenetekhez vagy eszközökhöz szeretné optimalizálni az alkalmazást. Ha például festőalkalmazást hoz létre, érdemes testre szabni a tollbemenet kezelését.

A jelen szakaszban található tervezési és kódolási utasítások segítenek testre szabni a WinUI-alkalmazást adott típusú bemenetekhez.

Windows-futtatókörnyezet bemeneti API-k használata WinUI 3 asztali alkalmazásokban

A WinUI 3 asztali alkalmazások a legtöbb Windows-futtatókörnyezet (WinRT) API-t használhatják közvetlenül, beleértve számos bemenettel kapcsolatos API-t a , Windows.Devices.Inputés Windows.Gaming.Input a Windows.UI.Inputnévterekből. Ezeknek a képességeknek a eléréséhez nem kell UWP-alkalmazást létrehoznia.

Van néhány dolog, amit tudnia kell:

  • Bármilyen WinUI 3 alkalmazásban működik – A mutató tulajdonságai (nyomás, dőlés, hordógomb), az eszközészlelés, a gamepad hardverhozzáférése (Windows.Gaming.Input) és az érintéses/egér bemenet mind speciális konfiguráció nélkül működnek.
  • Csomagidentitást (MSIX) igényel – Egyes API-k, például a SpeechRecognizer és a SpeechSynthesizer megkövetelik, hogy az alkalmazás csomagidentitással rendelkezzen. Az alapértelmezett WinUI 3 projektsablon MSIX-csomagolást használ, ezért ez a követelmény a legtöbb alkalmazás esetében automatikusan teljesül.
  • Csak UWP – Az ApplicationView-tól, a CoreWindow-tól vagy a GetForCurrentView mintától függő API-k nem érhetők el az asztali alkalmazásokban. Ez magában foglalja a tekintet nyomon követését (GazeInputSourcePreview) és a bemeneti injektálást (InputInjector). Ezen funkciók esetében az UWP referenciadokumentációja marad a legjobb erőforrás.

Az asztali alkalmazásokban támogatott és nem támogatott WinRT API-k teljes listájáért tekintse meg Windows-futtatókörnyezet asztali alkalmazásokban támogatott API-kat.

Tipp

A jelen szakaszban az UWP dokumentációját tartalmazó témakörök olyan funkciókat tartalmaznak, amelyek csak UWP API-kat használnak. Ezekre a témakörökre továbbra is hivatkozhat tervezési útmutatók és fogalmak céljából, annak ellenére, hogy az API-k közvetlenül nem érhetők el a WinUI 3 asztali alkalmazásokban.

Első lépések

Téma Description
Bemeneti útmutató Ismerkedjen meg az egyes bemeneti eszköztípusokkal és azok viselkedésével, képességeivel és korlátaival, amikor adott formátumú eszközökkel párosítják őket.
Tekintetvezérlés A felhasználók tekintetének nyomon követése a szemük és fejük elhelyezkedése és mozgása alapján. A tekintetalapú API-khoz UWP szükséges; lásd a hivatkozott UWP-referenciát.

Bemeneti eszközök

Téma Description
Bemeneti eszközök azonosítása Azonosítsa a Windows-alkalmazáseszközhöz csatlakoztatott bemeneti eszközöket, és azonosítsa azok képességeit és attribútumait.
Mutató Az érintésből, egérből, tollból/stíluszból és érintőpadból származó bemeneti adatok fogadása, feldolgozása és kezelése.
Toll és Windows Ink Kezelje a tollspecifikus bemeneti tulajdonságokat, például a nyomást, a dőlést, a hordógombot és a radír észlelését.
Touch Kezelje az érintéses bevitelt, így a felhasználók magabiztosan fedezhetik fel a modern élményeket.
egér Kezelheti az alkalmazás egérbemenetét, beleértve a gombkattintásokat, a görgetőkerekeket és a mutató mozgását.
Billentyűzet Kezelje a billentyűzetbemenetet, amely elengedhetetlen része az interakciós élménynek, és elengedhetetlen az akadálymentességhez.
Gamepad és távvezérlés Tervezzen Xbox játékpadhoz és távvezérlési bemenethez. A Windows.Gaming.Input API-k közvetlenül működnek a WinUI 3 asztali alkalmazásokban; a hivatkozott UWP-témakör a 10 lábas kialakítási mintákat ismerteti.
Érintőpad Az érintőtábla-bemenet kezelése, amely egyesíti a közvetett többérintéses bevitelt a mutatóeszköz pontosságával.
Több bemenet Úgy tervezheti meg az alkalmazást, hogy a lehető legtöbb bemeneti típussal működjön együtt a rugalmasság, a használhatóság és az akadálymentesség maximalizálása érdekében.
Egyéni szövegbevitel Az alapvető szöveges API-k használatával szöveges bemenetet fogadhat a Windows eszközökön támogatott bármely szövegszolgáltatásból, bármilyen nyelven és bármilyen bemeneti típusból.

Interakciók

Téma Description
Húzd és ejtsd le Engedélyezze a fogd és vidd interakciókat az alkalmazásában.
Panorámafelvétel A pásztázó interakciók implementálásának irányelvei.
forgatás A rotációs interakciók implementálásának irányelvei.
Szöveg és képek kijelölése Útmutatás szöveg, képek és vezérlők kiválasztásához és kezeléséhez.
Célzás Útmutató az érintéses célzáshoz és a vizuális visszajelzéshez.
Vizuális visszajelzés Vizuális visszajelzés küldése a felhasználók számára az interakciók során.
Optikai nagyítás és átméretezés Az elemek nagyításának és átméretezésének irányelvei.

Beszéd és visszajelzés

Téma Description
Beszéd Integrálhatja a beszédfelismerést és a szövegfelolvasást közvetlenül az alkalmazás felhasználói élményébe. Csomagazonosítót igényel.
Haptics Érintéses visszajelzések hozzáadása a felhasználói bevitel megerősítéséhez és rugalmasabb, intuitívabb interakciók létrehozásához.
  • Last updated on