Схема содержимого плитки

  • Статья

Ниже описаны все свойства и элементы в содержимом плитки.

Если вы предпочитаете использовать необработанный XML вместо библиотеки уведомлений, см . схему XML.

TileContent

TileContent

TileContent — это объект верхнего уровня, описывающий содержимое уведомления плитки, включая визуальные элементы.

Свойство Тип Обязательно Описание
Визуальный элемент ToastVisual true Описывает визуальную часть уведомления плитки.

TileVisual

Визуальная часть плиток содержит визуальные спецификации для всех размеров плиток и дополнительные свойства, связанные с визуальными элементами.

Свойство Тип Обязательно Описание
ПлиткаSmall TileBinding false Укажите необязательную небольшую привязку, чтобы указать содержимое для небольшого размера плитки.
TileMedium TileBinding false Предоставьте необязательную среднюю привязку, чтобы указать содержимое для среднего размера плитки.
TileWide TileBinding false Предоставьте необязательную широкую привязку, чтобы указать содержимое для размера широкой плитки.
TileLarge TileBinding false Предоставьте необязательную большую привязку, чтобы указать содержимое для большого размера плитки.
Фирменная символика. TileBranding false Форма, используемая плиткой для отображения фирменной символики приложения. По умолчанию наследует фирменную символику от плитки по умолчанию.
Отображаемое имя строка false Необязательная строка для переопределения отображаемого имени плитки при отображении этого уведомления.
Аргументы строка false Новое в юбилейном обновлении: определяемые приложением данные, передаваемые в приложение с помощью свойства TileActivatedInfo в LaunchActivatedEventArgs, когда пользователь запускает приложение из динамической плитки. Это позволяет узнать, какие уведомления о плитках отображаются пользователем, когда они коснулись динамической плитки. На устройствах без юбилейного обновления это просто будет игнорироваться.
LockDetailedStatus1 строка false Если указать это, необходимо также указать привязку TileWide. Это первая строка текста, которая будет отображаться на экране блокировки, если пользователь выбрал плитку в качестве подробного приложения состояния.
LockDetailedStatus2 строка false Если указать это, необходимо также указать привязку TileWide. Это вторая строка текста, которая будет отображаться на экране блокировки, если пользователь выбрал плитку в качестве подробного приложения состояния.
LockDetailedStatus3 строка false Если указать это, необходимо также указать привязку TileWide. Это третья строка текста, которая будет отображаться на экране блокировки, если пользователь выбрал плитку в качестве подробного приложения состояния.
Baseuri URI-адрес false Базовый URL-адрес по умолчанию, объединенный с относительными URL-адресами в атрибутах источника изображения.
AddImageQuery Bool? false Задайте значение true, чтобы разрешить Windows добавлять строку запроса к URL-адресу изображения, предоставленному в всплывающем уведомлении. Используйте этот атрибут, если сервер размещает изображения и может обрабатывать строки запроса, извлекая вариант изображения на основе строк запроса или игнорируя строку запроса и возвращая изображение, как указано без строки запроса. Эта строка запроса задает масштаб, параметр контрастности и язык; например, значение "www.website.com/images/hello.png", заданное в уведомлении, становится "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"
Язык string false Целевой языковой стандарт визуальной полезных данных при использовании локализованных ресурсов, указанных в виде тегов языка BCP-47, таких как en-US или fr-FR. Этот языковой стандарт переопределяется любым языковым стандартом, указанным в привязке или тексте. Если это не указано, вместо этого будет использоваться языковой стандарт системы.

TileBinding

Объект привязки содержит визуальное содержимое для определенного размера плитки.

Свойство Тип Обязательно Описание
Содержимое ITileBindingContent false Визуальное содержимое, отображаемое на плитке. Один из TileBindingContentAdaptive, TileBindingContentIconic, TileBindingContentContact, TileBindingContent Люди или TileBindingContentPhotos.
Фирменная символика. TileBranding false Форма, используемая плиткой для отображения фирменной символики приложения. По умолчанию наследует фирменную символику от плитки по умолчанию.
Отображаемое имя строка false Необязательная строка для переопределения отображаемого имени плитки для этого размера плитки.
Аргументы строка false Новое в юбилейном обновлении: определяемые приложением данные, передаваемые в приложение с помощью свойства TileActivatedInfo в LaunchActivatedEventArgs, когда пользователь запускает приложение из динамической плитки. Это позволяет узнать, какие уведомления о плитках отображаются пользователем, когда они коснулись динамической плитки. На устройствах без юбилейного обновления это просто будет игнорироваться.
Baseuri URI-адрес false Базовый URL-адрес по умолчанию, объединенный с относительными URL-адресами в атрибутах источника изображения.
AddImageQuery Bool? false Задайте значение true, чтобы разрешить Windows добавлять строку запроса к URL-адресу изображения, предоставленному в всплывающем уведомлении. Используйте этот атрибут, если сервер размещает изображения и может обрабатывать строки запроса, извлекая вариант изображения на основе строк запроса или игнорируя строку запроса и возвращая изображение, как указано без строки запроса. Эта строка запроса задает масштаб, параметр контрастности и язык; например, значение "www.website.com/images/hello.png", заданное в уведомлении, становится "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"
Язык string false Целевой языковой стандарт визуальной полезных данных при использовании локализованных ресурсов, указанных в виде тегов языка BCP-47, таких как en-US или fr-FR. Этот языковой стандарт переопределяется любым языковым стандартом, указанным в привязке или тексте. Если это не указано, вместо этого будет использоваться языковой стандарт системы.

ITileBindingContent

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

Реализации
TileBindingContentAdaptive
TileBindingContentIconic
TileBindingContentContentContact
TileBindingContent Люди
TileBindingContentPhotos

TileBindingContentAdaptive

Поддерживается для всех размеров. Это рекомендуемый способ указания содержимого плитки. Шаблоны адаптивных плиток, новые в Windows 10, и вы можете создавать разнообразные пользовательские плитки с помощью адаптивных.

Свойство Тип Обязательно Описание
Children IList<ITileBindingContentAdaptiveChild> false Встроенные визуальные элементы. Можно добавлять объекты AdaptiveText, AdaptiveImage и AdaptiveGroup . Дети отображаются в вертикальном стиле StackPanel.
Backgroundimage TileBackgroundImage false Необязательный фоновый образ, который отображается за всем содержимым плитки, полностью отложенным.
PeekImage TilePeekImage false Необязательный образ, который анимирует в верхней части плитки.
TextStacking TileTextStacking false Управляет стеком текста (вертикальное выравнивание) дочернего содержимого в целом.

AdaptiveText

Адаптивный текстовый элемент.

Свойство Тип Обязательно Описание
Текст строка false Текст для отображения.
HintStyle AdaptiveTextStyle false Стиль определяет размер шрифта, вес и прозрачность текста.
HintWrap Bool? false Задайте для этого значение true, чтобы включить оболочку текста. По умолчанию значение false.
HintMaxLines Int? false Максимальное количество строк текстового элемента разрешено отображать.
HintMinLines Int? false Минимальное количество строк текстового элемента должно отображаться.
HintAlign AdaptiveTextAlign false Горизонтальное выравнивание текста.
Язык string false Целевой языковой стандарт полезных данных XML, указанный в виде тегов языка BCP-47, таких как en-US или fr-FR. Языковой стандарт, указанный здесь, переопределяет любой другой указанный языковой стандарт, например в привязке или визуальном элементе. Если это значение является литеральной строкой, этот атрибут по умолчанию использует язык пользовательского интерфейса пользователя. Если это значение является строковой ссылкой, этот атрибут по умолчанию использует языковой стандарт, выбранный среда выполнения Windows при разрешении строки.

AdaptiveTextStyle

Стиль текста определяет размер шрифта, вес и прозрачность. Тонкое непрозрачность составляет 60 % непрозрачности.

Значение Значение
По умолчанию Значение по умолчанию. Стиль определяется отрисовщиком.
Заголовок Меньше размера шрифта абзаца.
CaptionSubtle То же самое, что и заголовок, но с тонкой непрозрачностью.
Текст Размер шрифта абзаца.
BodySubtle То же, что и тело, но с тонкой непрозрачностью.
Основание Размер шрифта абзаца, полужирный вес. По существу полужирная версия Body.
BaseSubtle То же, что и Base, но с тонкой непрозрачностью.
Subtitle Размер шрифта H4.
Субтитры То же, что и подзаголовок, но с тонким непрозрачностью.
Заголовок Размер шрифта H3.
TitleSubtle То же самое, что и Заголовок, но с тонким непрозрачностью.
TitleNumeral То же, что и заголовок, но с верхним или нижним заполнением удалено.
Подзаголовок Размер шрифта H2.
ПодзаголовокSubtle То же самое, что подзаголовок, но с тонкой непрозрачностью.
ПодзаголовокNumeral То же, что и подзаголовок, но с удаленным верхним или нижним заполнением.
Верхний колонтитул Размер шрифта H1.
HeaderSubtle То же самое, что заголовок, но с тонкой непрозрачностью.
HeaderNumeral То же самое, что и заголовок, но с верхним или нижним заполнением удалено.

AdaptiveTextAlign

Управляет горизонтальными выравниванием текста.

Значение Значение
По умолчанию Значение по умолчанию. Выравнивание автоматически определяется отрисовщиком.
Автоматически Выравнивание, определенное текущим языком и языком и языком и региональными параметрами.
Left Горизонтально выровнять текст слева.
Центр Горизонтально выровнять текст в центре.
Right Горизонтально выровнять текст справа.

AdaptiveImage

Встроенный образ.

Свойство Тип Обязательно Описание
Источник строка true URL-адрес изображения. поддерживаются ms-appx, ms-appdata и http. По состоянию на Fall Creators Update веб-образы могут быть до 3 МБ для обычных подключений и 1 МБ на лимитных подключениях. На устройствах, не работающих в Fall Creators Update, веб-образы не должны превышать 200 КБ.
HintCrop AdaptiveImageCrop false Управление требуемой обрезки изображения.
HintRemoveMargin Bool? false По умолчанию изображения внутри групп или подгрупп имеют вокруг них поле 8px. Это поле можно удалить, задав для этого свойства значение true.
HintAlign AdaptiveImageAlign false Горизонтальное выравнивание изображения.
Альтернативный текст строка false Альтернативный текст, описывающий изображение, используемый для специальных возможностей.
AddImageQuery Bool? false Задайте значение true, чтобы разрешить Windows добавлять строку запроса к URL-адресу изображения, предоставленному в уведомлении плитки. Используйте этот атрибут, если сервер размещает изображения и может обрабатывать строки запроса, извлекая вариант изображения на основе строк запроса или игнорируя строку запроса и возвращая изображение, как указано без строки запроса. Эта строка запроса задает масштаб, параметр контрастности и язык; например, значение "www.website.com/images/hello.png", заданное в уведомлении, становится "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

AdaptiveImageCrop

Указывает требуемое обрезка изображения.

Значение Значение
По умолчанию Значение по умолчанию. Обрезка поведения, определяемого отрисовщиком.
Не допускается Изображение не обрезано.
Круг Изображение обрезается к фигуре круга.

AdaptiveImageAlign

Указывает горизонтальное выравнивание изображения.

Значение Значение
По умолчанию Значение по умолчанию. Поведение выравнивания, определяемое отрисовщиком.
Стрейч Изображение растянуто для заполнения доступной ширины (и потенциально доступной высоты в зависимости от места размещения изображения).
Left Выровняйте изображение слева, отображая изображение в собственном разрешении.
Центр Выровняйте изображение в центре по горизонтали, отображайте изображение в собственном разрешении.
Right Выровняйте изображение справа, отображая изображение в собственном разрешении.

AdaptiveGroup

Группы семантически определяют, что содержимое в группе должно отображаться в целом или не отображаться, если оно не может соответствовать. Группы также позволяют создавать несколько столбцов.

Свойство Тип Обязательно Описание
Children IList<AdaptiveSubgroup> false Подгруппы отображаются как вертикальные столбцы. Необходимо использовать подгруппы для предоставления содержимого в адаптивной группе.

AdaptiveSubgroup

Подгруппы — это вертикальные столбцы, которые могут содержать текст и изображения.

Свойство Тип Обязательно Описание
Children IList<IAdaptiveSubgroupChild> false AdaptiveText и AdaptiveImage являются допустимыми дочерними элементами подгрупп.
HintWeight Int? false Определите ширину этого подгруппного столбца, указав вес относительно других подгрупп.
HintTextStacking AdaptiveSubgroupTextStacking false Управление вертикальным выравниванием содержимого этой подгруппы.

IAdaptiveSubgroupChild

Интерфейс маркера для дочерних групп.

Реализации
AdaptiveText
AdaptiveImage

AdaptiveSubgroupTextStacking

TextStacking указывает вертикальное выравнивание содержимого.

Значение Значение
По умолчанию Значение по умолчанию. Отрисовщик автоматически выбирает выравнивание по умолчанию по вертикали.
Top Вертикальное выравнивание по верхней части.
Центр Вертикальное выравнивание по центру.
Снизу Вертикальное выравнивание по нижнему краю.

TileBackgroundImage

Фоновое изображение, отображаемое на плитке, полностью отложено.

Свойство Тип Обязательно Описание
Источник строка true URL-адрес изображения. поддерживаются ms-appx, ms-appdata и http(s). Изображения HTTP должны иметь размер 200 КБ или меньше.
HintOverlay Int? false Черное наложение на фоновое изображение. Это значение управляет непрозрачностью черной наложения, при этом 0 не наложение и 100 полностью черный. По умолчанию установлено значение 20.
HintCrop TileBackgroundImageCrop false Новое в 1511: укажите способ обрезки изображения. В версиях до 1511 это будет игнорироваться, а фоновое изображение будет отображаться без обрезки.
Альтернативный текст строка false Альтернативный текст, описывающий изображение, используемый для специальных возможностей.
AddImageQuery Bool? false Задайте значение true, чтобы разрешить Windows добавлять строку запроса к URL-адресу изображения, предоставленному в уведомлении плитки. Используйте этот атрибут, если сервер размещает изображения и может обрабатывать строки запроса, извлекая вариант изображения на основе строк запроса или игнорируя строку запроса и возвращая изображение, как указано без строки запроса. Эта строка запроса задает масштаб, параметр контрастности и язык; например, значение "www.website.com/images/hello.png", заданное в уведомлении, становится "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

TileBackgroundImageCrop

Управляет обрезка фонового изображения.

Значение Значение
По умолчанию Обрезка использует поведение отрисовщика по умолчанию.
Не допускается Изображение не обрезано, отображается квадрат.
Круг Изображение обрезается к кругу.

TilePeekImage

Изображение, которое анимирует из верхней части плитки.

Свойство Тип Обязательно Описание
Источник строка true URL-адрес изображения. поддерживаются ms-appx, ms-appdata и http(s). Изображения HTTP должны иметь размер 200 КБ или меньше.
HintOverlay Int? false Новое в 1511: черное наложение на изображение. Это значение управляет непрозрачностью черной наложения, при этом 0 не наложение и 100 полностью черный. По умолчанию установлено значение 20. В предыдущих версиях это значение будет игнорироваться, и изображение будет отображаться с наложением 0.
HintCrop TilePeekImageCrop false Новое в 1511: укажите способ обрезки изображения. В версиях до 1511 это будет игнорироваться, и изображение будет отображаться без обрезки.
Альтернативный текст строка false Альтернативный текст, описывающий изображение, используемый для специальных возможностей.
AddImageQuery Bool? false Задайте значение true, чтобы разрешить Windows добавлять строку запроса к URL-адресу изображения, предоставленному в уведомлении плитки. Используйте этот атрибут, если сервер размещает изображения и может обрабатывать строки запроса, извлекая вариант изображения на основе строк запроса или игнорируя строку запроса и возвращая изображение, как указано без строки запроса. Эта строка запроса задает масштаб, параметр контрастности и язык; например, значение "www.website.com/images/hello.png", заданное в уведомлении, становится "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

TilePeekImageCrop

Управляет обрезкой изображения.

Значение Значение
По умолчанию Обрезка использует поведение отрисовщика по умолчанию.
Не допускается Изображение не обрезано, отображается квадрат.
Круг Изображение обрезается к кругу.

TileTextStacking

Стек текста указывает вертикальное выравнивание содержимого.

Значение Значение
По умолчанию Значение по умолчанию. Отрисовщик автоматически выбирает выравнивание по умолчанию по вертикали.
Top Вертикальное выравнивание по верхней части.
Центр Вертикальное выравнивание по центру.
Снизу Вертикальное выравнивание по нижнему краю.

TileBindingContentIconic

Поддерживается на малых и средних. Включает знаковый шаблон плитки, где вы можете иметь значок и индикатор индикатора событий рядом с плиткой в классическом стиле Windows Телефон. Число рядом с значком достигается с помощью отдельного уведомления о значке.

Свойство Тип Обязательно Описание
Значок TileBasicImage true Как минимум, для поддержки плиток Desktop и Mobile, Small and Medium, предоставьте квадратное соотношение пропорций изображения с разрешением 200x200, формат PNG с прозрачностью и без цвета, отличного от белого. Дополнительные сведения см. в разделе "Специальные шаблоны плиток".

TileBindingContentContentContact

Только для мобильных устройств. Поддерживается для небольших, средних и широких размеров.

Свойство Тип Обязательно Описание
Image TileBasicImage true Отображаемое изображение.
Text TileBasicText false Строка отображаемого текста. Не отображается на небольшой плитке.

TileBindingContent Люди

Новые возможности в версии 1511: поддерживается на средних, широких и крупных (настольных и мобильных устройствах). Ранее это был только мобильный и только средний и широкий.

Свойство Тип Обязательно Описание
Изображения IList<TileBasicImage> true Изображения, которые будут свернуты как круги.

TileBindingContentPhotos

Анимирует слайд-шоу фотографий. Поддерживается для всех размеров.

Свойство Тип Обязательно Описание
Изображения IList<TileBasicImage> true Можно предоставить до 12 изображений (мобильные устройства будут отображаться только до 9), которые будут использоваться для слайд-шоу. Добавление более 12 вызовет исключение.

TileBasicImage

Изображение, используемое для различных специальных шаблонов.

Свойство Тип Обязательно Описание
Источник строка true URL-адрес изображения. поддерживаются ms-appx, ms-appdata и http(s). Изображения HTTP должны иметь размер 200 КБ или меньше.
Альтернативный текст строка false Альтернативный текст, описывающий изображение, используемый для специальных возможностей.
AddImageQuery Bool? false Задайте значение true, чтобы разрешить Windows добавлять строку запроса к URL-адресу изображения, предоставленному в уведомлении плитки. Используйте этот атрибут, если сервер размещает изображения и может обрабатывать строки запроса, извлекая вариант изображения на основе строк запроса или игнорируя строку запроса и возвращая изображение, как указано без строки запроса. Эта строка запроса задает масштаб, параметр контрастности и язык; например, значение "www.website.com/images/hello.png", заданное в уведомлении, становится "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

TileBasicText

Базовый текстовый элемент, используемый для различных специальных шаблонов.

Свойство Тип Обязательно Описание
Текст строка false Текст для отображения.
Язык string false Целевой языковой стандарт полезных данных XML, указанный в виде тегов языка BCP-47, таких как en-US или fr-FR. Языковой стандарт, указанный здесь, переопределяет любой другой указанный языковой стандарт, например в привязке или визуальном элементе. Если это значение является литеральной строкой, этот атрибут по умолчанию использует язык пользовательского интерфейса пользователя. Если это значение является строковой ссылкой, этот атрибут по умолчанию использует языковой стандарт, выбранный среда выполнения Windows при разрешении строки.