Integrar com o seletor de widget

Na versão atual, o único host de widgets é o Painel de Widgets integrado ao Windows 11. O Widgets Board exibe widgets e gerencia seu layout no quadro. Ele também fornece um seletor de widget que permite que o usuário selecione quais widgets disponíveis estão visíveis no quadro. Este artigo descreve os ativos necessários para que um widget se integre com êxito ao seletor de widget.

Imagem de captura de tela do widget

Cada widget deve fornecer uma imagem de captura de tela exibida como uma visualização no seletor de widget quando o widget tem foco. A captura de tela é especificada pelo provedor de widget no manifesto do pacote para o aplicativo. Para obter informações técnicas sobre como especificar um arquivo de imagem a ser usado para a captura de tela do widget, consulte Implementar um provedor de widget em um aplicativo win32 e formato XML do manifesto do pacote do provedor widget.

A captura de tela a seguir ilustra o posicionamento da imagem de captura de tela no seletor de widget.

Requisitos de imagem de captura de tela

Para fornecer uma experiência de usuário consistente, as capturas de tela do widget para o seletor de widget devem seguir as diretrizes a seguir.

• A captura de tela deve exibir a versão de tamanho médio do widget.
• A imagem deve ter 300 pixels de largura e 304 pixels de altura.
• A imagem deve ter cantos transparentes e arredondados.

O manifesto do provedor de widget inclui três elementos de captura de tela diferentes que você pode definir. A captura de tela de nível superior é necessária e será usada como padrão pelo seletor de widget. As seções LightMode e DarkMode do manifesto são opcionais e permitem que você especifique capturas de tela separadas para o widget em modos claro e escuro. Se você fornecer uma ou ambas as capturas de tela opcionais, o seletor de widget usará aquela que corresponde ao tema atual do dispositivo. Se você não fornecer uma imagem especificamente para o tema atual, o seletor de widget usará a captura de tela padrão de nível superior.

Você pode fornecer capturas de tela de widget para várias localidades. A localidade de cada captura de tela é especificada com o caminho para o ativo relativo ao pacote do aplicativo.

• Crie um diretório em seu projeto de empacotamento para os ativos de imagem. Por exemplo: "Ativos".
• Os ativos de fallback ou neutros de idioma podem ser colocados diretamente nessa pasta. Por exemplo: "Ativos/Screenshot.png"
• Os ativos específicos da linguagem podem ser colocados em subdiretórios com o nome da localidade à qual se aplicam. Por exemplo:
  • Os ativos "Inglês (Estados Unidos)" devem ser colocados em um subdiretório chamado "en-us": "Assets/en-us/Screenshot.png"
  • Os ativos "Francês (França)" devem ser colocados em um subdiretório chamado "fr-fr": "Assets/fr-fr/Screenshot.png"
• Faça referência a essas imagens no appxmanifest usando o esquema de URI ms-appx: . Por exemplo: Captura de tela="ms-appx:Assets\Screenshot.png"
• Se você não incluir uma imagem para uma localidade específica, a imagem de fallback no diretório raiz será usada.

O carregador de recursos escolherá automaticamente o ativo apropriado para o idioma a ser exibido. Para obter mais informações, consulte: Carregar imagens e ativos personalizados para escala, tema, alto contraste e outros.

Veja a seguir um exemplo de uma imagem de captura de tela do widget.