uap：LockScreen (Windows 10)
定义锁屏界面上表示应用的锁屏提醒和通知，锁屏界面在系统锁定时显示。
元素层次结构
<uap:LockScreen>
语法
<uap:LockScreen
Notification = 'A string that can have one of the following values: "badge" or "badgeAndTileText".'
BadgeLogo = 'A string with a value between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that cannot contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters cannot be the first or last characters. Also, the string can contain / or \ but not both.' />
特性和元素
属性
| 属性 | 说明 | 数据类型 | 必须 | 默认值 |
|---|---|---|---|---|
| 通知 | 可在锁屏界面上为应用显示的磁贴类型。 这可以是显示数字或字形以传达状态的锁屏提醒，也可以是显示详细状态的锁屏提醒和文本。 如果选择了 LockScreen 通知类型“badgeAndTileText”，则必须指定可选的 WideLogo，因为只有 WideLogo 模板提供正确的信息来显示磁贴文本。 如果未提供此图像，则磁贴只能以方形格式显示，不能接受基于 宽模板类型的通知。 此规则通过清单 API 在语义上强制实施。 | 可以具有以下值之一的字符串： badge 或 badgeAndTileText。 | 是 | |
| BadgeLogo | 徽标图像显示在锁屏提醒旁边，用于标识应用。 此图像必须是单色的，类型为 .png，大小为 24 x 24 像素。 有关如何在此属性中指定图像的详细信息，请参阅 备注。 | 值长度介于 1 到 256 个字符之间的字符串，以 、 或 结尾，不能包含以下字符：<、>、:、"、|?、 或 *。.jpg.jpeg.png 在此字符串中， / 和 \ 字符不能是第一个或最后一个字符。 此外，字符串可以包含 或，\但不能同时包含/两者。 |
是 |
子元素
无。
父元素
| 父元素 | 描述 |
|---|---|
| uap:VisualElements | 描述应用的视觉方面：其默认磁贴、徽标图像、文本和背景色、初始屏幕方向、初始屏幕和锁屏磁贴外观。 |
注解
要使应用在锁屏界面上具有状态，它还必须注册以处理后台任务。 有关详细信息，请参阅 锁屏界面概述 和 uap：BackgroundTasks 元素。
BadgeLogo 图像可以作为图像文件的直接路径或资源提供。 通过使用资源引用，你可以提供不同比例的图像，以便 Windows 可以选择适合设备和屏幕分辨率的最佳大小。 你还可以提供辅助功能的高对比度图像和本地化图像，以匹配不同的 UI 语言。 有关详细信息，请参阅 全球化 主题。
锁屏提醒徽标图像的大小要求如下所示：
- Image 属性
- 缩放
- 图像大小（以像素为单位）
- Applications\Application\VisualElements\LockScreen\@BadgeLogo
- 100
- 24x24
- 140
- 33x33
- 180
- 43x43
另请参阅
要求
| 项 | 值 |
|---|---|
| Namespace | http://schemas.microsoft.com/appx/manifest/uap/windows10 |
| Minimum OS Version | Windows 10版本 1511 (内部版本 10586) |