Integração com o seletor de widgets

Na versão atual, o único host de Widgets é o Widgets Board integrado no Windows 11. O Quadro de Widgets mostra os widgets e gere a sua disposição no quadro. Também fornece um seletor de widgets que permite ao utilizador selecionar quais os widgets disponíveis visíveis no quadro. Este artigo descreve os recursos necessários para que um widget se integre com sucesso no seletor de widgets.

Imagem de captura de ecrã do widget

Cada widget deve fornecer uma imagem de captura de ecrã que é exibida como pré-visualização no seletor de widgets quando o widget tem foco. A captura de ecrã é especificada pelo fornecedor do widget no manifesto do pacote da aplicação. Para informações técnicas sobre como especificar um ficheiro de imagem a usar para a captura de ecrã do widget, consulte Implementar um fornecedor de widgets numa aplicação win32 e o formato XML de manifesto do pacote Fornecedor de Widgets.

A captura de ecrã seguinte ilustra a colocação da imagem dentro do seletor de widgets.

Requisitos para imagens de captura de ecrã

Para proporcionar uma experiência de utilizador consistente, as capturas de ecrã dos widgets para o seletor de widgets devem seguir as seguintes diretrizes.

• A captura de ecrã deve mostrar a versão de tamanho médio do seu widget.
• A imagem deve ter 300 píxeis de largura e 304 píxeis de altura.
• A imagem deve ter cantos transparentes e arredondados.

O manifesto do fornecedor de widgets inclui três elementos diferentes de captura de ecrã que pode definir. A captura de ecrã de topo é obrigatória e será usada como padrão pelo seletor de widgets. As secções LightMode e DarkMode do manifesto são opcionais e permitem-te especificar capturas de ecrã separadas para o teu widget nos modos claro e escuro. Se fornecer uma ou ambas estas capturas de ecrã opcionais, o seletor de widgets usará aquela que corresponde ao tema atual do dispositivo. Se não fornecer uma imagem especificamente para o tema atual, o seletor de widgets usará a captura de ecrã padrão de topo.

Pode fornecer capturas de ecrã de widgets para vários locais. A localização de cada captura de ecrã é especificada com o caminho para o recurso em relação ao pacote da sua app.

• Crie um diretório no seu projeto de embalagem para os recursos de imagem. Por exemplo: "Ativos".
• Os assets neutros em termos de linguagem ou de recurso podem ser colocados diretamente nesta pasta. Por exemplo: "Assets/Screenshot.png"
• Recursos específicos da língua podem ser colocados em subdiretórios nomeados segundo a localidade a que se aplicam. Por exemplo:
  • Os ativos "Inglês (Estados Unidos)" devem ser colocados num subdiretório chamado "en-us": "Assets/en-us/Screenshot.png"
  • Os ativos "French (France)" devem ser colocados num subdiretório chamado "fr-fr": "Assets/fr-fr/Screenshot.png"
• Referenciar estas imagens no appxmanifest usando o esquema ms-appx:URI. Por exemplo: Screenshot="ms-appx:Assets\Screenshot.png"
• ** Se não incluir uma imagem para um local específico, será utilizada a imagem de recurso alternativo no diretório raiz.

O carregador de recursos escolherá automaticamente o ativo apropriado à língua a exibir. Para mais informações, veja: Carregar imagens e recursos adaptados à escala, tema, alto contraste e outros.

Segue-se um exemplo de imagem de captura de ecrã de widget.