Схема содержимого плитки
Примечание.
Плитки жизни — это функция Windows 10, которая не поддерживается в более поздних версиях Windows. Для новых приложений рекомендуется следовать текущим рекомендациям по значкам приложений.
Ниже описаны все свойства и элементы в содержимом плитки.
Если вы предпочитаете использовать необработанный XML вместо библиотеки уведомлений, см . схему XML.
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, TileBindingContentContentContact, TileBindingContentPeople или 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 |
TileBindingContentPeople |
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 Phone. Число рядом с значком достигается с помощью отдельного уведомления о значке.
Свойство | Тип | Обязательно | Описание |
---|---|---|---|
Значок | TileBasicImage | true | Как минимум, для поддержки плиток Desktop и Mobile, Small and Medium, предоставьте квадратное соотношение пропорций изображения с разрешением 200x200, формат PNG с прозрачностью и без цвета, отличного от белого. Дополнительные сведения см. в разделе "Специальные шаблоны плиток". |
TileBindingContentContentContact
Только для мобильных устройств. Поддерживается для небольших, средних и широких размеров.
Свойство | Тип | Обязательно | Описание |
---|---|---|---|
Image | TileBasicImage | true | Отображаемое изображение. |
Текст | TileBasicText | false | Строка отображаемого текста. Не отображается на небольшой плитке. |
TileBindingContentPeople
Новые возможности в версии 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 при разрешении строки. |