Схема содержимого всплывающего уведомления
Ниже описаны все свойства и элементы в содержимом всплывающих элементов.
Если вы предпочитаете использовать необработанный XML вместо библиотеки уведомлений, см . схему XML.
ToastContent
ToastContent — это объект верхнего уровня, описывающий содержимое уведомления, включая визуальные элементы, действия и звук.
Свойство | Тип | Обязательно | Описание |
---|---|---|---|
Launch | строка | false | Строка, передаваемая приложению при активации всплывающего уведомления. Формат и содержимое этой строки определяются приложением для собственного использования. Когда пользователь нажимает или щелкает toast, чтобы запустить связанное приложение, строка запуска предоставляет контекст приложению, который позволяет ему показывать пользователю представление, соответствующее содержимому Toast, а не запускать его по умолчанию. |
Визуальный элемент | ToastVisual | true | Описывает визуальную часть всплывающего уведомления. |
Действия | IToastActions | false | При необходимости создайте пользовательские действия с кнопками и входными данными. |
Звук: | ToastAudio | false | Описывает звуковую часть всплывающего уведомления. |
ActivationType | ToastActivationType | false | Указывает, какой тип активации будет использоваться, когда пользователь щелкает текст этого всплывающего элемента. |
ActivationOptions | ToastActivationOptions | false | Новые возможности в Creators Update: дополнительные параметры, связанные с активацией всплывающего уведомления. |
Сценарий | ToastScenario | false | Объявляет сценарий, в котором используется всплывающее уведомление, например сигнализация или напоминание. |
DisplayTimestamp | DateTimeOffset? | false | Новое в Creators Update: переопределите метку времени по умолчанию с помощью настраиваемой метки времени, представляющей, когда содержимое уведомления было доставлено на самом деле, а не время получения уведомления платформой Windows. |
Верхний колонтитул | ToastHeader | false | Новое в Creators Update: добавьте пользовательский заголовок в уведомление, чтобы группировать несколько уведомлений вместе в Центре уведомлений. |
ToastScenario
Указывает, какой сценарий представляет всплывающее уведомление.
Значение | Значение |
---|---|
По умолчанию | Обычное поведение всплывающего уведомления. |
Напоминание | Уведомление о напоминании. Это будет отображаться предварительно и оставаться на экране пользователя до увольнения. |
Тревога | Уведомление о тревоге. Это будет отображаться предварительно и оставаться на экране пользователя до увольнения. Звук будет циклически по умолчанию и будет использовать звук сигнализации. |
ВходящийCall | Уведомление о входящих звонках. Это будет отображаться предварительно развернуто в специальном формате вызова и оставаться на экране пользователя до закрытия. Звук будет циклироваться по умолчанию и будет использовать мелодию звонка. |
ToastVisual
Визуальная часть тосты содержит привязки, содержащие текст, изображения, адаптивное содержимое и многое другое.
Свойство | Тип | Обязательно | Описание |
---|---|---|---|
BindingGeneric | ToastBindingGeneric | true | Универсальная привязка всплывающего уведомления, которую можно отобразить на всех устройствах. Эта привязка является обязательной и не может иметь значение NULL. |
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. Этот языковой стандарт переопределяется любым языковым стандартом, указанным в привязке или тексте. Если это не указано, вместо этого будет использоваться языковой стандарт системы. |
ToastBindingGeneric
Универсальная привязка — это привязка по умолчанию для точек, а также указывает текст, изображения, адаптивное содержимое и многое другое.
Свойство | Тип | Обязательно | Описание |
---|---|---|---|
Children | IList<IToastBindingGenericChildd> | false | Содержимое текста всплывающего элемента, которое может включать текст, изображения и группы (добавлено в юбилейное обновление). Текстовые элементы должны поступать перед любыми другими элементами, и поддерживаются только 3 текстовых элемента. Если текстовый элемент помещается после любого другого элемента, он будет вытащен в верхнюю или удаленную. И, наконец, некоторые свойства текста, такие как HintStyle, не поддерживаются в текстовых элементах корневых дочерних элементов, и работают только внутри adaptiveSubgroup. Если вы используете AdaptiveGroup на устройствах без юбилейного обновления, содержимое группы будет просто удалено. |
AppLogoOverride | ToastGenericAppLogo | false | Необязательный логотип для переопределения логотипа приложения. |
HeroImage | ToastGenericHeroImage | false | Необязательный "герой" изображение, отображаемое на всплывающем и в Центре уведомлений. |
Приписывание | ToastGenericAttributionText | false | Необязательный текст атрибуции, отображаемый в нижней части всплывающего уведомления. |
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. Этот языковой стандарт переопределяется любым языковым стандартом, указанным в привязке или тексте. Если это не указано, вместо этого будет использоваться языковой стандарт системы. |
IToastBindingGenericChildd
Интерфейс маркера для всплывающих дочерних элементов, которые включают текст, изображения, группы и многое другое.
Реализации |
---|
AdaptiveText |
AdaptiveImage |
AdaptiveGroup |
AdaptiveProgressBar |
AdaptiveText
Адаптивный текстовый элемент. Если помещается на верхний уровень ToastBindingGeneric.Children, применяется только HintMaxLines. Но если это помещается в качестве дочернего элемента группы или подгруппы, поддерживается полнотекстовая стилизация.
Свойство | Тип | Обязательно | Описание |
---|---|---|---|
Текст | string или BindableString | false | Текст для отображения. Поддержка привязки данных, добавленная в Creators Update, но работает только для текстовых элементов верхнего уровня. |
HintStyle | AdaptiveTextStyle | false | Стиль определяет размер шрифта, вес и прозрачность текста. Работает только для текстовых элементов внутри группы или подгруппы. |
HintWrap | bool? | false | Задайте для этого значение true, чтобы включить оболочку текста. Текстовые элементы верхнего уровня игнорируют это свойство и всегда обтекают (можно использовать HintMaxLines = 1, чтобы отключить оболочку для текстовых элементов верхнего уровня). Текстовые элементы внутри групп или подгрупп по умолчанию — false для упаковки. |
HintMaxLines | int? | false | Максимальное количество строк текстового элемента разрешено отображать. |
HintMinLines | int? | false | Минимальное количество строк текстового элемента должно отображаться. Работает только для текстовых элементов внутри группы или подгруппы. |
HintAlign | AdaptiveTextAlign | false | Горизонтальное выравнивание текста. Работает только для текстовых элементов внутри группы или подгруппы. |
Язык | string | false | Целевой языковой стандарт полезных данных XML, указанный в виде тегов языка BCP-47, таких как en-US или fr-FR. Языковой стандарт, указанный здесь, переопределяет любой другой указанный языковой стандарт, например в привязке или визуальном элементе. Если это значение является литеральной строкой, этот атрибут по умолчанию использует язык пользовательского интерфейса пользователя. Если это значение является строковой ссылкой, этот атрибут по умолчанию использует языковой стандарт, выбранный среда выполнения Windows при разрешении строки. |
BindableString
Значение привязки строк.
Свойство | Тип | Обязательно | Описание |
---|---|---|---|
BindingName | строка | true | Возвращает или задает имя, которое сопоставляется со значением данных привязки. |
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 | Вертикальное выравнивание по верхней части. |
Центр | Вертикальное выравнивание по центру. |
Снизу | Вертикальное выравнивание по нижнему краю. |
AdaptiveProgressBar
Новое в Creators Update: индикатор выполнения. Поддерживается только для точек на компьютере, сборка 15063 или более поздняя версия.
Свойство | Тип | Обязательно | Description |
---|---|---|---|
Заголовок | string или BindableString | false | Возвращает или задает необязательную строку заголовка. Поддерживает привязку данных. |
Value | double или AdaptiveProgressBarValue или BindableProgressBarValue | false | Возвращает или задает значение индикатора выполнения. Поддерживает привязку данных. Значение по умолчанию — 0. |
ValueStringOverride | string или BindableString | false | Возвращает или задает необязательную строку, отображаемую вместо процентной строки по умолчанию. Если это не указано, отобразится что-то вроде "70%". |
Состояние | string или BindableString | true | Возвращает или задает строку состояния (обязательно), которая отображается под панелью хода выполнения слева. Эта строка должна отражать состояние операции, например "Скачивание..." или "Установка..." |
AdaptiveProgressBarValue
Класс, представляющий значение индикатора выполнения.
Свойство | Тип | Обязательно | Description |
---|---|---|---|
Value | двойной точности | false | Возвращает или задает значение (0,0 – 1,0), представляющее процент завершения. |
IsIndeterminate | bool | false | Возвращает или задает значение, указывающее, является ли индикатор хода выполнения неопределенным. Если это верно, значение будет игнорироваться. |
BindableProgressBarValue
Привязываемое значение индикатора выполнения.
Свойство | Тип | Обязательно | Описание |
---|---|---|---|
BindingName | строка | true | Возвращает или задает имя, которое сопоставляется со значением данных привязки. |
ToastGenericAppLogo
Логотип, отображаемый вместо логотипа приложения.
Свойство | Тип | Обязательно | Описание |
---|---|---|---|
Источник | строка | true | URL-адрес изображения. поддерживаются ms-appx, ms-appdata и http. Изображения HTTP должны иметь размер 200 КБ или меньше. |
HintCrop | ToastGenericAppLogoCrop | 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" |
ToastGenericAppLogoCrop
Управляет обрезка изображения логотипа приложения.
Значение | Значение |
---|---|
По умолчанию | Обрезка использует поведение отрисовщика по умолчанию. |
Не допускается | Изображение не обрезано, отображается квадрат. |
Круг | Изображение обрезается к кругу. |
ToastGenericHeroImage
Отображаемое изображение "герой", отображаемое на всплывающих элементах и в Центре уведомлений.
Свойство | Тип | Обязательно | Описание |
---|---|---|---|
Источник | строка | true | URL-адрес изображения. поддерживаются ms-appx, ms-appdata и http. Изображения 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" |
ToastGenericAttributionText
Текст атрибуции, отображаемый в нижней части всплывающего уведомления.
Свойство | Тип | Обязательно | Описание |
---|---|---|---|
Текст | строка | true | Текст для отображения. |
Язык | string | false | Целевой языковой стандарт визуальной полезных данных при использовании локализованных ресурсов, указанных в виде тегов языка BCP-47, таких как en-US или fr-FR. Если это не указано, вместо этого будет использоваться языковой стандарт системы. |
IToastActions
Интерфейс маркера для всплывающих действий и входных данных.
Реализации |
---|
ToastActionsCustom |
ToastActionsSnoozeAndDismiss |
ToastActionsCustom
Создайте собственные пользовательские действия и входные данные, используя такие элементы управления, как кнопки, текстовые поля и входные данные выделения.
Свойство | Тип | Обязательно | Описание |
---|---|---|---|
Входные данные | IList<IToastInput> | false | Входные данные, такие как текстовые поля и входные данные выделения. Разрешено только до 5 входных данных. |
Кнопки | IList<IToastButton> | false | Кнопки отображаются после всех входных данных (или рядом с входными данными, если кнопка используется в качестве кнопки быстрого ответа). Разрешены только до 5 кнопок (или меньше, если у вас также есть элементы контекстного меню). |
ContextMenuItems | IList<ToastContextMenuItem> | false | Новое в юбилейном обновлении: настраиваемые элементы контекстного меню, предоставляя дополнительные действия, если пользователь щелкает уведомление правой кнопкой мыши. В сочетании можно использовать только до 5 кнопок и контекстного меню. |
IToastInput
Интерфейс маркера для всплывающих входных данных.
Реализации |
---|
ToastTextBox |
ToastSelectionBox |
ToastTextBox
Элемент управления текстового поля, в который пользователь может ввести текст.
Свойство | Тип | Обязательно | Описание |
---|---|---|---|
Id | строка | true | Идентификатор является обязательным и используется для сопоставления введенного пользователем текста в пару "ключ-значение" идентификатора или значения, которую ваше приложение будет использовать позже. |
Заголовок | string | false | Текст заголовка, отображаемый над текстовым полем. |
ЗаполнительContent | строка | false | Текст заполнителя, отображаемый в текстовом поле, когда пользователь еще не ввел текст. |
DefaultInput | строка | false | Исходный текст для размещения в текстовом поле. Оставьте это значение NULL пустым текстовым полем. |
ToastSelectionBox
Элемент управления "Поле выбора", позволяющий пользователям выбирать из раскрывающегося списка параметров.
Свойство | Тип | Обязательно | Описание |
---|---|---|---|
Id | строка | true | Идентификатор является обязательным. Если пользователь выбрал этот элемент, этот идентификатор будет передан обратно в код приложения, представляющий выбранный вами выбор. |
Содержимое | строка | true | Содержимое является обязательным и представляет собой строку, отображаемую в элементе выбора. |
ToastSelectionBoxItem
Элемент поля выбора (элемент, который пользователь может выбрать из раскрывающегося списка).
Свойство | Тип | Обязательно | Описание |
---|---|---|---|
Id | строка | true | Идентификатор является обязательным и используется для сопоставления введенного пользователем текста в пару "ключ-значение" идентификатора или значения, которую ваше приложение будет использовать позже. |
Заголовок | string | false | Текст заголовка, отображаемый над полем выделения. |
DefaultSelectionBoxItemId | строка | false | Этот элемент определяет, какой элемент выбран по умолчанию, и ссылается на свойство Id toastSelectionBoxItem. Если это не указано, выбор по умолчанию будет пустым (пользователь не видит ничего). |
Товаров | IList<ToastSelectionBoxItem> | false | Элементы выбора, которые пользователь может выбрать в этом элементе SelectionBox. Можно добавить только 5 элементов. |
IToastButton
Интерфейс маркера для всплывающих кнопок.
Реализации |
---|
ToastButton |
ToastButtonSnooze |
ToastButtonDismiss |
ToastButton
Кнопка, которую пользователь может нажать.
Свойство | Тип | Обязательно | Описание |
---|---|---|---|
Содержимое | строка | true | Обязательный. Текст, отображаемый на кнопке. |
Аргументы | строка | true | Обязательный. Определяемая приложением строка аргументов, которые приложение получит позже, если пользователь нажимает эту кнопку. |
ActivationType | ToastActivationType | false | Определяет тип активации этой кнопки при нажатии кнопки. По умолчанию используется передний план. |
ActivationOptions | ToastActivationOptions | false | Новое в Creators Update: Возвращает или задает дополнительные параметры, связанные с активацией кнопки всплывающего уведомления. |
ToastActivationType
Определяет тип активации, который будет использоваться при взаимодействии пользователя с определенным действием.
Значение | Значение |
---|---|
Передний план | Значение по умолчанию. Запускается приложение переднего плана. |
Основные сведения | Активируется соответствующая фоновая задача (при условии, что вы настроили все) и вы можете выполнить код в фоновом режиме (например, отправка быстрого ответа пользователя) без прерывания пользователя. |
Протокол | Запустите другое приложение с помощью активации протокола. |
ToastActivationOptions
Новые возможности в Creators Update: дополнительные параметры, связанные с активацией.
Свойство | Тип | Обязательно | Описание |
---|---|---|---|
AfterActivationBehavior | ToastAfterActivationBehavior | false | Новое в Fall Creators Update: Возвращает или задает поведение, которое должно использовать всплывающее уведомление при вызове этого действия. Это работает только на desktop, для ToastButton и ToastContextMenuItem. |
ProtocolActivationTargetApplicationPfn | строка | false | Если вы используете ToastActivationType.Protocol, то при необходимости можно указать целевой PFN, чтобы независимо от того, зарегистрировано ли несколько приложений для обработки одного и того же uri протокола, нужное приложение всегда будет запущено. |
ToastAfterActivationBehavior
Указывает поведение, которое должно использовать всплывающее уведомление при выполнении пользователем действий на всплывающем элементе.
Значение | Значение |
---|---|
По умолчанию | Поведение по умолчанию. Всплывающее уведомление будет отклонено, когда пользователь принимает меры на всплываемом элементе. |
ОжиданиеUpdate | После нажатия кнопки на всплывающем элементе уведомления уведомление останется в визуальном состоянии "ожидающего обновления". Вы должны немедленно обновить всплывающее уведомление из фоновой задачи, чтобы пользователь не видел это визуальное состояние ожидания обновления слишком долго. |
ToastButtonSnooze
Кнопка отсоздания с обработкой системы, которая автоматически обрабатывает снос уведомления.
Свойство | Тип | Обязательно | Описание |
---|---|---|---|
CustomContent | строка | false | Необязательный пользовательский текст, отображаемый на кнопке, которая переопределяет локализованный по умолчанию текст "Отложить". |
ToastButtonDismiss
Кнопка закрытия, обработанная системой, которая закрывает уведомление при нажатии.
Свойство | Тип | Обязательно | Описание |
---|---|---|---|
CustomContent | строка | false | Необязательный пользовательский текст, отображаемый на кнопке, переопределяет локализованный по умолчанию текст "Закрыть". |
ToastActionsSnoozeAndDismiss
*Реализует IToastActions
Автоматически создает поле выбора для интервалов отсоздания и отклонить кнопки, все автоматически локализованные, а логика snoozing автоматически обрабатывается системой.
Свойство | Тип | Обязательно | Описание |
---|---|---|---|
ContextMenuItems | IList<ToastContextMenuItem> | false | Новое в юбилейном обновлении: настраиваемые элементы контекстного меню, предоставляя дополнительные действия, если пользователь щелкает уведомление правой кнопкой мыши. У вас может быть только до 5 элементов. |
ToastContextMenuItem
Запись элемента контекстного меню.
Свойство | Тип | Обязательно | Описание |
---|---|---|---|
Содержимое | строка | true | Обязательный. Текст для отображения. |
Аргументы | строка | true | Обязательный. Определяемая приложением строка аргументов, которые приложение может получить после активации, когда пользователь щелкает элемент меню. |
ActivationType | ToastActivationType | false | Определяет тип активации этого элемента меню при щелчке. По умолчанию используется передний план. |
ActivationOptions | ToastActivationOptions | false | Новые возможности в Creators Update: дополнительные параметры, связанные с активацией всплывающего контекстного меню. |
ToastAudio
Укажите звук, который будет воспроизводиться при получении всплывающего уведомления.
Свойство | Тип | Обязательно | Описание |
---|---|---|---|
Src | uri | false | Файл мультимедиа для воспроизведения вместо звука по умолчанию. Поддерживаются только ms-appx и ms-resource. Все остальное (ms-appdata, http, C:и т. д.) не поддерживается. |
Loop | boolean | false | Установите значение true, если звук должен повторяться до тех пор, пока отображается всплывающее значение; Значение false для воспроизведения только один раз (по умолчанию). |
Молчаливый | boolean | false | Значение true для отключения звука; Значение false, чтобы разрешить воспроизведение звука всплывающего уведомления (по умолчанию). |
ToastHeader
Новый в Creators Update: пользовательский заголовок, который группирует несколько уведомлений вместе в Центре уведомлений.
Свойство | Тип | Обязательно | Описание |
---|---|---|---|
Id | строка | true | Созданный разработчиком идентификатор, который однозначно идентифицирует этот заголовок. Если два уведомления имеют одинаковый идентификатор заголовка, они будут отображаться под тем же заголовком в Центре уведомлений. |
Заголовок | string | true | Заголовок заголовка. |
Аргументы | строка | true | Возвращает или задает определяемую разработчиком строку аргументов, возвращаемую приложению, когда пользователь щелкает этот заголовок. Не может иметь значение null. |
ActivationType | ToastActivationType | false | Возвращает или задает тип активации этого заголовка, который будет использоваться при щелчке. По умолчанию используется передний план. Обратите внимание, что поддерживаются только переднего плана и протокола. |
ActivationOptions | ToastActivationOptions | false | Возвращает или задает дополнительные параметры, связанные с активацией заголовка всплывающего уведомления. |
См. также
Windows developer