Widget seçici ile entegre etme

Geçerli sürümde yalnızca Pencere Öğeleri konağı Windows 11'de yerleşik pencere öğeleri panosudur. Widget Panosu, widget'ları görüntüler ve panodaki düzenlerini yönetir. Ayrıca kullanıcının panoda hangi bileşenlerin görüneceğini seçmesine olanak tanıyan bir bileşen seçici de sağlar. Bu makalede, pencere öğesinin pencere öğesi seçiciyle başarıyla tümleştirilmesi için gereken varlıklar açıklanmaktadır.

Widget ekran görüntüsü

Her widget, odağı olduğunda widget seçicisinde önizleme olarak görüntülenecek bir ekran görüntüsü sağlamalıdır. Ekran görüntüsü, uygulamanın paket bildiriminde pencere öğesi sağlayıcısı tarafından belirtilir. Pencere öğesi ekran görüntüsü için kullanılacak bir görüntü dosyasını belirtme hakkında teknik bilgi için bkz. Win32 uygulamasında pencere öğesi sağlayıcısı uygulama ve Pencere öğesi sağlayıcı paketi bildirim XML biçiminde.

Aşağıdaki ekran görüntüsünde ekran görüntüsü görüntüsünün pencere öğesi seçici içindeki yerleşimi gösterilmektedir.

Ekran görüntüsü gereksinimleri

Tutarlı bir kullanıcı deneyimi sağlamak için, pencere öğesi seçicisinin pencere öğesi ekran görüntülerinin bu yönergeleri izlemesi gerekir.

• Ekran görüntüsünde pencere öğesinizin orta büyüklükteki sürümü görüntülenmelidir.
• Görüntü 300 piksel genişliğinde ve 304 piksel uzunluğunda olmalıdır.
• Resmin saydam, yuvarlak köşeleri olmalıdır.

Pencere öğesi sağlayıcısı bildirimi, ayarlayabileceğiniz üç farklı Ekran Görüntüsü öğesi içerir. En üst düzey ekran görüntüsü gereklidir ve pencere öğesi seçici tarafından varsayılan olarak kullanılır. Bildirimin LightMode ve DarkMode bölümleri isteğe bağlıdır ve pencere öğesiniz için açık ve koyu modlarda ayrı ekran görüntüleri belirtmenize olanak tanır. Bu isteğe bağlı ekran görüntülerinden birini veya her ikisini de sağlarsanız, pencere öğesi seçici cihazın geçerli temasıyla eşleşen ekran görüntüsünü kullanır. Geçerli tema için özel olarak bir resim sağlamazsanız, pencere öğesi seçici bunun yerine varsayılan, en üst düzey ekran görüntüsünü kullanır.

Birden çok dil veya bölge için pencere öğesi ekran görüntüleri sağlayabilirsiniz. Her ekran görüntüsü için yerel ayar, uygulama paketinize göre varlığın yolu ile belirtilir.

• Görüntü varlıkları için paketleme projenizde bir dizin oluşturun. Örneğin: "Varlıklar".
• Dilden bağımsız veya yedek varlıklar doğrudan bu klasöre yerleştirilebilir. Örneğin: "Varlıklar/Screenshot.png"
• Dile özgü varlıklar, uygulanacak yerel ayarların adını taşıyan alt dizinlere yerleştirilebilir. Örneğin:
  • "İngilizce (ABD)" varlıkları "en-us": "Assets/en-us/Screenshot.png" adlı bir alt dizine yerleştirilmelidir
  • "Fransızca (Fransa)" varlıkları "fr-fr" adlı bir alt dizine yerleştirilmelidir: "Assets/fr-fr/Screenshot.png"
• ms-appx: URI düzenini kullanarak appxmanifest'te bu görüntülere başvurun. Örneğin: Screenshot="ms-appx:Assets\Screenshot.png"
• Belirli bir yerel ayar için görüntü eklemezseniz, kök dizindeki yedek görüntü kullanılır.

Kaynak yükleyici, görüntülenecek dile uygun varlığı otomatik olarak seçer. Daha fazla bilgi için bkz. Ölçek, tema, yüksek karşıtlık ve diğerleri için uyarlanmış görüntüleri ve varlıkları yükleme.

Aşağıda bir pencere öğesi ekran görüntüsü örneği verilmiştir.