用于 Windows 8.1 的 visualelements> (功能扩展架构)

  • 项目

介绍 UWP 应用的视觉对象：其默认磁贴、徽标图像、文本和背景色、初始屏幕方向、初始屏幕和锁屏磁贴外观。

元素层次结构

<VisualElements>

语法

<VisualElements Square150x150Logo = 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.
                Square30x30Logo   = 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. >

  <!-- Child elements -->
  ( DefaultTile?
  & LockScreen?
  & SplashScreen
  & InitialRotationPreference?
  & ApplicationView?
  )

</VisualElements>

键

? 可选 (零个或一个)

& 交错连接器 (可能以任意顺序出现)

特性和元素

特性

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

用作应用的正方形磁贴的150x150 图像。 有关如何在此属性中指定图像的详细信息，请参阅 "备注"。

 长度介于1到256个字符的字符串，以 ".jpg"、".png" 或 "jpeg" 结尾，不能包含以下字符： < 、 > 、：、"、|、？或 *。 在此字符串中，/和 \ 字符不能是第一个或最后一个字符。 而且，该字符串可以包含/或 \，但不能同时包含两者。 是
Square30x30Logo

用作应用的正方形磁贴的30x30 图像。 有关如何在此属性中指定图像的详细信息，请参阅 "备注"。

 长度介于1到256个字符的字符串，以 ".jpg"、".png" 或 "jpeg" 结尾，不能包含以下字符： < 、 > 、：、"、|、？或 *。 在此字符串中，/和 \ 字符不能是第一个或最后一个字符。 而且，该字符串可以包含/或 \，但不能同时包含两者。 是

 

子元素

子元素 说明
ApplicationView

描述如何在屏幕上查看应用。
DefaultTile

在 "开始" 屏幕上表示应用的默认磁贴。 第一次安装应用程序时，会显示此磁贴，然后再接收任何更新通知。 如果磁贴没有要显示的通知，磁贴会恢复为此默认值。
InitialRotationPreference

描述应用希望为获得最佳用户体验而显示的方向。 在可以旋转的设备上（如平板电脑），将不会为此处未指定的方向重绘应用。 例如，如果应用仅指定横向和 LandscapeFlipped 方向，并且设备旋转到纵向方向，则应用将不会旋转。

请注意，在无法旋转的设备上，应用程序可能会显示在该设备的默认方向上，并且将忽略应用程序的首选方向。 但是，在激活旋转锁定的设备上，应用的首选旋转仍会生效。

当启动应用程序的新会话时，这些方向首选项选项适用于 [闪屏] (element-splashscreen.md) 和应用 UI。 在运行时，可以通过 [displayproperties.autorotationpreferences] (/uwp/api/Windows 更改首选项。DisplayInformation) 属性。
LockScreen

定义在锁定屏幕上表示应用的徽章和通知，这是在系统锁定时显示的。
SplashScreen

定义初始屏幕的外观，该屏幕在启动过程中由应用程序显示。

 

父元素

此最外层 (文档) 元素可能不会包含在任何其他元素中。

备注

有关应用的视觉方面的详细信息，请参阅 visualelements>。

该清单将对 visualelements>执行这些语义检查，而不会在架构中强制执行。

可以将Square150x150Logo和Square30x30Logo图像作为图像文件的直接路径或资源提供。 通过使用资源引用，可以提供本地化的图像来匹配不同的 UI 语言。 有关详细信息，请参阅 全球化 主题。

要求

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