uap: visualelements> (Windows 10)

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

元素层次结构

<包>
<应用程序>
<应用程序>
<uap: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.
                    BackgroundColor   = A three-byte hexadecimal number preceded by "#" or a named color. See Remarks for a list of named colors.
                    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.
                    Square44x44Logo   = 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.
                    AppListEntry?     = "default" | "none" >

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

</uap:VisualElements>

? 可选 (零个或一个) & 交错连接器 (可以按任意顺序出现)

特性和元素

特性

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

"所有应用程序" 列表中的条目。

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

  • default
default
BackgroundColor

指定应用磁贴的背景色。 请参阅 "备注" 部分了解颜色名称。 请注意,此处指定的背景色也适用于以下项目:

  • 任何应用程序拥有的对话框中的按钮颜色
  • 应用商店中的应用描述页
以 "#" 或命名颜色开头的三字节十六进制数。 有关命名颜色的列表,请参阅 "备注"。
说明

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

长度介于1到2048个字符之间的字符串,不能包含制表符、回车符和换行符等字符。
DisplayName

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

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

长度为1到256个字符的字符串。 此字符串可本地化。
Square150x150Logo

用作应用程序的 "开始" 屏幕磁贴以及任务切换器上的图像。 有关如何在此属性中指定图像的详细信息,请参阅 "备注"。

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

用作应用程序的 "开始" 屏幕小型磁贴和 "所有应用" 列表中的图像。 有关如何在此属性中指定图像的详细信息,请参阅 "备注"。

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

 

子元素

子元素 说明
uap:DefaultTile

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

uap:InitialRotationPreference

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

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

当启动应用程序的新会话时,这些方向首选项选项适用于 初始屏幕 和应用 UI。 可在运行时通过 displayproperties.autorotationpreferences 属性更改首选项。

uap:LockScreen

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

uap:SplashScreen

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

 

父元素

父元素 说明
应用程序

表示一个应用,该应用包含包中的部分或所有功能。

 

备注

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

对于Square150x150LogoSquare44x44Logo映像,可以提供不同比例的图像,以便 Windows 可以为设备和屏幕分辨率选择最佳大小。 你还可以提供辅助功能的高对比度图像和本地化图像,以匹配不同的 UI 语言。 此功能还允许您本地化 DisplayNameDescription 属性。 有关详细信息,请参阅 全球化 主题。

应用程序/应用程序/扩展/扩展/FileTypeAssociation/徽标应用程序/应用程序/扩展插件/协议/徽标

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

图像属性缩放图像大小(以像素为单位)应用程序/应用程序/Visualelements>/@Square150x150Logo 100 150x150 250 375x375 应用程序/应用程序/Visualelements>/@Square44x44Logo 100 44x44 250 110x110 应用程序/应用程序/Visualelements>/@Tall150x310Logo 100 150x310 250 375x775

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

aliceBlue
antiqueWhite
浅绿色
水绿色
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数据
lightGray
lightGreen
lightPink
lightSalmon
lightSeaGreen

lightSkyBlue
lightSlateGray
lightSteelBlue
lightYellow
lime
将"""100000
亚麻色
洋红色
褐红色
mediumAquamarine
mediumBlue
mediumOrchid
mediumPurple
mediumSeaGreen
mediumSlateBlue
mediumSpringGreen
mediumTurqu以
mediumVioletRed
midnightBlue
将创建

鹿皮色
navajoWhite

深蓝色
oldLace
橄榄色
dradrab
orange
orangeRed
兰花紫
将进行
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">
        <uap:VisualElements 
            DisplayName="ApplicationDataSample"
            Description="Application data sample"
            BackgroundColor="#FFFFFF"               
            Square150x150Logo="images\squareTile-sdk.png" 
            Square44x44Logo="images\smallTile-sdk.png" 
            AppListEntry="default">
            <uap:DefaultTile ShowName="allLogos" />
            <uap:LockScreen Notification="badge" BadgeLogo="images\badgeLogo.png" />
            <uap:SplashScreen BackgroundColor="white" Image="images\splash-sdk.png" />
            <uap:InitialRotationPreference> 
                <uap:Rotation Preference="portrait" />
            </uap:InitialRotationPreference>            
        </uap:VisualElements>
    </Application>
</Applications>                             

请参阅

应用屏幕截图和图像

Colors 类

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

要求

Namespace http://schemas.microsoft.com/appx/manifest/uap/windows10