UWP Toast XML属性介绍

UWP uwpbox 1204℃ 0评论

 

Toast 通知主体结构如下,带?的为可选属性。根节点为<toast>  其下包含3个子节点,<visual>为必选项,这个都没有就失去弹出来的意义了。

<toast>的属性:

launch? launch? = string

当toast激活应用时会传递这个字符串给它。依赖activationType的值,这个值能被前台应用或者在一个内部后台任务接收,或者被一个通过协议启动的app接收。

这个字符串的格式和内容由接收者定义。当用户点击toast启动相关的app时,这个启动字符串可以给应用用来决定给用户展示toast有关内容,而不是启动默认的界面。

注意:如果用户通过点击 一个aciton 激活而不是通过点击toast窗体,开发者应该定义 <action> 标签的 “arguments”属性而不是这个。

duration? duration? = “short|long”

可选项,默认值为 “short”.

这个属性在win8  中被引进用来指定toast 在屏幕上显示的时间长短,在UWP中不建议使用。

activationType? activationType? = “foreground | background | protocol | system”

可选项默认值 “foreground“.

scenario? scenario? = “default | alarm | reminder | incomingCall”

可选项默认值 “default”.

如果你只是想让你的通知消息保持在屏幕上而不是 一个 alarm, reminder或者or incoming call场景,你就不需要使用它.,前面介绍过这几种应用场景的表现形式

<visual> 的属性

version? version? = nonNegativeInteger

由于 <visual> 上将弃用版本控制,因此无需此属性。 敬请期待从更高层次结构指定的新版本控制模型(如果需要)。

lang? lang? = string

XML加载的目标区域, 指定一个   BCP-47 语言标记如 “en-US” or “zh-CN”. 这个值能被子节点 bingding text的 lang属性覆盖掉 . 如果显示的值是一个普通的字符串, 那么这个属性默认是 用户界面的语言. 如果值是一个指向资源的引用, 那么这个属性的默认值就是系统设置里选择的区域语言

baseUri? baseUri? = string

一个用来与其他图片资源的URI的结合的头,默认值是“ms-appx:///”

addImageQuery? addImageQuery? = “true|false”  默认为false

设置true 允许系统根据目标设备环境给图片uri附加一个查询参数,这个参数包含大小、对比度和语言,图片服务器可以根据参数返回合适的图片,如

“www.website.com/images/hello.png”  会变成

“www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us”

 <binding>属性

template? [Important] template? = “ToastGeneric”

最好是这个值,不建议用以前从模板获取出来的那些值

lang? 参考 <visual> 的 lang属性
baseUri? 参考 <visual> 的 baseUri属性
addImageQuery? 参考 <visual> 的 addImageQuery属性

 <text> 属性

lang? 参考 <visual> 的 lang属性

 <image>的 属性

src 可以是以下形式的一个URI地址

http:// or https://                 基于网络的地址

ms-appx:///         应用程序包里的图片

ms-appdata:///local/         应用本地存储目录

file:///    文件目录只支持桌面程序

placement? placement? = “inline” | “appLogoOverride”

指定显示的位置,“inline”  表示显示在text的下一行

“appLogoOverride” 表示替换掉显示在左上角的应用图标

你可以为每个位置放置一张图片

alt? alt? = string

一段描述

addImageQuery? 参考 <visual> 的 addImageQuery属性
hint-crop? hint-crop? = “none” | “circle”

“none” 默认值,没有任何裁剪

“circle” 剪切成圆形

 

<audio> 的属性

src?

可以是以下的的自带声音

  • ms-winsoundevent:Notification.Default
  • ms-winsoundevent:Notification.IM
  • ms-winsoundevent:Notification.Mail
  • ms-winsoundevent:Notification.Reminder
  • ms-winsoundevent:Notification.SMS
  • ms-winsoundevent:Notification.Looping.Alarm
  • ms-winsoundevent:Notification.Looping.Alarm2
  • ms-winsoundevent:Notification.Looping.Alarm3
  • ms-winsoundevent:Notification.Looping.Alarm4
  • ms-winsoundevent:Notification.Looping.Alarm5
  • ms-winsoundevent:Notification.Looping.Alarm6
  • ms-winsoundevent:Notification.Looping.Alarm7
  • ms-winsoundevent:Notification.Looping.Alarm8
  • ms-winsoundevent:Notification.Looping.Alarm9
  • ms-winsoundevent:Notification.Looping.Alarm10
  • ms-winsoundevent:Notification.Looping.Call
  • ms-winsoundevent:Notification.Looping.Call2
  • ms-winsoundevent:Notification.Looping.Call3
  • ms-winsoundevent:Notification.Looping.Call4
  • ms-winsoundevent:Notification.Looping.Call5
  • ms-winsoundevent:Notification.Looping.Call6
  • ms-winsoundevent:Notification.Looping.Call7
  • ms-winsoundevent:Notification.Looping.Call8
  • ms-winsoundevent:Notification.Looping.Call9
  • ms-winsoundevent:Notification.Looping.Call10

也可以指定声音源

  • ms-appx:///
  • ms-appdata:///

loop? loop? = “true|false”  默认为false
silent? silent? = “true|false”  默认为false

UWP加入的新玩意可交互性<actions>

<input> 的属性

id id = string

这个属性是必须的,开发者可以根据返回的这个值来获取用户的输入类容

type type = “text | selection“

必选项,指定输入是一个文本框或者是一个下拉选择框

title? title? = string

可选项,为输入框指定一个标题,手机和PC显示在输入框的上面

placeHolderContent? placeHolderContent? = string

可选项,显示一个灰色的提示文字,只有在text中有效

defaultInput? defaultInput? = string可选项,提供默认的输入值,text 类型下为默认输入文本,selection 是一个有效的id

<selection>属性,input类型为 selection时用来添加下拉选项

id  必选项,用户选择的返回值,开发者用来区分用户的选择项
content   显示的内容

 

<action> 的属性

content

必须项,显示的内容

 

arguments arguments = string

必选项,按下这个按钮后激活应用时传递的参数

activationType? activationType? = “foreground | background | protocol | system“

可选项,默认值是“foreground”.定义引发事件的行为类型

imageUri? imageUri? = string

按钮增加显示一个图标

hint-inputId hint-inputId = string

的。 它专门用于快速回复方案。

此值需要是要关联的输入元素的 id。

在移动和桌面中,这会将按钮放置在输入框的右侧。

用于系统定义的操作类型属性

如果你不希望应用将通知的推迟/重新计划作为后台任务处理,系统可以处理推迟和取消通知的操作。 系统处理的操作可以组合(或单独指定),但我们不建议在没有取消操作的情况下实现推迟操作。

系统命令组合:SnoozeAndDismiss

单独系统处理的操作

若要构建单独的推迟和取消操作,请执行以下步骤:

  • Specify activationType = “system”
  • Specify arguments = “snooze” | “dismiss”
  • 指定内容:
    • 如果你希望“snooze”和“dismiss”的本地化字符串在操作上显示,请将内容指定为空字符串:<action content = “”/>
    • 如果你需要自定义字符串,只需提供其值:<action content=”Remind me later” />
  • 指定输入:
    • 如果你不希望用户选择推迟间隔,而只是希望你的通知仅在系统定义的时间间隔内推迟一次(这在整个操作系统上都一致),则不要构建任何 <input>。
    • 如果你希望提供推迟间隔选择:
      • 在推迟操作中指定 hint-inputId
      • 将输入的 id 与推迟操作的 hint-inputId 相匹配:<input id=”snoozeTime”></input><action hint-inputId=”snoozeTime”/>
      • 将选择 id 指定为以分钟为单位表示推迟间隔的 nonNegativeInteger:<selection id=”240″ /> 表示推迟 4 小时
      • 请确保 <input> 中的 defaultInput 值与 <selection> 子元素的 id 之一相匹配
      • 提供最多(但不多于)5 个 <selection> 值

 

转载请注明:UWPBOX » UWP Toast XML属性介绍

喜欢 (0)
发表我的评论
取消评论

表情

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址