用于 (的 LockScreen 扩展功能Windows 8.1)

定义锁屏界面上表示应用的锁屏提醒和通知,锁定系统时会显示这些锁屏提醒和通知。

元素层次结构

<VisualElements>
<LockScreen>

语法

<LockScreen Notification = "badge" | "badgeAndTileText"
            BadgeLogo    = A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that can't contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters can't be the first or last characters. Also, the string can contain / or \ but not both. />

特性和元素

特性

属性 说明 数据类型 必须 默认值
BadgeLogo

徽标图像,显示在徽章旁边,用于标识应用。 此图像必须是单色的,.png 24 x 24 像素。

若要详细了解如何在此属性中指定图像,请参阅备注。

长度介于 1 到 256 个字符之间的字符串,以".jpg"、".png"或".jpeg"结尾,不能包含以下字符:<>、:、"、|、?或 *。 在此字符串中, / 和 \ 字符不能是前个或最后一个字符。 此外,字符串可以包含 / 或 \ ,但不能同时包含这两者。
通知

可在锁屏界面上为应用显示的磁贴类型。 这可以是一个徽章,它显示数字或标志符号来传达状态,也可以同时显示徽章和文本,这可显示详细状态。 如果选择了 LockScreen 通知类型"badgeAndTileText",则必须指定可选的 WideLogo,因为只有 WideLogo 模板才提供正确的信息来与磁贴文本一起显示。 如果未提供此图像,则磁贴只能以正方形格式显示,并且不接受基于宽模板 类型的通知 。 此规则通过清单 API 在语义上强制执行。

此属性可以具有以下值之一:

  • badge
  • badgeAndTileText

 

子元素

无。

父元素

父元素 说明
VisualElements

描述 UWP 应用的视觉方面:其默认磁贴、徽标图像、文本和背景颜色、初始屏幕方向、初始屏幕和锁屏磁贴外观。

 

备注

若要使应用在锁屏界面上显示,它还必须注册以处理后台任务。 有关详细信息,请参阅锁 屏概述和BackgroundTasks 元素。

BadgeLogo 映像可以作为图像文件的直接路径提供,也可以作为资源提供。 通过使用资源引用,你可以提供不同比例的图像,以便 Windows 可以选择适合设备和屏幕分辨率的最佳大小。 你还可以提供辅助功能的高对比度图像和本地化图像,以匹配不同的 UI 语言。 有关详细信息, 请参阅全球化主题

徽章徽标图像的大小要求如下所示:

图像属性 缩放图像大小(以像素为单位)Applications\Application\VisualElements\LockScreen\@BadgeLogo 100 24x24 140 33x33 180 43x43

请参阅

锁屏界面概述

如何在锁屏界面上显示通知

锁屏应用示例

要求

Namespace http://schemas.microsoft.com/appx/2013/manifest