Personalizar a área de cabeçalho do widget

Na versão mais recente, os aplicativos que implementam widgets do Windows podem personalizar o cabeçalho exibido para seu widget no Painel de widgets, substituindo a apresentação padrão. A personalização do cabeçalho é implementada na carga útil do Adaptive Card que o/a utilizador/a passa para o sistema operativo a partir do seu fornecedor de widgets, e, portanto, os passos são os mesmos, independentemente do idioma em que o seu fornecedor de widgets é implementado. Para obter um passo a passo sobre como criar um provedor de widgets, consulte Implementar um provedor de widgets em um de aplicativos do Windows em C# ou Implementar um provedor de widgets em um aplicativo win32 (C++/WinRT).

O cabeçalho padrão

Por padrão, o cabeçalho do widget mostra o nome para exibição e o ícone especificado no arquivo de manifesto do aplicativo. O nome para exibição é especificado com o atributo DisplayName do elemento Definição e o ícone é especificado com um elemento Icon em ThemeResources. Para obter mais informações sobre o formato de arquivo de manifesto do aplicativo de widget, consulte Formato XML do manifesto do pacote do provedor de widgets.

O exemplo a seguir mostra uma parte da carga JSON do Adaptive Card para um widget que usa a apresentação padrão. Nas seções abaixo, serão fornecidos exemplos que modificam esse modelo para substituir o cabeçalho padrão.

{ 
    "type": "AdaptiveCard", 
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", 
    "version": "1.6", 
    "body": [
        ...
    ] 
  } 

Substituir a cadeia de caracteres de nome de exibição

Você pode substituir o valor especificado no elemento DisplayName no manifesto da aplicação, adicionando um campo header contendo o novo nome de exibição à carga JSON antes de enviá-lo para o anfitrião do widget.

O exemplo a seguir demonstra a substituição da cadeia de caracteres de nome de exibição.

{ 
    "type": "AdaptiveCard", 
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", 
    "version": "1.6", 
    "body": [
        ...
    ] ,
    "header": "Redmond Weather"
  } 

Sobrepor a cadeia de caracteres do nome para exibição e o ícone

Para substituir o nome de exibição e o ícone especificado no manifesto do aplicativo, adicione um objeto header com campos para text e iconUrl.

O exemplo a seguir demonstra a sobreposição da cadeia de caracteres do nome e do ícone para exibição.

{ 
    "type": "AdaptiveCard", 
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", 
    "version": "1.6", 
    "body": [
        ...
    ] ,
    "header": { 
         "text": "Redmond weather", 
         "iconUrl": "https://contoso.com/weatherimage.png" 
      } 
  } 

Definir o cabeçalho para estar vazio

Alguns provedores de widgets podem querer permitir que sua experiência do usuário completa se expanda para a região do cabeçalho do widget, mesmo que essa área do widget não seja acionável. Para esse cenário, podes definir o cabeçalho para estar vazio definindo a sensação de header como null. Observe que a experiência do usuário no cabeçalho não é clicável pelo usuário.

O exemplo a seguir demonstra a configuração de um cabeçalho vazio.

{ 
    "type": "AdaptiveCard", 
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", 
    "version": "1.6", 
    "body": [
        ...
    ] ,
    "header": null
}