用于Windows 8) 的 VisualElements (包架构

  • 项目

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

元素层次结构

<程序包>
<应用程序>
<应用程序>
<VisualElements>

语法

<VisualElements DisplayName     = A string between 1 and 256 characters in length.
                Logo            = 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.
                SmallLogo       = 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.
                Description     = A string between 1 and 2048 characters in length that cannot include characters such as tabs, carriage returns, and line feeds.
                ForegroundText  = "light" | "dark"
                BackgroundColor = A three-byte hexadecimal number preceded by "#" or a named color.
                ToastCapable?   = boolean >

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

</VisualElements>

键

? 可选 (零个或一个)

& 交错连接器 (可能按任何顺序发生)

特性和元素

特性

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

指定应用磁贴的背景色。 有关颜色名称，请参阅“备注”部分。 请注意，此处指定的背景色也适用于以下项目：

  • 任何应用拥有的对话框中的按钮颜色
  • Microsoft Store中的“应用说明”页
  • 适用于Windows Phone：选择“透明”会导致使用系统主题色。
 以“#”或命名颜色开头的三字节十六进制数字。 是
说明

应用的说明。 此字符串是可本地化的;有关详细信息，请参阅“备注”。

 长度为 1 到 2048 个字符的字符串，不能包含制表符、回车符和换行符等字符。 是
DisplayName

可向用户显示的应用的友好名称。 此字符串是可本地化的;有关详细信息，请参阅“备注”。

有两个显式保留字不能用作上传到Microsoft Store的应用的 DisplayName：“NoUIEntryPoints”和“NoUIEntryPoints-DesignMode”。 保留这些标识符供开发工具和测试套件使用。

 长度介于 1 到 256 个字符之间的字符串。 是
ForegroundText

指定应用磁贴的前景色。

  • 适用于Windows Phone：忽略此值。 所有磁贴都使用浅色文本颜色。

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

  • 灯
  • 黑暗
 是
徽标

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

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

磁贴角中显示的小图像，用于标识应用。 有关如何在此属性中指定图像的详细信息，请参阅“备注”。

  • 适用于Windows Phone：Windows Phone不显示磁贴上的小徽标。 它仅在“应用”列表中使用。
 长度介于 1 到 256 个字符之间的字符串，以不能包含以下字符的“.jpg”、“.png”或“.jpeg”结尾： <、 >、：、“|、？或 *。 在此字符串中，/和 \ 字符不能是第一个或最后一个字符。 此外，字符串可以包含 /或 \ ，但不能同时包含这两者。 是
ToastCapable

值为 true 表示允许应用提供 Toast 通知。 默认值是 false秒。 如果不希望显示 Toast 通知，请不要指定此属性的值。 请注意，应用不应根据此值决定是否发送 Toast 通知。

 boolean 否

 

子元素

子元素 说明
DefaultTile

表示“开始”屏幕上应用的默认磁贴。 首次安装应用后，才会显示此磁贴，然后再收到任何更新通知。 当磁贴没有要显示的通知时，磁贴将恢复为此默认值。
InitialRotationPreference

介绍应用希望针对最佳用户体验显示的方向。 在可旋转的设备上（例如平板电脑）上，对于此处未指定的方向，应用将不会重新绘制。 例如，如果应用仅指定横向和 LandscapeFlipped 方向，并且设备旋转为纵向方向，则应用不会旋转。

请注意，在无法旋转的设备上，应用可能会显示在该设备的默认方向中，并且应用的首选方向将被忽略。 但是，在激活了旋转锁的设备上，你的应用的首选轮换仍将得到遵守。

当为应用启动新会话时，这些方向首选项选项同时适用于 [初始屏幕] (element-splashscreen.md) 和应用 UI。 可以通过 [AutoRotationPreferences] (/uwp/api/Windows 在运行时更改首选项。Graphics.Display.DisplayProperties) 属性。
LockScreen

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

定义初始屏幕的外观，该屏幕由应用在启动期间显示。

 

父元素

父元素 说明
应用程序

表示一个应用，该应用包含包中提供的一部分或全部功能。

 

注解

有关磁贴维度要求的详细信息，请参阅 磁贴大小。

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

Applications/Application/Extensions/Extension/FileTypeAssociation/Logo Applications/Application/Extensions/Extension/Protocol/Logo

下面显示了两种类型的徽标图像的大小要求：

图像属性缩放像素应用程序\Application\VisualElements\@Logo 100 150x150 140 210x210 180 270x270 Applications\Application\VisualElements\@SmallLogo 100 30x30 140 42x42 180 54x54

以下是受支持的背景色名称：

名称 名称 名称 名称 名称 名称
aliceBlue antiqueWhite 浅绿色 水绿色 azure 米黄色
橘黄色 black blanchedAlmond blue blueViolet 棕色
burlyWood cadetBlue 黄绿色 巧克力色 珊瑚色 玉米花蓝
玉米丝色 深红色 蓝绿色 darkBlue darkCyan darkGoldenrod
darkGray darkGreen darkKhaki darkMagenta darkOliveGreen darkOrange
darkOrchid darkRed darkSalmon darkSeaGreen darkSlateBlue darkSlateGray
darkTurquoise darkViolet deepPink deepSkyBlue dimGray dodgerBlue
火砖色 花白白 forestGreen 紫红色 亮灰色 ghostWhite
金色 金麒麟色 灰色 green greenYellow 蜜色
hotPink indianRed 靛蓝色 乳白色 卡其色 淡紫色
衣草布卢什 lawnGreen lemonChiffon lightBlue lightCoral lightCyan
lightGoldenrodYellow lightGreen lightGray lightPink lightSalmon lightSeaGreen
lightSkyBlue lightSlateGray lightSteelBlue lightYellow lime limeGreen
亚麻色 洋红色 褐红色 mediumAquamarine mediumBlue mediumOrchid
mediumPurple mediumSeaGreen mediumSlateBlue mediumSpringGreen mediumTurquoise mediumVioletRed
midnightBlue mintCream mistyRose 鹿皮色 navajoWhite 深蓝色
oldLace 橄榄色 oliveDrab orange orangeRed 兰花紫
paleGoldenrod paleGreen paleTurquoise paleVioletRed 木瓜Whip peachPuff
秘鲁棕色 pink 梅红色 powderBlue purple 红色
rosyBrown royalBlue saddleBrown 鲑肉色 桑迪布劳 seaGreen
贝壳 赭色 银色 skyBlue slateBlue slateGray
snow springGreen steelBlue tan 水鸭色 蓟色
番茄色 transparent 宝石绿色 紫罗兰色 小麦色 white
whiteSmoke yellow yellowGreen

 

示例

以下示例取自 SDK 示例的包清单。

                    
<Applications>
    <Application Id="App" StartPage="default.html">
        <VisualElements 
            DisplayName="ApplicationDataSample" 
            Logo="images\squareTile-sdk.png" 
            SmallLogo="images\smallTile-sdk.png" 
            Description="Application data sample" 
            ForegroundText="dark" 
            BackgroundColor="#FFFFFF" 
            ToastCapable="false">
            <DefaultTile ShowName="allLogos"/>
            <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png"/>
        </VisualElements>
    </Application>
</Applications>

另请参阅

应用屏幕截图和图像

Colors 类

快速入门：使用Visual Studio清单编辑器创建默认磁贴

要求

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