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