Giriş ve etkileşimler

WinUI uygulamaları çok çeşitli girişleri otomatik olarak işler ve çeşitli cihazlarda çalışır; örneğin, dokunma girişini etkinleştirmek için yapmanız gereken ek bir şey yoktur. Ancak bazı durumlarda uygulamanızı belirli giriş veya cihaz türleri için iyileştirmek isteyebilirsiniz. Örneğin, bir boyama uygulaması oluşturuyorsanız kalem girişini işleme yönteminizi özelleştirmek isteyebilirsiniz.

Bu bölümdeki tasarım ve kodlama yönergeleri, WinUI uygulamanızı belirli giriş türleri için özelleştirmenize yardımcı olur.

WinUI 3 masaüstü uygulamalarında Windows Çalışma Zamanı giriş API'lerini kullanma

WinUI 3 masaüstü uygulamaları, , Windows.Devices.Input ve Windows.Gaming.Input ad alanlarından girdiyle ilgili birçok API dahil olmak üzere, çoğu Windows.UI.Input doğrudan kullanabilir. Bu özelliklere erişmek için bir UWP uygulaması oluşturmanız gerekmez.

Dikkat etmeniz gereken birkaç şey vardır:

  • Herhangi bir WinUI 3 uygulamasında çalışır : İşaretçi özellikleri (basınç, eğme, namlu düğmesi), cihaz algılama, gamepad donanım erişimi (Windows.Gaming.Input) ve dokunmatik/fare girişi özel bir yapılandırma olmadan çalışır.
  • Paket kimliği (MSIX) gerektirir — SpeechRecognizer ve SpeechSynthesizer gibi bazı API'ler, uygulamanızınpaket kimliğine sahip olmasını gerektirir. Varsayılan WinUI 3 proje şablonu MSIX paketlemesini kullandığından çoğu uygulama için bu gereksinim otomatik olarak karşılanır.
  • Yalnızca UWP — ApplicationView, CoreWindow veya GetForCurrentView desene bağlı API'ler masaüstü uygulamalarında kullanılamaz. Buna bakış izleme (GazeInputSourcePreview) ve giriş ekleme (InputInjector) dahildir. Bu özellikler için UWP başvuru belgeleri en iyi kaynak olmaya devam eder.

Masaüstü uygulamalarında desteklenen ve desteklenmeyen WinRT API'lerinin tam listesi için bkz. Masaüstü uygulamalarında desteklenen Windows Çalışma Zamanı API'ler.

Tavsiye

Bu bölümdeki UWP belgelerine bağlantı veren konular, yalnızca UWP API'lerini kullanan özellikleri kapsar. API'ler WinUI 3 masaüstü uygulamalarında doğrudan kullanılamasa bile tasarım kılavuzu ve kavramları için bu konulara başvurabilirsiniz.

Get started

Başlık Description
Giriş astarı Belirli form faktörleriyle eşleştirildiğinde her giriş cihazı türü ve davranışları, özellikleri ve sınırlamaları hakkında bilgi sahibi olun.
Bakış girişi Bir kullanıcının bakışını göz ve kafasının konumuna ve hareketlerine göre takip edin. Bakış API'leri için UWP gereklidir; bağlantısı verilen UWP başvuru bilgilerine bakın.

Giriş cihazları

Başlık Description
Giriş cihazlarını tanımlama Bir Windows uygulama cihazına bağlı giriş cihazlarını ve bunların özelliklerini ve özniteliklerini belirleyin.
Işaretçi Dokunmatik, fare, kalem/ekran kalemi ve dokunmatik yüzey gibi işaret cihazlarından giriş verilerini alın, işleyin ve yönetin.
Kalem ve Windows Ink Basınç, eğim, gövde düğmesi ve silgi algılaması gibi kaleme özgü giriş özelliklerini işleyin.
Touch Dokunmatik girdileri işleyin ve kullanıcılarınızın güvenle keşfedebileceği sürükleyici deneyimler sunun.
Fare Düğme tıklamaları, kaydırma tekerleği ve işaretçi hareketi dahil olmak üzere uygulamanızda fare girişini işleyebilir.
Klavye Etkileşim deneyiminin önemli bir parçası olan ve erişilebilirlik için vazgeçilmez olan klavye girişini işleyin.
Oyun yüzeyi ve uzaktan kumanda Xbox gamepad’i ve uzaktan kumanda girdileri için tasarlayın. Windows. Gaming.Input API'leri doğrudan WinUI 3 masaüstü uygulamalarında çalışır; bağlantılı UWP konusu 3 metrelik tasarım desenlerini kapsar.
Dokunmatik yüzey Dolaylı çoklu dokunma girişini bir işaretleme aygıtının hassasiyetiyle birleştiren dokunmatik yüzey girişini işleyin.
Birden çok giriş Esnekliği, kullanılabilirliği ve erişilebilirliği en üst düzeye çıkarmak için uygulamanızı mümkün olduğunca çok giriş türüyle çalışacak şekilde tasarlar.
Özel metin girişi Windows cihazlarda desteklenen herhangi bir metin hizmetinden, herhangi bir dilde ve herhangi bir giriş türünden metin girişi almak için çekirdek metin API'lerini kullanın.

Etkileşimler

Başlık Description
Sürükle ve bırak Uygulamanızda sürükle ve bırak etkileşimlerini etkinleştirin.
Kaydırma Kaydırma etkileşimlerinin uygulanmasına ilişkin yönergeler.
Döndürme Döndürme etkileşimlerini uygulamaya yönelik yönergeler.
Metin ve resim seçme Metin, resim ve denetimleri seçme ve düzenleme yönergeleri.
Hedefleme Dokunma hedefleme ve görsel geri bildirim yönergeleri.
Görsel geri bildirim Etkileşimler sırasında kullanıcılara görsel geri bildirim sağlayın.
Optik yakınlaştırma ve yeniden boyutlandırma Öğeleri yakınlaştırma ve yeniden boyutlandırma yönergeleri.

Konuşma ve geri bildirim

Başlık Description
Konuşma Konuşma tanımayı ve metin okuma özelliğini doğrudan uygulamanızın kullanıcı deneyimiyle tümleştirin. Paket kimliği gerektirir.
Haptics Kullanıcı girişini güçlendirmek ve daha hızlı yanıt veren, sezgisel etkileşimler oluşturmak için dokunmatik geri bildirim ekleyin.
  • Last updated on