Integrace s nástrojem pro výběr widgetu

V aktuální verzi je jediným hostitelem widgetů panel Widgets integrovaný do Windows 11. Panel widgetů zobrazuje widgety a spravuje jejich rozložení na panelu. Poskytuje také nástroj pro výběr widgetu, který uživateli umožňuje vybrat, které dostupné widgety jsou viditelné na panelu. Tento článek popisuje prostředky potřebné k úspěšné integraci widgetu do nástroje pro výběr widgetu.

Obrázek snímku obrazovky widgetu

Každý widget musí obsahovat obrázek snímku obrazovky, který se zobrazí jako náhled ve výběru widgetu, když má widget fokus. Snímek obrazovky je určený poskytovatelem widgetu v manifestu balíčku aplikace. Technické informace o tom, jak specifikovat soubor obrázku pro snímek widgetu, najdete v Implementace zprostředkovatele widgetu v aplikaci win32 a formát XML manifestu balíčku zprostředkovatele widgetu.

Následující snímek obrazovky znázorňuje umístění obrázku snímku obrazovky v rámci výběru widgetu.

Požadavky na obrázek snímku obrazovky

Aby bylo možné zajistit konzistentní uživatelské prostředí, musí snímky obrazovek widgetu pro výběr widgetu dodržovat následující pokyny.

• Na snímku obrazovky by se měla zobrazit středně velká verze widgetu.
• Obrázek by měl mít šířku 300 pixelů a výšku 304 pixelů.
• Obrázek by měl mít průhledné zaoblené rohy.

Manifest zprostředkovatele widgetu obsahuje tři různé prvky snímku obrazovky , které můžete nastavit. Snímek obrazovky nejvyšší úrovně je povinný a ve výchozím nastavení se použije pro výběr widgetu. Oddíly LightMode a DarkMode manifestu jsou volitelné a umožňují určit samostatné snímky obrazovek widgetu ve světlých a tmavých režimech. Pokud zadáte jeden nebo oba tyto volitelné snímky obrazovky, nástroj pro výběr widgetu použije ten, který odpovídá aktuálnímu motivu zařízení. Pokud nezadáte obrázek speciálně pro aktuální motiv, nástroj pro výběr widgetu místo toho použije výchozí snímek obrazovky nejvyšší úrovně.

Můžete zadat snímky obrazovek widgetu pro více národních prostředí. Národní prostředí pro každý snímek obrazovky se zadává s cestou k prostředku vzhledem k vašemu balíčku aplikace.

• Vytvořte adresář v projektu balíčku pro obrazové soubory. Například: "Prostředky".
• Jazykově neutrální nebo záložní prostředky lze umístit přímo do této složky. Například: "Prostředky/Screenshot.png"
• Prostředky specifické pro jazyk lze umístit do podadresářů pojmenovaných podle národního prostředí, na které se vztahují. Například:
  • Prostředky "Angličtina (Spojené státy)" by měly být umístěny v podadresáři s názvem "en-us": "Assets/en-us/Screenshot.png"
  • "Soubory pro 'francouzštinu (Francie)' by měly být umístěny v podadresáři s názvem 'fr-fr': 'Assets/fr-fr/Screenshot.png'"
• Použijte schéma URI ms-appx: pro odkazování na tyto obrázky v appxmanifestu. Příklad: Screenshot="ms-appx:Assets\Screenshot.png"
• Pokud image pro konkrétní národní prostředí nezadáte, použije se záložní image v kořenovém adresáři.

Zavaděč zdrojů automaticky zvolí jazykově vhodný zdroj k zobrazení. Další informace najdete v tématu: Načítání obrázků a prostředků přizpůsobených pro škálování, motiv, vysoký kontrast a další.

Následuje příklad obrázku snímku obrazovky widgetu.