Integracja z selektorem widżetów

Tablica widżetów wbudowana w Windows 11 wyświetla widżety i zarządza ich układem. Jego selektor widżetów umożliwia użytkownikom wybranie dostępnych widżetów do dodania do tablicy. W tym artykule opisano składniki wymagane do zintegrowania spakowanego dostawcy widżetów pulpitu z tym wybierakiem. Aby zapoznać się z polami manifestu aplikacji PWA, zobacz Build PWA-driven widgets.

Obraz zrzutu ekranu widżetu

Każdy widżet musi podać obraz zrzutu ekranu wyświetlany jako podgląd w selektorze widżetów, gdy widżet ma fokus. Zrzut ekranu jest określany przez dostawcę widżetu w manifeście pakietu dla aplikacji. Aby uzyskać informacje techniczne dotyczące sposobu określania pliku obrazu do użycia w zrzucie ekranu widżetu, zobacz Implementowanie dostawcy widżetu w aplikacji Win32 oraz Format XML manifestu pakietu dostawcy widżetów.

Poniższy zrzut ekranu przedstawia umieszczanie obrazu zrzutu ekranu w selektorze widżetów.

Zrzut ekranu przedstawiający tablicę widżetów. Selektor widżetów jest aktywny i jest wyświetlany obraz zrzutu ekranu widżetu.

Wymagania dotyczące zrzutu ekranu

Aby zapewnić spójne środowisko użytkownika, zrzuty ekranu widżetu dla selektora widżetów muszą być zgodne z tymi wytycznymi.

  • Zrzut ekranu powinien wyświetlić wersję widżetu o średnim rozmiarze.
  • Obraz powinien mieć szerokość 300 pikseli i wysokość 304 pikseli.
  • Obraz powinien mieć przezroczyste, zaokrąglone rogi.

Manifest dostawcy widżetu zawiera trzy różne elementy zrzutu ekranu , które można ustawić. Zrzut ekranu z najwyższego poziomu jest wymagany i będzie używany jako domyślny przez wybierak widżetów. Sekcje LightMode i DarkMode manifestu są opcjonalne i umożliwiają określenie oddzielnych zrzutów ekranu dla widżetu w trybach jasnych i ciemnych. Jeśli podasz jeden lub oba z tych opcjonalnych zrzutów ekranu, selektor widżetu użyje tego, który pasuje do bieżącego motywu urządzenia. Jeśli nie podasz obrazu specjalnie dla bieżącego motywu, selektor widżetu użyje domyślnego zrzutu ekranu najwyższego poziomu.

Możesz udostępnić zrzuty ekranu widżetu dla wielu ustawień regionalnych. Ustawienia regionalne dla każdego zrzutu ekranu są określone ze ścieżką do zasobu względem pakietu aplikacji.

  • Utwórz katalog w projekcie pakowania dla zasobów obrazu. Na przykład: "Zasoby".
  • Zasoby neutralne dla języka lub rezerwowe można umieścić bezpośrednio w tym folderze. Na przykład: "Zasoby/Screenshot.png"
  • Zasoby specyficzne dla języka można umieścić w podkatalogach nazwanych zgodnie z lokalizacją, do której mają zastosowanie. Przykład:
    • Zasoby "Angielski (Stany Zjednoczone)" powinny być umieszczane w podkatalogu o nazwie "en-us": "Assets/en-us/Screenshot.png"
    • Zasoby "Francuski (Francja)" powinny zostać umieszczone w podkatalogu o nazwie "fr-fr": "Assets/fr-fr/Screenshot.png"
  • Odwołuj się do zasobu zapasowego za pomocą atrybutu Path względnego względem pakietu elementu Screenshot w obszarze ThemeResources/Screenshots. Przykład: <Screenshot Path="Assets\Screenshot.png" DisplayAltText="Preview of the widget" />. Nie używaj atrybutu Screenshot ani adresu URI ms-appx: w tym elemencie manifestu.
  • Jeśli nie dołączysz obrazu dla określonych ustawień regionalnych, zostanie użyty obraz rezerwowy w katalogu głównym.

Moduł ładujący zasobów automatycznie wybierze zasób odpowiedni dla danego języka do wyświetlenia. Aby uzyskać więcej informacji, zobacz: Ładowanie obrazów i zasobów dostosowanych do skali, motywu, dużego kontrastu i innych.

Poniżej przedstawiono przykład obrazu zrzutu ekranu widżetu.

Przykład obrazu zrzutu ekranu widżetu.