Поделиться через

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

  • Статья

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

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

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

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

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

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

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

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

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

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

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

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

{ 
    "type": "AdaptiveCard", 
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", 
    "version": "1.6", 
    "body": [
        ...
    ] ,
    "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": [
        ...
    ] ,
    "header": null
}