Windows Pencere Öğeleri ve Panoları Geliştirme

Widget'ler

Windows pencere öğeleri, yüklü bir uygulamayla ilişkili küçük kullanıcı arabirimi kapsayıcılarıdır. Widget Panosu bunları Windows masaüstü üzerinde, kişiselleştirilmiş içerik ve uygulamanızdan gelen hızlı işlemlerle birlikte ızgara düzeninde görüntüler. Bir JSON şablonuna veri bağlayan Uyarlamalı Kartlar ile içerik tanımlayabilir veya bir URL'den web pencere öğesi sağlayıcısı ile HTML görüntüleyebilirsiniz. Web pencere öğeleri, içerik URL'sini belirtmek için Adaptive Card JSON payload kullanmaya devam eder.

Tasarım kılavuzu için bkz. Windows Pencere öğeleri tasarımına genel bakış.

Pencere öğesi geliştirme yolu seçme

Uygulama yolunu ve açılacak sonraki konuyu seçmek için bu tabloyu kullanın.

Eğer istersen...	Bu yaklaşımı kullanın	Buradan başlayın
Paketlenmiş bir C# masaüstü uygulamasına Uyarlamalı Kart pencere öğesi ekleme	IWidgetProvider uygulayın, WidgetManager ile şablon ve veri güncelleştirmeleri gönderin ve sağlayıcıyı paket bildirimi aracılığıyla kaydedin.	C# pencere öğesi sağlayıcısı adım adım kılavuz
Paketlenmiş bir C++/WinRT masaüstü uygulamasına Uyarlamalı Kart pencere öğesi ekleme	İşlem dışı COM sunucusunda IWidgetProvider'ı uygulayın ve CLSID'ini ve widget tanımlarını paket bildirimine kaydedin.	C++/WinRT pencere öğesi sağlayıcısı kılavuzu
Masaüstü pencere öğesi içindeki URL'den HTML görüntüleme	Web pencere öğesi sağlayıcısı kullanın. Bu özellik yalnızca AEA'daki kullanıcılar tarafından kullanılabilir. Sağlayıcı yine de web URL'sini ve geri dönüş içeriğini içeren bir Uyarlamalı Kart yükü gönderir.	Web pencere öğesi sağlayıcıları
Mevcut bir Progressive Web App (PWA) için pencere öğesi ekleme	Pencere öğesini web uygulaması manifestosunda tanımlayın ve hizmet çalışanındaki pencere öğesi olaylarını işleyin. Bu, masaüstü IWidgetProvider yolundan ayrıdır.	PWA temelli pencere öğeleri oluşturma
Masaüstü sağlayıcınızda bir düğme veya form eylemini işleyin	Action.Execute komutunu kullanın ve eylemi OnActionInvoked içinde işleyin. Yalnızca $host.isUserContextAuthenticated doğru olduğunda göster.	Pencere öğesi şablonu oluştur
Sağlayıcı geri çağırması olmadan bir uygulama sayfasını veya web sitesini açın	Action.OpenUrl kullanın. Bu, widget kullanıcı bağlamı kimliği doğrulanmamışsa kullanılabilir durumda kalır.	Pencere öğesi şablonu oluştur
Kullanıcıların pencere öğesi yapılandırmasına izin ver	IWidgetProvider2 uygulayın, manifestin IsCustomizable özniteliğini ayarlayın ve özelleştirme yükü sağlayın.	Pencere öğesi özelleştirmesini uygula
Boyut, tema, ayarlar, üst bilgi, web desteği veya kimlik doğrulaması için içeriği uyarlama	Uyarlamalı Kart şablonunda Windows $host özelliklerini kullanın ve paket bildiriminde desteklenen her boyutu bildirin.	Windows pencere öğesi konağı özellikleri
Yükleme veya oturumu kapatılmış içeriği gösterme	Kasıtlı bir fallback şablonu ve veri gönderin. İçerik henüz kişiselleştirilmiş veya eyleme dönüştürülebilir olmadığında IsPlaceholderContent'i ayarlayın.	Widget sağlayıcıları
Tek bir pencere öğesi yerine bir pano akışı ekleyin	Bir akış sağlayıcısı uygulayın. Akış sağlayıcıları ayrı bir tümleştirmedir ve yalnızca EEA'da kullanılabilir.	Gösterge panoları ve akış sağlayıcıları
GitHub Copilot'dan widget oluşturmasını ve doğrulamasını isteyin	Desteklenen bir yol seçen ve paket, manifest, derleme ve Widgets Board doğrulaması gerektiren yeniden kullanılabilir istemi kullanın.	GitHub Copilot ile Windows widget’ı oluşturma

Dashboards

Akış sağlayıcıları, Bileşenler Panosu'nda gösterge panoları olarak görünen içerik akışlarını kaydeder. Akış sağlayıcısı, widget sağlayıcısından ayrı bir tümleştirmedir; HTML'nin bir widget içinde görüntülenmesi dashboard feed'ini kaydetmez.

Important

Akış sağlayıcıları yalnızca Avrupa Ekonomik Alanı'ndaki (EEA) kullanıcılar tarafından kullanılabilir. Kullanılabilirlik ve uygulama gereksinimleri için bkz. Gösterge panoları ve akış sağlayıcıları.

Bu bölümde

Başlık	Açıklama
Akış sağlayıcıları	Uygulamanızın içerik akışlarını doğrudan Windows Pencere Öğeleri Panosu'nda görünecek şekilde kaydetmeyi öğrenin.
Widget sağlayıcıları	Pencere öğeleriniz için içerik, düzen ve etkileşimli öğeler sağlayan bir pencere öğesi sağlayıcısı uygulamayı öğrenin.
Web pencere öğesi sağlayıcıları	HTML'i bir pencere öğesinde görüntüleyin ve sağlayıcınızla web içeriği arasındaki kaynak isteklerini ve iletilerini işleyin.
Uyarlamalı Kartlar Tasarımcısı	Uyarlamalı Kartlar Tasarımcısı'nı kullanarak bir widget şablonu oluşturmayı gözden geçirin.
GitHub Copilot ile Windows pencere öğesi oluşturma	Mevcut bir depoda pencere öğesi oluşturmak, paketlemek ve doğrulamak için yeniden kullanılabilir bir istem kullanın.