Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Ниже описаны все свойства и элементы в содержимом тост-уведомлений.
Если вы предпочитаете использовать XML в необработанном виде вместо библиотеки уведомлений , пожалуйста, обратитесь к схеме XML .
ToastContent
ToastContent — это объект верхнего уровня, описывающий содержимое уведомления, включая визуальные элементы, действия и звук.
| Property | Type | Required | Description |
|---|---|---|---|
| Launch | string | false | Строка, передаваемая приложению при активации уведомления Toast. Формат и содержимое этой строки определяются приложением для собственного использования. Когда пользователь нажимает или щелкает Toast, чтобы запустить связанное приложение, строка запуска предоставляет приложению контекст, который позволяет ему отображать представление, соответствующее содержимому Toast, а не запускаться по умолчанию. |
| Visual | ToastVisual | true | Описывает визуальную часть тостового уведомления. |
| Actions | IToastActions | false | При необходимости создайте пользовательские действия с кнопками и полями ввода. |
| Audio | ToastAudio | false | Описывает звуковую часть уведомления. |
| ActivationType | ToastActivationType | false | Указывает, какой тип активации будет использоваться, когда пользователь щелкает основную часть этого всплывающего элемента. |
| ActivationOptions | ToastActivationOptions | false | Новые возможности в Creators Update: дополнительные параметры, связанные с активацией всплывающего уведомления. |
| Scenario | ToastScenario | false | Указывает сценарий использования всплывающего уведомления (toast), например, для сигнализации или напоминания. |
| DisplayTimestamp | DateTimeOffset? | false | Новое в Creators Update: переопределите метку времени по умолчанию с помощью настраиваемой метки времени, представляющей, когда содержимое уведомления было доставлено на самом деле, а не время получения уведомления платформой Windows. |
| Header | ToastHeader | false | Новое в Creators Update: добавьте пользовательский заголовок в уведомление, чтобы группировать несколько уведомлений вместе в Центре уведомлений. |
ToastScenario
Указывает, какой сценарий представляет тост.
| Value | Meaning |
|---|---|
| Default | Обычное поведение уведомления-тоста. |
| Reminder | Уведомление о напоминании. Это будет отображаться предварительно и оставаться на экране пользователя до увольнения. |
| Alarm | Уведомление о тревоге. Это будет отображаться предварительно и оставаться на экране пользователя до увольнения. Звук будет циклически по умолчанию и будет использовать звук сигнализации. |
| IncomingCall | Уведомление о входящих звонках. Это будет отображаться в развернутом виде в специальном формате вызова и оставаться на экране пользователя, пока не будет закрыто. Звук будет циклироваться по умолчанию и будет использовать мелодию звонка. |
ToastVisual
Визуальная часть тосты содержит привязки, содержащие текст, изображения, адаптивное содержимое и многое другое.
| Property | Type | Required | Description |
|---|---|---|---|
| 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" |
| Language | string | false | Целевая локаль визуального содержимого в контексте локализованных ресурсов, указана в виде тегов языка BCP-47, таких как "en-US" или "fr-FR". Эта локаль переопределяется любой локалью, указанной в привязке или тексте. Если он не указан, вместо этого будет использоваться локаль системы. |
ToastBindingGeneric
Универсальная привязка — это привязка по умолчанию для тостов, где указываются текст, изображения, адаптивное содержимое и многое другое.
| Property | Type | Required | Description |
|---|---|---|---|
| Children | IList<IToastBindingGenericChild> | false | Содержимое сообщения Toast, которое может включать текст, изображения и группы (добавлено в Anniversary Update). Текстовые элементы должны располагаться перед любыми другими элементами, и поддерживаются только три текстовых элемента. Если текстовый элемент размещен после любого другого элемента, он либо будет перемещен наверх, либо опущен вниз. И, наконец, некоторые свойства текста, такие как HintStyle, не поддерживаются в текстовых элементах, являющихся дочерними от корневых, и работают только внутри adaptiveSubgroup. Если вы используете AdaptiveGroup на устройствах без юбилейного обновления, содержимое группы будет просто удалено. |
| AppLogoOverride | ToastGenericAppLogo | false | Необязательный логотип для замены логотипа приложения. |
| HeroImage | ToastGenericHeroImage | false | Необязательное изображение «героя», отображаемое во всплывающем уведомлении и Центре уведомлений. |
| Attribution | 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" |
| Language | string | false | Целевая локаль визуального содержимого в контексте локализованных ресурсов, указана в виде тегов языка BCP-47, таких как "en-US" или "fr-FR". Эта локаль переопределяется любой локалью, указанной в привязке или тексте. Если он не указан, вместо этого будет использоваться локаль системы. |
IToastBindingGenericChild
Интерфейс маркера для всплывающих дочерних элементов, которые включают текст, изображения, группы и многое другое.
| Implementations |
|---|
| AdaptiveText |
| AdaptiveImage |
| AdaptiveGroup |
| AdaptiveProgressBar |
AdaptiveText
Адаптивный текстовый элемент. Если элемент помещен на верхний уровень ToastBindingGeneric.Children, будет применяться только HintMaxLines. Но если это помещается в качестве дочернего элемента группы или подгруппы, поддерживается полнотекстовая стилизация.
| Property | Type | Required | Description |
|---|---|---|---|
| Text | строка или BindableString | false | Отображаемый текст. Поддержка привязки данных, добавленная в Creators Update, но работает только для текстовых элементов верхнего уровня. |
| HintStyle | AdaptiveTextStyle | false | Стиль определяет размер шрифта, вес и прозрачность текста. Работает только для текстовых элементов внутри группы или подгруппы. |
| HintWrap | bool? | false | Задайте для этого значение true, чтобы включить оболочку текста. Текстовые элементы верхнего уровня игнорируют это свойство и всегда обтекают (можно использовать HintMaxLines = 1, чтобы отключить оболочку для текстовых элементов верхнего уровня). Текстовые элементы внутри групп или подгрупп по умолчанию — false для упаковки. |
| HintMaxLines | int? | false | Максимальное количество строк текстового элемента разрешено отображать. |
| HintMinLines | int? | false | Минимальное количество строк, которое должен отображать текстовый элемент. Работает только для текстовых элементов внутри группы или подгруппы. |
| HintAlign | AdaptiveTextAlign | false | Горизонтальное выравнивание текста. Работает только для текстовых элементов внутри группы или подгруппы. |
| Language | string | false | Целевой язык XML-содержимого определяется как языковые теги BCP-47, такие как "en-US" или "fr-FR". Локаль, указанная здесь, переопределяет любую другую указанную локаль, например, в коде привязки или в визуальной части. Если это значение является литеральной строкой, этот атрибут по умолчанию использует язык пользовательского интерфейса пользователя. Если это значение является строковой ссылкой, этот атрибут принимает значение по умолчанию, соответствующее локали, выбранной средой выполнения Windows при разрешении строки. |
BindableString
Значение привязки для строк.
| Property | Type | Required | Description |
|---|---|---|---|
| BindingName | string | true | Возвращает или задает имя, которое сопоставляется со значением данных привязки. |
AdaptiveTextStyle
Стиль текста определяет размер шрифта, вес и прозрачность. Незначительная непрозрачность соответствует 60% с цветовым кодом%.
| Value | Meaning |
|---|---|
| Default | Значение по умолчанию. Стиль определяется отрисовщиком. |
| Caption | Меньше, чем размер шрифта в абзаце. |
| CaptionSubtle | То же самое, что и подпись, но с лёгкой непрозрачностью. |
| Body | Размер шрифта абзаца. |
| BodySubtle | То же, что и корпус, но с легкой прозрачностью. |
| Base | Размер шрифта абзаца, полужирный шрифт. По существу полужирная версия Body. |
| BaseSubtle | То же, что и Base, но с легкой непрозрачностью. |
| Subtitle | Размер шрифта H4. |
| SubtitleSubtle | То же, что и подзаголовок, но с лёгкой прозрачностью. |
| Title | Размер шрифта H3. |
| TitleSubtle | То же самое, что и Заголовок, но с небольшой прозрачностью. |
| TitleNumeral | То же, что и заголовок, но с удалёнными верхним и нижним отступами. |
| Subheader | Размер шрифта H2. |
| SubheaderSubtle | То же самое, что и подзаголовка, но с небольшой непрозрачностью. |
| SubheaderNumeral | Так же, как подзаголовок, но без верхнего и нижнего заполнения. |
| Header | Размер шрифта H1. |
| HeaderSubtle | То же самое, что заголовок, но с тонкой непрозрачностью. |
| HeaderNumeral | То же самое, что и заголовок, но с удалённым верхним и нижним заполнением. |
AdaptiveTextAlign
Управляет горизонтальным выравниванием текста.
| Value | Meaning |
|---|---|
| Default | Значение по умолчанию. Выравнивание автоматически определяется рендерером. |
| Auto | Выравнивание, определенное текущим языком и культурой. |
| Left | Горизонтально выровнять текст слева. |
| Center | Горизонтально выровнять текст в центре. |
| Right | Горизонтально выровнять текст справа. |
AdaptiveImage
Встроенное изображение.
| Property | Type | Required | Description |
|---|---|---|---|
| Source | string | 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 | Горизонтальное выравнивание изображения. Работает только для изображений внутри группы или подгруппы. |
| AlternateText | string | 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
Указывает требуемую обрезку изображения.
| Value | Meaning |
|---|---|
| Default | Значение по умолчанию. Поведение обрезки, определяемое отрисовщиком. |
| None | Изображение не обрезано. |
| Circle | Изображение обрезается в круглую форму. |
AdaptiveImageAlign
Указывает горизонтальное выравнивание изображения.
| Value | Meaning |
|---|---|
| Default | Значение по умолчанию. Поведение выравнивания, определяемое рендерером. |
| Stretch | Изображение растянуто для заполнения доступной ширины (и потенциально доступной высоты в зависимости от места размещения изображения). |
| Left | Выровняйте изображение слева, отображая изображение в собственном разрешении. |
| Center | Выравнивайте изображение по центру по горизонтали, отображая его в родном разрешении. |
| Right | Выровняйте изображение справа, отображая его в его собственном разрешении. |
AdaptiveGroup
Новое в юбилейном обновлении: группы семантически определяют, что содержимое в группе должно отображаться в целом или не отображаться, если оно не может соответствовать. Группы также позволяют создавать несколько столбцов.
| Property | Type | Required | Description |
|---|---|---|---|
| Children | IList<AdaptiveSubgroup> | false | Подгруппы отображаются как вертикальные столбцы. Необходимо использовать подгруппы для предоставления содержимого в адаптивной группе. |
AdaptiveSubgroup
Новые возможности в юбилейном обновлении: подгруппы — это вертикальные столбцы, которые могут содержать текст и изображения.
| Property | Type | Required | Description |
|---|---|---|---|
| Children | IList<IAdaptiveSubgroupChild> | false | AdaptiveText и AdaptiveImage — допустимые дочерние элементы подгрупп. |
| HintWeight | int? | false | Определите ширину этого подгруппного столбца, указав вес относительно других подгрупп. |
| HintTextStacking | AdaptiveSubgroupTextStacking | false | Управляйте вертикальным выравниванием содержимого этой подгруппы. |
IAdaptiveSubgroupChild
Интерфейс маркера для дочерних групп.
| Implementations |
|---|
| AdaptiveText |
| AdaptiveImage |
AdaptiveSubgroupTextStacking
TextStacking указывает вертикальное выравнивание содержимого.
| Value | Meaning |
|---|---|
| Default | Значение по умолчанию. Отрисовщик автоматически выбирает выравнивание по умолчанию по вертикали. |
| Top | Вертикальное выравнивание по верхнему краю. |
| Center | Вертикальное выравнивание по центру. |
| Bottom | Вертикальное выравнивание по нижнему краю. |
AdaptiveProgressBar
Новое в Creators Update: индикатор выполнения. Поддерживается только в уведомлениях на рабочем столе, начиная с версии 15063 или более поздней.
| Property | Type | Required | Description |
|---|---|---|---|
| Title | строка или BindableString | false | Возвращает или задает строку заголовка, которая может быть необязательной. Поддерживает привязку данных. |
| Value | double или AdaptiveProgressBarValue или BindableProgressBarValue | false | Возвращает или задает значение индикатора выполнения. Поддерживает привязку данных. Значение по умолчанию — 0. |
| ValueStringOverride | строка или BindableString | false | Возвращает или задает необязательную строку, отображаемую вместо процентной строки по умолчанию. Если это не указано, будет отображаться что-то вроде "70%". |
| Status | строка или BindableString | true | Возвращает или задает строку состояния (обязательно), которая отображается слева под индикатором выполнения. Эта строка должна отражать состояние операции, например "Скачивание..." или "Установка..." |
AdaptiveProgressBarValue
Класс, представляющий значение индикатора выполнения.
| Property | Type | Required | Description |
|---|---|---|---|
| Value | double | false | Возвращает или задает значение (0,0 – 1,0), представляющее процент завершения. |
| IsIndeterminate | bool | false | Возвращает или задает значение, указывающее, является ли индикатор выполнения неопределённым. Если это правда, Value будет игнорироваться. |
BindableProgressBarValue
Привязываемое значение индикатора выполнения.
| Property | Type | Required | Description |
|---|---|---|---|
| BindingName | string | true | Возвращает или задает имя, которое сопоставляется со значением данных привязки. |
ToastGenericAppLogo
Логотип, отображаемый вместо логотипа приложения.
| Property | Type | Required | Description |
|---|---|---|---|
| Source | string | true | URL-адрес изображения. поддерживаются ms-appx, ms-appdata и http. Изображения HTTP должны иметь размер 200 КБ или меньше. |
| HintCrop | ToastGenericAppLogoCrop | false | Укажите, как вы хотите обрезать изображение. |
| AlternateText | string | 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
Управляет обрезкой изображения логотипа приложения.
| Value | Meaning |
|---|---|
| Default | Обрезка использует поведение отрисовщика по умолчанию. |
| None | Изображение не обрезано, отображается квадрат. |
| Circle | Изображение обрезано в форме круга. |
ToastGenericHeroImage
Изображение «герой», выделенное и отображаемое в уведомлениях и в Центре действий.
| Property | Type | Required | Description |
|---|---|---|---|
| Source | string | true | URL-адрес изображения. поддерживаются ms-appx, ms-appdata и http. Изображения HTTP должны иметь размер 200 КБ или меньше. |
| AlternateText | string | 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
Текст атрибуции, отображаемый в нижней части всплывающего уведомления.
| Property | Type | Required | Description |
|---|---|---|---|
| Text | string | true | Отображаемый текст. |
| Language | string | false | Целевая локаль визуального содержимого в контексте локализованных ресурсов, указана в виде тегов языка BCP-47, таких как "en-US" или "fr-FR". Если он не указан, вместо этого будет использоваться локаль системы. |
IToastActions
Интерфейс маркера для всплывающих действий и входных данных.
| Implementations |
|---|
| ToastActionsCustom |
| ToastActionsSnoozeAndDismiss |
ToastActionsCustom
Реализует IToastActions
Создайте собственные пользовательские действия и элементы ввода, используя такие элементы управления, как кнопки, текстовые поля и элементы выбора.
| Property | Type | Required | Description |
|---|---|---|---|
| Inputs | IList<IToastInput> | false | Элементы ввода, такие как текстовые поля и поля выбора. Разрешено только до 5 входных данных. |
| Buttons | IList<IToastButton> | false | Кнопки отображаются после всех входных данных (или рядом с входными данными, если кнопка используется в качестве кнопки быстрого ответа). Разрешены только до 5 кнопок (или меньше, если у вас также есть элементы контекстного меню). |
| ContextMenuItems | IList<ToastContextMenuItem> | false | Новое в юбилейном обновлении: настраиваемые элементы контекстного меню, предоставляя дополнительные действия, если пользователь щелкает уведомление правой кнопкой мыши. Вы можете использовать только до 5 кнопок и элементов контекстного меню, объединенных. |
IToastInput
Интерфейс маркера для всплывающих входных данных.
| Implementations |
|---|
| ToastTextBox |
| ToastSelectionBox |
ToastTextBox
Реализует IToastInput
Элемент управления текстового поля, в который пользователь может ввести текст.
| Property | Type | Required | Description |
|---|---|---|---|
| Id | string | true | Идентификатор обязателен и используется для сопоставления введенного пользователем текста с парой ключ-значение (идентификатор/значение), которую позже использует приложение. |
| Title | string | false | Текст заголовка, отображаемый над текстовым полем. |
| PlaceholderContent | string | false | Текст заполнителя, отображаемый в текстовом поле, когда пользователь еще не ввел текст. |
| DefaultInput | string | false | Исходный текст для размещения в текстовом поле. Оставьте это значение null, чтобы сделать текстовое поле пустым. |
ToastSelectionBox
Реализует IToastInput
Элемент управления "Поле выбора", позволяющий пользователям выбирать из раскрывающегося списка параметров.
| Property | Type | Required | Description |
|---|---|---|---|
| Id | string | true | Идентификатор является обязательным. Если пользователь выбрал этот элемент, этот идентификатор будет передан обратно в код приложения, представляющий выбранный вами выбор. |
| Content | string | true | Содержимое является обязательным и представляет собой строку, отображаемую в элементе выбора. |
ToastSelectionBoxItem
Элемент поля выбора (элемент, который пользователь может выбрать из раскрывающегося списка).
| Property | Type | Required | Description |
|---|---|---|---|
| Id | string | true | Идентификатор обязателен и используется для сопоставления введенного пользователем текста с парой ключ-значение (идентификатор/значение), которую позже использует приложение. |
| Title | string | false | Текст заголовка, отображаемый над полем выделения. |
| DefaultSelectionBoxItemId | string | false | Этот элемент управления определяет, какой элемент выбран по умолчанию, и ссылается на свойство Id объекта ToastSelectionBoxItem. Если это не указано, выбор по умолчанию будет пустым (пользователь не видит ничего). |
| Items | IList<ToastSelectionBoxItem> | false | Элементы, которые доступны для выбора пользователю в этом SelectionBox. Можно добавить только 5 элементов. |
IToastButton
Интерфейс маркера для всплывающих кнопок.
| Implementations |
|---|
| ToastButton |
| ToastButtonSnooze |
| ToastButtonDismiss |
ToastButton
Реализует IToastButton
Кнопка, которую пользователь может нажать.
| Property | Type | Required | Description |
|---|---|---|---|
| Content | string | true | Required. Текст, отображаемый на кнопке. |
| Arguments | string | true | Required. Определяемая приложением строка аргументов, которые приложение получит позже, если пользователь нажимает эту кнопку. |
| ActivationType | ToastActivationType | false | Определяет тип активации этой кнопки при нажатии кнопки. По умолчанию передний план. |
| ActivationOptions | ToastActivationOptions | false | Новое в Creators Update: Возвращает или задает дополнительные параметры, связанные с активацией кнопки всплывающего уведомления. |
ToastActivationType
Определяет тип активации, который будет использоваться при взаимодействии пользователя с определенным действием.
| Value | Meaning |
|---|---|
| Foreground | Значение по умолчанию. Запускается приложение переднего плана. |
| Background | Активируется соответствующая фоновая задача (при условии, что вы настроили все) и вы можете выполнить код в фоновом режиме (например, отправка быстрого ответа пользователя) без прерывания пользователя. |
| Protocol | Запустите другое приложение с помощью активации протокола. |
ToastActivationOptions
Новые возможности в Creators Update: дополнительные параметры, связанные с активацией.
| Property | Type | Required | Description |
|---|---|---|---|
| AfterActivationBehavior | ToastAfterActivationBehavior | false | Новое в Fall Creators Update: Возвращает или задает поведение, которое должно использовать тост-уведомление, когда пользователь выполняет данное действие. Это работает только на настольном компьютере, для ToastButton и ToastContextMenuItem. |
| ProtocolActivationTargetApplicationPfn | string | false | Если вы используете ToastActivationType.Protocol, можно также указать целевой PFN, чтобы независимо от того, зарегистрированы ли несколько приложений для обработки одного и того же протокола uri, нужное приложение всегда будет запускаться. |
ToastAfterActivationBehavior
Указывает поведение, которое должен использовать тост при взаимодействии пользователя с ним.
| Value | Meaning |
|---|---|
| Default | Поведение по умолчанию. Всплывающее уведомление будет закрыто, когда пользователь выполнит действие с ним. |
| PendingUpdate | После нажатия кнопки на всплывающем элементе уведомления уведомление останется в визуальном состоянии "ожидающего обновления". Вы должны немедленно обновить тост из фоновой задачи, чтобы пользователь не видел визуальное состояние "ожидание обновления" слишком долго. |
ToastButtonSnooze
Реализует IToastButton
Кнопка отложить, управляемая системой, которая автоматически обрабатывает отложение уведомления.
| Property | Type | Required | Description |
|---|---|---|---|
| CustomContent | string | false | Необязательный пользовательский текст, отображаемый на кнопке, которая переопределяет локализованный по умолчанию текст "Отложить". |
ToastButtonDismiss
Реализует IToastButton
Кнопка закрытия, обработанная системой, которая закрывает уведомление при нажатии.
| Property | Type | Required | Description |
|---|---|---|---|
| CustomContent | string | false | Необязательный пользовательский текст, отображаемый на кнопке, переопределяет используемый по умолчанию локализованный текст "Отменить". |
ToastActionsSnoozeAndDismiss
*Реализует IToastActions
Автоматически создается поле выбора для интервалов отсрочки и кнопки отсрочки/отклонения, все они автоматически локализуются, а логика отсрочки автоматически обрабатывается системой.
| Property | Type | Required | Description |
|---|---|---|---|
| ContextMenuItems | IList<ToastContextMenuItem> | false | Новое в юбилейном обновлении: настраиваемые элементы контекстного меню, предоставляя дополнительные действия, если пользователь щелкает уведомление правой кнопкой мыши. У вас может быть только до 5 элементов. |
ToastContextMenuItem
Элемент контекстного меню.
| Property | Type | Required | Description |
|---|---|---|---|
| Content | string | true | Required. Отображаемый текст. |
| Arguments | string | true | Required. Определяемая приложением строка аргументов, которые приложение может получить после активации, когда пользователь щелкает элемент меню. |
| ActivationType | ToastActivationType | false | Определяет тип активации этого элемента меню при щелчке. По умолчанию передний план. |
| ActivationOptions | ToastActivationOptions | false | Новые возможности в Creators Update: дополнительные параметры, связанные с активацией всплывающего контекстного меню. |
ToastAudio
Укажите звук, который будет воспроизводиться при получении уведомления Toast.
| Property | Type | Required | Description |
|---|---|---|---|
| Src | uri | false | Файл мультимедиа для воспроизведения вместо звука по умолчанию. Поддерживаются только ms-appx и ms-resource. Все остальное (ms-appdata, http, C:и т. д.) не поддерживается. |
| Loop | boolean | false | Установите флажок в true, если звук должен повторяться до тех пор, пока отображается всплывающее уведомление, а в false для воспроизведения только один раз (по умолчанию). |
| Silent | boolean | false | Значение true для отключения звука; Значение false, чтобы разрешить воспроизведение звука всплывающего уведомления (по умолчанию). |
ToastHeader
Новое в Creators Update: пользовательский заголовок, который группирует несколько уведомлений в Центре уведомлений.
| Property | Type | Required | Description |
|---|---|---|---|
| Id | string | true | Созданный разработчиком идентификатор, который однозначно идентифицирует этот заголовок. Если два уведомления имеют одинаковый идентификатор заголовка, они будут отображаться под тем же заголовком в Центре уведомлений. |
| Title | string | true | Заголовок для шапки. |
| Arguments | string | true | Возвращает или задает определяемую разработчиком строку аргументов, возвращаемую приложению, когда пользователь щелкает этот заголовок. Не может быть пустым. |
| ActivationType | ToastActivationType | false | Возвращает или задает тип активации этого заголовка, который будет использоваться при нажатии. По умолчанию передний план. Обратите внимание, что поддерживаются только Передний план и Протокол. |
| ActivationOptions | ToastActivationOptions | false | Возвращает или задает дополнительные параметры, связанные с активацией заголовка тоста. |
Связанные темы
- Краткое руководство: отправка локального тоста и обработка активации
- библиотека уведомлений на сайте GitHub
Windows developer