VisualElements (的扩展架构Windows 8.1)

项目
07/20/2023

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

元素层次结构

<VisualElements>

语法

<VisualElements DisplayName     = A string between 1 and 256 characters in length. This string is localizable. 
                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
                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. >

  <!-- 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"结尾，不能包含以下字符：<>、：、"、\|、？或 *。在此字符串中， / 和 \ 字符不能是前个或最后一个字符。此外，字符串可以包含 / 或 \ ，但不能同时包含这两者。	是
Toast可	值为 true 表示允许应用提供 toast 通知。默认值是 false秒。如果不希望显示 toast 通知，请不要为此特性指定值。请注意，应用不应根据此值决定是否发送 toast 通知。	boolean	否

子元素

子元素	说明
DefaultTile	表示应用程序上应用的默认“开始”屏幕。首次安装应用时，在应用收到任何更新通知之前，会显示此磁贴。当磁贴没有要显示的通知时，该磁贴将还原为此默认值。
InitialRotationPreference	描述应用为获得最佳用户体验而首选显示的方向。在可旋转的设备（如平板电脑）上，不会针对此处未指定的方向重新绘制应用。例如，如果应用仅指定横向和横向翻转方向，并且设备旋转为纵向，则应用不会旋转。请注意，在无法旋转的设备上，应用可能会以该设备的默认方向显示，应用的首选方向将被忽略。但是，在激活了旋转锁的设备上，应用的首选轮换仍将得到遵守。当为应用启动新会话时，这些方向首选项 (element-splashscreen.md) [初始屏幕]应用和应用 UI。可以通过 [AutoRotationPreferences] (/uwp/api/WindowsGraphics.Display.DisplayInformation) 属性。
LockScreen	定义锁屏界面上表示应用的锁屏提醒和通知，锁定系统时会显示这些锁屏提醒和通知。
SplashScreen	定义初始屏幕的外观，该屏幕在启动期间由应用显示。

父元素

此最 (文档) 元素不能由任何其他元素包含。

备注

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

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

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

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

图像属性缩放图像大小（以像素为单位）Applications\Application\VisualElements\@Logo 100 150x150 140 210x210 180 270x270 Applications\Application\VisualElements\@SmallLogo 100 30x30 140 42x42 180 54x54

以下为支持的背景色名称：

名称	名称	名称	名称	名称	名称
aliceBlue	"""1000000	浅绿色	水绿色	azure	米黄色
橘黄色	black	blanchedAlmond	blue	blueViolet	棕色
burlyWood	cadetBlue	黄绿色	巧克力色	珊瑚色	cornflowerBlue
玉米丝色	深红色	蓝绿色	darkBlue	darkCyan	dark使用 dark使用
darkGray	darkGreen	dark则Ki	darkMagenta	darkOliveGreen	darkOrange
darkOrchid	darkRed	darkSalmon	darkSeaGreen	darkSlateBlue	darkSlateGray
darkTurqu以	darkViolet	deepPink	deepSkyBlue	dimGray	一个
火砖色	将"10000001	forestGreen	紫红色	亮灰色	ghostWhite
金色	金麒麟色	灰色	green	greenYellow	蜜色
hotPink	将	靛蓝色	乳白色	卡其色	淡紫色
lavenderBlush	将""1000000	将chiffon	lightBlue	lightCoral	lightCyan
light数据	lightGreen	lightGray	lightPink	lightSalmon	lightSeaGreen
lightSkyBlue	lightSlateGray	lightSteelBlue	lightYellow	lime	将"""100000
亚麻色	洋红色	褐红色	mediumAquamarine	mediumBlue	mediumOrchid
mediumPurple	mediumSeaGreen	mediumSlateBlue	mediumSpringGreen	mediumTurqu以	mediumVioletRed
midnightBlue	将创建	mistyRose	鹿皮色	navajoWhite	深蓝色
oldLace	橄榄色	oliveDrab	orange	orangeRed	兰花紫
paleGoldenrod	paleGreen	paleTurquoise	paleVioletRed	papayaWhip	peachPuff
秘鲁棕色	pink	梅红色	powderBlue	purple	红色
rosyBrown	royalBlue	saddleBrown	鲑肉色	sandyBrown	seaGreen
seaShell	赭色	银色	skyBlue	slateBlue	石板灰
snow	springGreen	Color.steelblue	tan	水鸭色	蓟色
番茄色	transparent	宝石绿色	紫罗兰色	小麦色	white
烟白色	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`

通过

VisualElements (的扩展架构Windows 8.1)

元素层次结构

语法

键

特性和元素

特性

子元素

父元素

备注

示例

请参阅

要求

反馈

其他资源