Vstupy a interakce

Aplikace WinUI automaticky zpracovávají širokou škálu vstupů a spouští se na různých zařízeních – není potřeba nic dalšího udělat, abyste povolili dotykové vstupy, například. Někdy ale můžete chtít aplikaci optimalizovat pro určité typy vstupů nebo zařízení. Pokud například vytváříte aplikaci pro malování, můžete chtít přizpůsobit způsob zpracování vstupu pera.

Pokyny k návrhu a kódování v této části vám pomůžou přizpůsobit aplikaci WinUI pro konkrétní typy vstupů.

Použití rozhraní API pro vstup prostředí Windows Runtime v desktopových aplikacích WinUI 3

Desktopové aplikace WinUI 3 můžou přímo používat většinu rozhraní API prostředí Windows Runtime (WinRT), včetně mnoha rozhraní API souvisejících se vstupy z rozhraní Windows.Devices.Input, Windows.Gaming.Inputa Windows.UI.Input oborů názvů. Pro přístup k těmto funkcím nemusíte vytvářet aplikaci pro UPW.

Je potřeba si uvědomit několik věcí:

  • Funguje v jakékoli aplikaci WinUI 3 – vlastnosti ukazatele (tlak, naklonění, tlačítko sudu), detekce zařízení, přístup k hardwaru gamepadu (Windows.Gaming.Input) a vstup dotykového ovládání/myši fungují bez zvláštní konfigurace.
  • Vyžaduje identitu balíčku (MSIX) – některá rozhraní API, například SpeechRecognizer a SpeechSynthesizer, vyžadují, aby vaše aplikace měla identitu balíčku. Výchozí šablona projektu WinUI 3 používá balení MSIX, takže tento požadavek je pro většinu aplikací splněn automaticky.
  • Pouze pro UPW – rozhraní API, která závisí na ApplicationView, CoreWindow nebo GetForCurrentView vzoru, nejsou v desktopových aplikacích k dispozici. To zahrnuje sledování směru pohledu (GazeInputSourcePreview) a vkládání vstupů (InputInjector). Pro tyto funkce zůstává nejlepším zdrojem referenční dokumentace k UWP.

Úplný seznam podporovaných a nepodporovaných rozhraní API WinRT v desktopových aplikacích najdete v tématu prostředí Windows Runtime rozhraní API podporovaná v desktopových aplikacích.

Návod

Témata v této části, která odkazují na dokumentaci k UPW, se týkají funkcí, které používají rozhraní API jen pro UPW. Tato témata vám stále mohou sloužit jako vodítko pro návrh a pochopení konceptů, i když rozhraní API nejsou v desktopových aplikacích WinUI 3 přímo k dispozici.

Začínáme

Topic Description
Úvod do vstupu Seznamte se s každým typem vstupního zařízení a jeho chováním, možnostmi a omezeními při párování s určitými formovými faktory.
Vstup pomocí pohledu Sledujte pohled uživatele na základě polohy a pohybu očí a hlavy. Rozhraní API Gaze vyžadují UWP; viz odkaz na referenční dokumentaci k UWP.

Vstupní zařízení

Topic Description
Identifikace vstupních zařízení Identifikujte vstupní zařízení připojená k zařízení aplikace pro Windows a identifikujte jejich schopnosti a atributy.
Ukazatel Příjem, zpracování a správa vstupních dat ze zařízení, jako jsou dotykové ovládání, myš, pero nebo touchpad
Pero a Windows Ink Zpracování vstupních vlastností specifických pro pero, jako je tlak, náklon, boční tlačítko a detekce gumovacího konce.
Touch Pracujte s dotykovým vstupem a povolte imerzivní prostředí, která můžou uživatelé zkoumat s jistotou.
myši Zpracujte vstup myši v aplikaci, včetně kliknutí na tlačítko, posuvníku a pohybu ukazatele.
Klávesnice Ovládání vstupu pomocí klávesnice, základní část prostředí interakce a nepostradatelná pro přístupnost.
Gamepad a dálkové ovládání Návrh pro Xbox gamepad a vstup dálkového ovládání Rozhraní API Windows.Gaming.Input fungují přímo v desktopových aplikacích WinUI 3; odkazované téma UWP se věnuje návrhovým vzorům pro prostředí 10 stop.
Touchpad Pracujte se vstupem z touchpadu, který kombinuje nepřímý vícedotykový vstup s přesností ukazovacího zařízení.
Více vstupů Navrhněte aplikaci tak, aby fungovala s co největším počtem typů vstupů, abyste maximalizovali flexibilitu, použitelnost a přístupnost.
Vlastní textové zadání Základní textová rozhraní API slouží k příjmu textového vstupu z libovolné textové služby podporované na Windows zařízeních v libovolném jazyce a z libovolného typu vstupu.

Interakce

Topic Description
Přetažení Povolte interakce přetažením v aplikaci.
Posouvání Pokyny pro implementaci interakcí posouvání
Otočení Pokyny pro implementaci interakcí otáčení.
Výběr textu a obrázků Pokyny pro výběr a manipulaci s textem, obrázky a ovládacími prvky
Cílení Pokyny pro cílení na dotykové ovládání a vizuální zpětnou vazbu
Vizuální zpětná vazba Poskytněte uživatelům vizuální zpětnou vazbu během interakcí.
Optické zvětšení a změna velikosti Pokyny pro zvětšení a změnu velikosti prvků

Řeč a zpětná vazba

Topic Description
Projev Integrujte rozpoznávání řeči a převod textu na řeč přímo do uživatelského prostředí aplikace. Vyžaduje identitu balíčku.
Haptika Přidejte dotykovou zpětnou vazbu, abyste posílili vstup uživatele a vytvořili rychlejší a intuitivnější interakce.