共用方式為


VisualElements (適用于 Windows 8) 的套件架構

描述 UWP app 的視覺層面:其預設磚、標誌影像、文字和背景色彩、初始螢幕方向、啟動顯示畫面,以及鎖定螢幕磚外觀。

元素階層

<套件>
<應用程式>
<應用>
<VisualElements>

Syntax

<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>

Key

? 選擇性 (零或一個)

& 交錯連接器 (可能會依任何順序發生)

屬性和項目

屬性

屬性 描述 資料類型 必要 預設值
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值表示允許應用程式提供快顯通知。 預設值為 false。 如果您不想要顯示快顯通知,請勿指定此屬性的值。 請注意,應用程式不應該決定是否要根據此值傳送快顯通知。

boolean No

 

子元素

子元素 Description
DefaultTile

代表 [開始] 畫面上應用程式的預設磚。 此磚會在應用程式第一次安裝之前顯示,然後才收到任何更新通知。 當磚沒有顯示通知時,磚會還原為此預設值。

InitialRotationPreference

描述應用程式想要針對最佳使用者體驗顯示的方向。 在可旋轉的裝置上,例如平板電腦,應用程式將不會針對此處未指定的方向重新繪製。 例如,如果應用程式只指定 Landscape 和 LandscapeFlipped 方向,且裝置會旋轉為直向,則應用程式將不會旋轉。

請注意,在無法旋轉的裝置上,應用程式可能會顯示在該裝置的預設方向中,且會忽略應用程式的慣用方向。 不過,在啟用旋轉鎖定的裝置上,仍會接受您應用程式的慣用旋轉。

這些方向喜好設定選項適用于 [啟動顯示畫面] (element-splashscreen.md) ,以及應用程式 UI,當應用程式啟動新的會話時。 您可以透過 [AutoRotationPreferences] (/uwp/api/Windows,在執行時間期間變更喜好設定。Graphics.Display.DisplayProperties) 屬性。

LockScreen

定義徽章和通知,代表鎖定畫面上的應用程式,當系統鎖定時會顯示。

SplashScreen

定義啟動期間應用程式所顯示之啟動顯示畫面的外觀。

 

父項目

Parent 項目 Description
應用程式

代表包含套件中傳遞之部分或所有功能的應用程式。

 

備註

如需磚維度需求的詳細資訊,請參閱 磚大小

標誌SmallLogo 影像可以指定為影像檔案的直接路徑或資源。 藉由使用資源參考,您可以提供不同縮放比例的影像,讓 Windows 可以為裝置和螢幕解析度選擇最佳大小。 您也可以提供協助工具的高對比影像和當地語系化的影像,以符合不同的 UI 語言。 此功能也可讓您將 DisplayNameDescription 屬性當地語系化。 如需詳細資訊,請參閱 全球化 主題。

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 瓦特文 青色 青綠色 azure 米黃色
淡黃色 黑色 一般 藍色 blueViolet 棕色
burlyWood cadetBlue 淡黃綠 巧克力色 珊瑚紅 cmflowerBlue
玉米穗黃 大紅色 青色 深藍 深青色 darkGoldenrod
darkGray 深綠 dark一卡多 darkMagenta darkOliveGreen darkOrange
darkOrchid darkRed darkSalmon darkSeaGreen darkSlateBlue darkSlateGray
darkTurquoise darkViolet deepPink deepSkyBlue dimGray dodgerBlue
磚紅 瓦特文 forestGreen 桃紅 亮灰 ghostWhite
金色 金黃 灰色 綠色 greenYellow 蜜瓜白
hotPink 印度紅 靛藍 象牙白 卡其色 淡紫
擷取者 lawnGreen 檢視 lightBlue lightCoral lightCyan
lightGoldenrodYellow lightGreen lightGray lightPink lightSalmon lightSeaGreen
lightSkyBlue lightSlateGray lightSteelBlue lightYellow 淺綠色 limeGreen
亞麻黃 洋紅 暗紅色 mediumAquamarine mediumBlue mediumOrchid
mediumPurple mediumSeaGreen mediumSlateBlue mediumSpringGreen mediumTurquoise mediumVioletRed
midnightBlue mintCream mistyRose 鹿皮黃 navajoWhite 海軍藍
oldLace 橄欖色 oliveDrab 橙色 orangeRed 蘭花紫
帕德德羅d 淺綠 擷耙文 擷取者VioletRed papyaWhip peachPuff
秘魯色 粉紅色 梅紅色 擷藍 紫色 紅色
rosyBrown royalBlue saddleBrown 淡橙紅 擷布 seaGreen
貝殼 深黃褐 銀色 skyBlue slateBlue slateGray
snow springGreen steelBlue tan 藍綠色 薊紫
蕃茄紅 透明 淺粉藍 紫色 小麥色 白色
whiteSmoke 黃色 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>
                

另請參閱

App 螢幕擷取畫面與影像

Colors 類別

快速入門:使用Visual Studio資訊清單編輯器建立預設磚

規格需求

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