Настройте область заголовка виджета

Приложения, реализующие мини-приложения Windows, могут настраивать заголовок, отображаемый для их мини-приложения в доске мини-приложений, переопределяя презентацию по умолчанию. Настройка заголовка реализуется в полезных данных адаптивной карточки, которые передаются в операционную систему от поставщика виджетов, поэтому шаги одинаковы независимо от языка, на котором реализован поставщик виджетов. Пошаговое руководство по созданию поставщика виджета вы можете найти в статье Реализация поставщика виджета в приложении на C# Windows или Реализация поставщика виджета в приложении на win32 (C++/WinRT).

Настройка заголовков зависит от того, поддерживает ли это хост. Свойство шаблона $host.isHeaderSupported указывает, поддерживает ли его хост; см. Свойства хоста мини-приложения Windows. Поле header — это расширение виджета Windows для полезной нагрузки карточки. Проверьте его отображение на панели Widgets, а не только в конструкторе Adaptive Cards общего назначения.

Заголовок по умолчанию

По умолчанию в заголовке мини-приложения отображается отображаемое имя и значок, указанный в файле манифеста приложения. Отображаемое имя задаётся с помощью атрибута DisplayName элемента Definition, а значок задаётся с помощью элемента Icon внутри ThemeResources. Дополнительные сведения о формате файла манифеста приложения мини-приложения см. в разделе Формат XML манифеста пакета мини-приложения.

В следующем примере показана часть JSON-данных адаптивной карточки для виджета, использующего стандартную презентацию. В разделах ниже приведены примеры, которые изменят этот шаблон, чтобы переопределить заголовок по умолчанию.

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

Переопределите строку отображаемого имени

Можно переопределить значение, указанное атрибутом DisplayName в манифесте приложения, добавив header поле с новым отображаемым именем в полезные данные JSON перед отправкой в хост виджета.

В следующем примере показано переопределение строки отображаемого имени.

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

Переопределите строку отображаемого имени и значок

Чтобы переопределить строку имени отображения и значок, указанный в манифесте приложения, добавьте объект header с полями для text и iconUrl.

В следующем примере показано переопределение строки отображаемого имени и значка.

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

Задайте для заголовка пустое значение

Некоторые поставщики мини-приложений могут позволить их полному пользовательскому интерфейсу расширяться в область заголовка мини-приложения, даже если эта область не является интерактивной. В этом случае можно сделать заголовок пустым, установив для поля header значение null. Обратите внимание, что UX в заголовке не кликабельный для пользователя.

В следующем примере показана установка пустого заголовка.

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