Masukan dan interaksi

Aplikasi WinUI secara otomatis menangani berbagai input dan berjalan di berbagai perangkat—tidak ada yang perlu Anda lakukan untuk mengaktifkan input sentuhan, misalnya. Tetapi ada kalanya Anda mungkin ingin mengoptimalkan aplikasi untuk jenis input atau perangkat tertentu. Misalnya, jika Anda membuat aplikasi lukisan, Anda mungkin ingin menyesuaikan cara Anda menangani input pena.

Instruksi desain dan pengodean di bagian ini membantu Anda menyesuaikan aplikasi WinUI untuk jenis input tertentu.

Menggunakan API input Windows Runtime di aplikasi desktop WinUI 3

Aplikasi desktop WinUI 3 dapat menggunakan sebagian besar API Windows Runtime (WinRT) secara langsung, termasuk banyak API terkait input dari Windows.Devices.Inputnamespace , , Windows.Gaming.Inputdan Windows.UI.Input . Anda tidak perlu membuat aplikasi UWP untuk mengakses kemampuan ini.

Ada beberapa hal yang perlu diperhatikan:

  • Bekerja di aplikasi WinUI 3 apa pun — Properti penunjuk (tekanan, kemiringan, tombol barel), deteksi perangkat, akses perangkat keras gamepad (Windows.Gaming.Input), dan input sentuh/mouse semuanya berfungsi tanpa konfigurasi khusus.
  • Memerlukan identitas paket (MSIX) — Beberapa API, seperti SpeechRecognizer dan SpeechSynthesizer, mengharuskan aplikasi Anda memiliki identitas paket. Templat proyek WinUI 3 default menggunakan kemasan MSIX, sehingga persyaratan ini terpenuhi secara otomatis untuk sebagian besar aplikasi.
  • Khusus UWP — API yang bergantung pada ApplicationView, CoreWindow, atau GetForCurrentView pola tidak tersedia di aplikasi desktop. Ini termasuk pelacakan tatapan (GazeInputSourcePreview) dan injeksi input (InputInjector). Untuk fitur-fitur ini, dokumentasi referensi UWP tetap menjadi sumber daya terbaik.

Untuk daftar lengkap API WinRT yang didukung dan tidak didukung di aplikasi desktop, lihat Windows Runtime API yang didukung di aplikasi desktop.

Tip

Topik di bagian ini yang menautkan ke dokumentasi UWP mencakup fitur yang menggunakan API khusus UWP. Anda masih dapat mereferensikan topik ini untuk panduan dan konsep desain, meskipun API tidak tersedia secara langsung di aplikasi desktop WinUI 3.

Get started

Topic Description
Input primer Biasakan diri Anda dengan setiap jenis perangkat input dan perilaku, kemampuan, dan batasannya saat dipasangkan dengan faktor bentuk tertentu.
Input pandangan Lacak tatapan pengguna berdasarkan lokasi dan pergerakan mata dan kepala mereka. API Gaze memerlukan UWP; lihat referensi UWP yang ditautkan.

Perangkat masukan

Topic Description
Mengidentifikasi perangkat input Identifikasi perangkat input yang terhubung ke perangkat aplikasi Windows dan identifikasi kemampuan dan atributnya.
Pointer Menerima, memproses, dan mengelola data input dari perangkat penunjuk seperti sentuhan, mouse, pena/stylus, dan touchpad.
Pena dan Tinta Windows Tangani properti input khusus pena seperti tekanan, kemiringan, tombol laras, dan deteksi penghapus pena.
Touch Tangani input sentuh, hadirkan pengalaman imersif yang dapat dijelajahi pengguna Anda dengan penuh percaya diri.
Tetikus Tangani input mouse di aplikasi Anda, termasuk klik tombol, roda gulir, dan gerakan penunjuk.
Papan ketik Menangani masukan keyboard, bagian penting dalam pengalaman interaksi dan sangat penting untuk aksesibilitas.
Gamepad dan remote control Desain untuk Xbox gamepad dan input kontrol jarak jauh. API Windows.Gaming.Input berfungsi langsung di aplikasi desktop WinUI 3; topik UWP yang ditautkan membahas pola desain untuk tampilan 10-foot.
Touchpad Tangani input pada touchpad, yang menggabungkan input multi-sentuh tidak langsung dengan presisi perangkat penunjuk.
Beberapa masukan Rancang aplikasi Anda untuk bekerja dengan jenis input sebanyak mungkin untuk memaksimalkan fleksibilitas, kegunaan, dan aksesibilitas.
Input teks khusus Gunakan API teks inti untuk menerima input teks dari layanan teks apa pun yang didukung pada perangkat Windows, dalam bahasa apa pun dan dari jenis input apa pun.

Interaksi

Topic Description
Seret dan letakkan Aktifkan interaksi seret dan lepas di aplikasi Anda.
Pengalih Panduan untuk menerapkan interaksi panning.
Rotasi Panduan untuk menerapkan interaksi rotasi.
Memilih teks dan gambar Panduan untuk memilih dan memanipulasi teks, gambar, dan kontrol.
Penargetan Panduan untuk penargetan sentuhan dan umpan balik visual.
Umpan balik visual Berikan umpan balik visual kepada pengguna selama interaksi.
Zoom optik dan pengubahan ukuran Panduan untuk memperbesar dan mengubah ukuran elemen.

Ucapan dan umpan balik

Topic Description
Pidato Integrasikan pengenalan ucapan dan teks ke ucapan langsung ke pengalaman pengguna aplikasi Anda. Memerlukan identitas paket.
Haptik Tambahkan umpan balik sentuh untuk memperkuat input pengguna dan membuat interaksi yang lebih responsif dan intuitif.
  • Last updated on