uap：LockScreen (Windows 10)

  • 项目

定义锁屏界面上表示应用的锁屏提醒和通知，锁屏界面在系统锁定时显示。

元素层次结构

<包>

    <应用程序>

         <应用程序>

              <uap:VisualElements>

                   <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)