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 Widgets Board, substituindo a apresentação padrão. A personalização de cabeçalho é implementada no payload do Cartão Adaptável que você passa do provedor de widget para o sistema operacional, portanto, as etapas são as mesmas, independentemente do idioma em que o provedor de widget é implementado. Para um passo a passo sobre como criar um provedor de widget, consulte Implementar um provedor de widget em um aplicativo do Windows em C# ou Implementar um provedor de widget em um aplicativo Win32 (C++/WinRT).

O cabeçalho padrão

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

O exemplo a seguir mostra uma parte do conteúdo JSON do Cartão Adaptável 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 do nome de exibição

Você pode substituir o valor especificado no elemento DisplayName no manifesto do aplicativo adicionando um campo header com o novo nome de exibição no payload JSON antes de enviá-lo para o host do widget.

O exemplo a seguir demonstra como substituir a cadeia de caracteres do nome de exibição.

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

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

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

O exemplo a seguir demonstra como sobrescrever a cadeia de caracteres do nome de exibição e o ícone.

{ 
    "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 como vazio

Alguns provedores de widget podem querer permitir que a UX completa se expanda para a região de cabeçalho do widget, mesmo que essa área do widget não seja acionável. Para esse cenário, você pode definir o cabeçalho como vazio definindo a header sensação de null. Observe que o UX no cabeçalho não pode ser clicado 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
}