Integrieren in die Widgetauswahl

Im aktuellen Release ist der einzige Widgets-Host das Widgets Board, das in Windows 11 integriert ist. Das Widgets Board zeigt Widgets an und verwaltet deren Layout auf dem Board. Außerdem wird eine Widgetauswahl bereitgestellt, mit der der Benutzer auswählen kann, welche verfügbaren Widgets auf dem Board sichtbar sind. In diesem Artikel werden die Ressourcen beschrieben, die für die erfolgreiche Integration eines Widgets in die Widgetauswahl erforderlich sind.

Screenshot des Widgets

Jedes Widget muss ein Screenshotbild bereitstellen, das als Vorschau in der Widgetauswahl angezeigt wird, wenn das Widget den Fokus hat. Der Screenshot wird vom Widgetanbieter im Paketmanifest für die App angegeben. Technische Informationen zum Angeben einer Bilddatei, die für das Widget verwendet werden soll, finden Sie unter Implementieren eines Widgetanbieters in einer Win32-App und im XML-Format des Paketmanifests des Widgetanbieters.

Der folgende Screenshot veranschaulicht die Platzierung des Screenshotbilds in der Widgetauswahl.

Screenshot: Anforderungen an das Bild

Um eine konsistente Benutzeroberfläche zu gewährleisten, müssen Widget-Screenshots für die Widgetauswahl die folgenden Richtlinien befolgen.

• Der Screenshot sollte die mittlere Version Ihres Widgets anzeigen.
• Das Bild sollte 300 Pixel breit und 304 Pixel hoch sein.
• Das Bild sollte transparente, abgerundete Ecken aufweisen.

Das Widgetanbietermanifest enthält drei verschiedene Screenshotelemente , die Sie festlegen können. Der Screenshot der obersten Ebene ist erforderlich und wird von der Widgetauswahl als Standard verwendet. Die Abschnitte LightMode und DarkMode des Manifests sind optional und ermöglichen es Ihnen, separate Screenshots für Ihr Widget im Hell- und Dunkelmodus anzugeben. Wenn Sie einen oder beide dieser optionalen Screenshots bereitstellen, verwendet die Widgetauswahl den, der dem aktuellen Design des Geräts entspricht. Wenn Sie kein Bild speziell für das aktuelle Design bereitstellen, verwendet die Widgetauswahl stattdessen den standardbasierten Screenshot der obersten Ebene.

Sie können Widget-Screenshots für mehrere Gebietsschemas bereitstellen. Das Gebietsschema für jeden Screenshot wird mit dem Pfad zum Asset relativ zu Ihrem App-Paket angegeben.

• Erstellen Sie ein Verzeichnis in Ihrem Paketprojekt für die Imageressourcen. Beispiel: "Assets".
• Die sprachneutralen Oder Fallbackressourcen können direkt in diesem Ordner platziert werden. Beispiel: "Assets/Screenshot.png"
• Sprachspezifische Ressourcen können in Unterverzeichnissen platziert werden, die nach dem Gebietsschema benannt sind, für das sie gelten. Beispiel:
  • "English (USA)" Assets sollten in einem Unterverzeichnis mit dem Namen "en-us" platziert werden: "Assets/en-us/Screenshot.png"
  • Assets "French (France)" sollten in einem Unterverzeichnis namens "fr-fr": "Assets/fr-fr/Screenshot.png" platziert werden.
• Verweisen Sie auf diese Bilder im appxmanifest mithilfe des URI-Schemas ms-appx: . Beispiel: Screenshot="ms-appx:Assets\Screenshot.png"
• Wenn Sie kein Image für ein bestimmtes Gebietsschema einschließen, wird das Fallbackimage im Stammverzeichnis verwendet.

Das Ressourcenladeprogramm wählt automatisch das sprachgerechte Medienobjekt aus, das angezeigt werden soll. Weitere Informationen finden Sie unter Laden von Bildern und Ressourcen, die auf Skalierung, Design, hohen Kontrast und andere zugeschnitten sind.

Im Folgenden sehen Sie ein Beispiel für ein Screenshotbild eines Widgets.