適用于 Windows 8.1) 的 v s (擴充功能架構
描述 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 | 指定應用程式磚的背景色彩。 請參閱 [備註] 區段中的色彩名稱。 請注意，此處指定的背景色彩也適用于下列專案：
適用于 Windows Phone：選擇「透明」會導致使用系統輔色。 |
三位元組的十六進位數位，前面加上 "#" 或命名色彩。 | 是 | |
| 說明 | 應用程式的描述。 這個字串可以當地語系化;如需詳細資訊，請參閱備註。 |
長度介於1到2048個字元之間，且不能包含定位字元、換行字元和換行字元的字串。 | Yes | |
| DisplayName | 可向使用者顯示的應用程式易記名稱。 這個字串可以當地語系化;如需詳細資訊，請參閱備註。 有兩個明確的保留字可能無法作為上傳至 Microsoft Store 之應用程式的 DisplayName： "NoUIEntryPoints" 和 "NoUIEntryPoints DesignMode"。 這些識別項是保留給開發工具和測試套件使用。 |
長度介於1到256個字元之間的字串。 這個字串可當地語系化。 | Yes | |
| ForegroundText | 指定應用程式磚的前景色彩。 適用于 Windows Phone：選擇「透明」會導致使用系統輔色。 |
這個屬性可以具有下列其中一個值：
|
Yes | |
| 標誌 | 用來作為應用程式正方形磚的影像。 如需如何在這個屬性中指定影像的詳細資訊，請參閱備註。 |
長度介於1到256個字元之間的字串，以 ".jpg"、".png" 或 ". jpeg" 結尾，且不能包含下列字元： < 、 > 、：、"、|、？或 *。 在此字串中，/和字元不能是第一個或最後一個字元。 此外，此字串可以包含/或 \，但不能同時包含兩者。 | Yes | |
| SmallLogo | 圖格角落顯示的小型影像，用來識別應用程式。 如需如何在這個屬性中指定影像的詳細資訊，請參閱備註。 適用于 Windows Phone： Windows Phone 不支援磚上的小標誌。 它只會在應用程式清單中使用。 |
長度介於1到256個字元之間的字串，以 ".jpg"、".png" 或 ". jpeg" 結尾，且不能包含下列字元： < 、 > 、：、"、|、？或 *。 在此字串中，/和字元不能是第一個或最後一個字元。 此外，此字串可以包含/或 \，但不能同時包含兩者。 | Yes | |
| ToastCapable | True值表示允許應用程式提供快顯通知。 預設值為 false。 如果您不想要顯示快顯通知，請勿指定此屬性的值。 請注意，應用程式不應該根據此值來決定是否要傳送快顯通知。 |
boolean | No |
子元素
| 子元素 | 描述 |
|---|---|
| DefaultTile | 預設圖格代表開始畫面上的應用程式。 第一次安裝應用程式時，會在應用程式收到任何更新通知之前顯示此磚。 當磚沒有任何要顯示的通知時，磚會還原為此預設值。 |
| InitialRotationPreference | 描述應用程式偏好顯示的方向，以獲得最佳使用者體驗。 在可以旋轉的裝置上（例如平板電腦），將不會針對此處未指定的方向重新繪製應用程式。 例如，如果應用程式只指定橫向和 LandscapeFlipped 方向，而裝置旋轉為直向，應用程式將不會旋轉。 請注意，在無法旋轉的裝置上，應用程式可能會以該裝置的預設方向顯示，而應用程式的慣用方向將會被忽略。 不過，在啟用旋轉鎖定的裝置上，仍會接受您應用程式的慣用旋轉。 當您的應用程式啟動新的會話時，這些方向喜好設定選項同時適用于 [啟動顯示畫面] (element-splashscreen.md) 和應用程式 UI。 在執行時間，您可以透過 [displayproperties.autorotationpreferences] (/uwp/api/Windows 來變更喜好設定。DisplayInformation) 屬性。 |
| LockScreen | 定義徽章和通知，表示鎖定畫面上的應用程式，這會在系統鎖定時顯示。 |
| SplashScreen | 定義啟動顯示時，應用程式所顯示的啟動顯示畫面的外觀。 |
父項目
這個最外層的 (檔) 元素可能不會包含在任何其他專案中。
備註
如需磚維度需求的詳細資訊，請參閱 圖格大小。
標誌 和 SmallLogo 影像可指定為影像檔案的直接路徑，或做為資源。 藉由使用資源參考，您可以提供不同縮放比例的影像，讓 Windows 可以為裝置和螢幕解析度選擇最佳大小。 您也可以提供協助工具的高對比影像和當地語系化的影像，以符合不同的 UI 語言。 這項功能也可讓您當地語系化 DisplayName 和 Description 屬性。 如需詳細資訊，請參閱 全球化 主題。
應用程式/應用程式/延伸模組/延伸模組/FileTypeAssociation/標誌應用程式/應用程式/延伸模組/擴充/通訊協定/標誌
這兩種類型的標誌影像大小需求如下所示：
影像屬性縮放影像大小（圖元） Applications\Application\VisualElements\ @Logo 100 150x150 140 210x210 180 270x270 Applications\Application\VisualElements\ @SmallLogo 100 30x30 140 42x42 180 54x54
以下是支援的背景色彩名稱：
| 名稱 | 名稱 | 名稱 | 名稱 | 名稱 | 名稱 |
|---|---|---|---|---|---|
| aliceBlue | antiqueWhite | 青色 | 青綠色 | azure | 米黃色 |
| 淡黃色 | 黑色 | blanchedAlmond | 藍色 | 藍紫 | 棕色 |
| burlyWood | cadetBlue | 淡黃綠 | 巧克力色 | 珊瑚紅 | [Cornflowerblue |
| 玉米穗黃 | 大紅色 | 青色 | darkBlue | darkCyan | darkGoldenrod |
| 暗灰色 | darkGreen | darkKhaki | darkMagenta | darkOliveGreen | darkOrange |
| darkOrchid | darkRed | darkSalmon | darkSeaGreen | >darkslateblue | darkSlateGray |
| darkTurquoise | darkViolet | deepPink | deepSkyBlue | dimGray | dodgerBlue |
| 磚紅 | floralWhite | forestGreen | 桃紅 | 亮灰 | ghostWhite |
| 金色 | 金黃 | 灰色 | 綠色 | >greenyellow | 蜜瓜白 |
| hotPink | indianRed | 靛藍 | 象牙白 | 卡其色 | 淡紫 |
| lavenderBlush | lawnGreen | lemonChiffon | lightBlue | lightCoral | lightCyan |
| lightGoldenrodYellow | lightGreen | lightGray | lightPink | lightSalmon | lightSeaGreen |
| lightSkyBlue | lightSlateGray | lightSteelBlue | lightYellow | 淺綠色 | 暗綠 |
| 亞麻黃 | 洋紅 | 暗紅色 | mediumAquamarine | mediumBlue | mediumOrchid |
| mediumPurple | mediumSeaGreen | mediumSlateBlue | mediumSpringGreen | mediumTurquoise | mediumVioletRed |
| midnightBlue | mintCream | mistyRose | 鹿皮黃 | navajoWhite | 海軍藍 |
| oldLace | 橄欖色 | oliveDrab | 橙色 | orangeRed | 蘭花紫 |
| paleGoldenrod | paleGreen | paleTurquoise | paleVioletRed | papayaWhip | peachPuff |
| 秘魯色 | 粉紅色 | 梅紅色 | powderBlue | 紫色 | 紅色 |
| rosyBrown | royalBlue | saddleBrown | 淡橙紅 | sandyBrown | seaGreen |
| 貝殼 | 深黃褐 | 銀色 | skyBlue | slateBlue | 青灰 |
| snow | springGreen | steelBlue | tan | 藍綠色 | 薊紫 |
| 蕃茄紅 | 透明 | 淺粉藍 | 紫色 | 小麥色 | 白色 |
| 白霧色 | 黃色 | 黃綠 |
範例
下列範例取自 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>
另請參閱
快速入門：使用 Visual Studio 資訊清單編輯器建立預設磚
需求
| 值 | |
|---|---|
| Namespace | http://schemas.microsoft.com/appx/2010/manifest |