Integrera med widgetväljaren

I den aktuella versionen är den enda Widgets-värden Widgets Board inbyggd i Windows 11. Widgets Board visar widgetar och hanterar deras layout på tavlan. Den innehåller också en widgetväljare som gör att användaren kan välja vilka tillgängliga widgetar som ska visas på tavlan. I den här artikeln beskrivs de tillgångar som krävs för att en widget ska kunna integreras i widgetväljaren.

Skärmbild av widget

Varje widget måste tillhandahålla en skärmbild som visas som en förhandsgranskning i widgetväljaren när widgeten har fokus. Skärmbilden anges av widgetprovidern i paketmanifestet för appen. Teknisk information om hur du anger en bildfil som ska användas för widgetens skärmbild finns i Implementera en widgetprovider i ett WIN32-program och Xml-format för widgetproviderns paketmanifest.

Följande skärmbild visar placeringen av skärmbilden i widgetväljaren.

Skärmbildsbildkrav

För att ge en konsekvent användarupplevelse måste widget-skärmbilder för widgetväljaren följa följande riktlinjer.

• Skärmbilden ska visa den medelstora versionen av widgeten.
• Bilden ska vara 300 bildpunkter bred och 304 bildpunkter hög.
• Bilden ska ha transparenta, rundade hörn.

Manifestet för widgetprovidern innehåller tre olika skärmbildselement som du kan ange. Skärmbilden på den översta nivån krävs och används som standard av widgetväljaren. Avsnitten LightMode och DarkMode i manifestet är valfria och gör att du kan ange separata skärmbilder för widgeten i ljust och mörkt läge. Om du anger en eller båda dessa valfria skärmbilder använder widgetväljaren den som matchar enhetens aktuella tema. Om du inte anger en bild specifikt för det aktuella temat använder widgetväljaren standardskärmbilden på den översta nivån i stället.

Du kan tillhandahålla widget-skärmbilder för flera nationella inställningar. Locale för varje skärmbild anges med sökvägen till resursen relativt till ditt apppaket.

• Skapa en katalog i ditt paketprojekt för bildresurserna. Exempel: "Tillgångar".
• De språkneutrala tillgångarna eller reservtillgångarna kan placeras direkt i den här mappen. Till exempel: "Assets/Screenshot.png"
• Språkspecifika tillgångar kan placeras i underkataloger med namnet efter de nationella inställningar som de gäller för. Till exempel:
  • "Engelska (USA)" tillgångar ska placeras i en underkatalog med namnet "en-us": "Tillgångar/en-us/Screenshot.png"
  • "Franska (Frankrike)" tillgångar bör placeras i en underkatalog med namnet "fr-fr": "Tillgångar/fr-fr/Screenshot.png"
• Referera till dessa bilder i appxmanifest med hjälp av ms-appx: URI-schemat. Exempel: Screenshot="ms-appx:Assets\Screenshot.png"
• Om du inte inkluderar en bild för en specifik lokalisering används standardbilden i rotkatalogen.

Resursinläsaren väljer automatiskt den språkanpassade tillgång som ska visas. För mer information, se: Läsa in bilder och resurser anpassade för skalning, tema, hög kontrast och andra faktorer.

Följande är ett exempel på en skärmbild av widgeten.