用于Windows 8) 的 VisualElements (包架构

项目
07/20/2023

介绍 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`

通过

用于Windows 8) 的 VisualElements (包架构

元素层次结构

语法

键

特性和元素

特性

子元素

父元素

注解

示例

另请参阅

要求

反馈

其他资源