Pencere öğesi sağlayıcıları

Windows pencere öğeleri, bir Windows uygulaması veya Aşamalı Web Uygulaması (PWA) tarafından sağlanan içeriği görüntüleyen küçük kullanıcı arabirimi kapsayıcılarıdır. Adaptive Card şablonu ve verileri sağlayabilir veya URL'den HTML görüntülemek için bir web pencere öğesi kullanabilirsiniz. Web pencere öğeleri, içerik URL'sini belirtmek için Adaptive Card JSON payload kullanmaya devam eder.

Paketlenmiş bir masaüstü uygulaması için, pencere öğesi konağından gelen isteklere yanıt veren ve WidgetManager aracılığıyla güncelleştirmeler gönderen bir pencere öğesi sağlayıcısı uygularsınız. PWA, web uygulaması manifestindeki pencere öğesi tanımlarını kullanır ve service worker’da pencere öğesi olaylarını işler.

Kendi pencere öğelerinizi oluşturmaya yönelik Windows pencere öğeleri deneyimine ve tasarım kılavuzuna genel bakış için bkz. Windows pencere öğeleri.

Şu anda paketlenmiş bir Win32 masaüstü uygulaması veya Aşamalı Web Uygulaması (PWA) kullanarak bir pencere öğesi sağlayıcısı uygulayabilirsiniz. Daha fazla bilgi için bkz.:

• Bir Win32 uygulamasında widget sağlayıcısı uygulayın (C#)
• Bir Win32 uygulamasında pencere öğesi sağlayıcısı uygulayın (C++/WinRT)
• PWA temelli pencere öğeleri oluşturma
• Web pencere öğesi sağlayıcıları
• Pencere öğesi başlığını özelleştirme

Masaüstü pencere öğesi sağlayıcısı API'leri ve özellikleri

Pencere öğesi oluşturma, silme, etkinleştirme, bağlam değişiklikleri ve kullanıcı eylemleri için IWidgetProvider uygulayın. Özelleştirme veya web içeriği için isteğe bağlı arabirimler eklediğinizde temel arabirim gerekli kalır.

Kapasite	API veya kılavuz	Availability
Pencere öğesi yaşam döngüsü ve Uyarlamalı Kart güncelleştirmeleri	IWidgetProvider ve WidgetManager	Windows Uygulama SDK'sı 1.2
Kullanıcı özelleştirmesi	IWidgetProvider2 ve manifest dosyasının IsCustomizable özniteliği	Windows Uygulama SDK'sı 1.4
Web içeriği, kaynak istekleri ve mesajlaşma	Web pencere öğesi sağlayıcıları, IWidgetResourceProvider, IWidgetProviderMessage ve WidgetManager.SendMessageToContent	Windows Uygulama SDK'sı 1.6.3; ayrıca web-widget host ve bölgesel gereksinimleri denetleyin.
Henüz kişiselleştirilmiş veya eyleme dönüştürülebilir olmayan içeriği gösterme	WidgetUpdateRequestOptions.IsPlaceholderContent	Windows Uygulama SDK'sı 1.6.6
widget analitiği callback'leri	IWidgetProviderAnalytics	Windows Widget Panosu, Windows 11 derleme 26900’dan başlayarak bu geri çağırmaları destekler. Diğer konaklar da arabirimi desteklemelidir; API açıklamalarına bakın.

SDK sürümleri API'lerin ne zaman kullanılabilir olduğunu belirler, hangi sürümü yüklemeniz gerektiğini belirlemez. Windows Uygulama SDK'sı yayın kanallarından desteklenen kararlı bir sürüm kullanın ve hedef Windows cihazınızda ve widget konağınızda kullandığınız özellikleri test edin. Üst bilgi sunu seçenekleri için bkz. Widget üst bilgi alanını özelleştirme. PWA hizmet çalışanı API'si ayrı bir uygulama yoludur; bu tablodaki masaüstü arabirimleri buna uygulanmaz.

Widget sunucusu, sabitlenmiş pencere öğelerinin ömründen bağımsız olarak sağlayıcınızı etkinleştirebilir ve serbest bırakabilir. Sağlayıcı başlatıldığında pencere öğesi durumunu geri yükleyin ve IWidgetProvider geri çağırması tamamlandıktan sonra geri çağırma bağımsız değişken nesnelerini tutmayın. Daha fazla bilgi için bkz. IWidgetProvider açıklamaları.

TAM API başvurusu için Microsoft.Windows.Widgets.Providers ad alanı.

Bir pencere öğesi oluşturmanın ve bir pencere öğesi sağlayıcısı geliştirmenin temellerini adım adım öğrenmek için Tabs vs Spaces programının "Create Widgets for Windows 11" bölümünü izleyin.

Ek kaynaklar

• Windows Uygulama SDK'sı github deposunda bir sorun açma

İlgili makaleler

• Windows pencere öğeleri