VisualElements (Windows 8 のパッケージ スキーマ)
既定のタイル、ロゴ画像、テキストと背景色、初期画面の向き、スプラッシュ画面、ロック画面タイルの外観など、UWP アプリの視覚的な側面について説明します。
要素の階層
- <パッケージ>
-
- <アプリケーション>
-
- <Application>
- <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>
キー
? 省略可能 (0 または 1)
& インターリーブ コネクタ (任意の順序で発生する可能性があります)
属性および要素
属性
| 属性 | 説明 | データ型 | 必須 | 既定値 |
|---|---|---|---|---|
| BackgroundColor | アプリ タイルの背景色を指定します。 色名については、「解説」セクションを参照してください。 ここで指定した背景色は、次の項目にも適用されることに注意してください。
|
"#" または名前付き色の前に 3 バイトの 16 進数。 | はい | |
| 説明 | アプリの説明。 この文字列はローカライズ可能です。詳細については、「解説」を参照してください。 |
タブ、キャリッジ リターン、改行などの文字を含めることができない、1 ~ 2048 文字の長さの文字列。 | はい | |
| 表示名 | ユーザーに表示できるアプリのフレンドリ名。 この文字列はローカライズ可能です。詳細については、「解説」を参照してください。 Microsoft Storeにアップロードされたアプリの DisplayName として使用できない明示的に予約された単語は、"NoUIEntryPoints" と "NoUIEntryPoints-DesignMode" の 2 つです。 これらの識別子は、開発ツールとテスト スイートで使用するために予約されています。 |
長さが 1 ~ 256 文字の文字列。 | はい | |
| ForegroundText | アプリ タイルの前景色を指定します。
|
この属性は、次のいずれかの値になります。
|
はい | |
| ロゴ | アプリの正方形のタイルとして使用される画像。 この属性でイメージを指定する方法の詳細については、「解説」を参照してください。 |
".jpg"、".png"、または "jpeg" で終わる長さが 1 ~ 256 文字の文字列です。この文字列には、次の文字を含めることはできません:<>、:、%、"、"、|、?、または *。 この文字列では、/ 文字と \ 文字を最初または最後の文字にすることはできません。 また、文字列には /または \ を含めることができますが、両方を含めることもできます。 | はい | |
| SmallLogo | アプリを識別するためにタイルの隅に表示される小さな画像。 この属性でイメージを指定する方法の詳細については、「解説」を参照してください。
|
".jpg"、".png"、または "jpeg" で終わる長さが 1 ~ 256 文字の文字列です。この文字列には、次の文字を含めることはできません:<>、:、%、"、"、|、?、または *。 この文字列では、/ 文字と \ 文字を最初または最後の文字にすることはできません。 また、文字列には /または \ を含めることができますが、両方を含めることもできます。 | はい | |
| ToastCapable | 値 true は、アプリがトースト通知を提供することを許可されていることを示します。 既定値は false です。 トースト通知を表示しない場合は、この属性の値を指定しないでください。 アプリでは、この値に基づいてトースト通知を送信するかどうかを決定しないでください。 |
boolean | いいえ |
子要素
| 子要素 | 説明 |
|---|---|
| DefaultTile | スタート画面でアプリを表す既定のタイル。 このタイルは、アプリが最初にインストールされると、更新通知を受信する前に表示されます。 タイルに表示する通知がない場合、タイルはこの既定値に戻ります。 |
| InitialRotationPreference | 最適なユーザー エクスペリエンスのためにアプリが表示される方向について説明します。 タブレットなど、回転可能なデバイスでは、ここで指定されていない向きに対してアプリは再描画されません。 たとえば、アプリで横向きと横向き向きのみを指定し、デバイスが縦向きに回転した場合、アプリは回転しません。 回転できないデバイスでは、そのデバイスの既定の向きでアプリが表示される場合があり、アプリの優先方向は無視されることに注意してください。 ただし、回転ロックがアクティブになっているデバイスでは、アプリの優先ローテーションが引き続き受け入れられます。 これらの方向の基本設定の選択は、[スプラッシュ画面](element-splashscreen.md)とアプリの新しいセッションが起動されたときのアプリ UI の両方に適用されます。 基本設定は、[AutoRotationPreferences](/uwp/api/Windows を使用して実行時に変更できます。Graphics.Display.DisplayProperties) プロパティ。 |
| LockScreen | システムがロックされたときに表示される、ロック画面でアプリを表すバッジと通知を定義します。 |
| SplashScreen | 起動中にアプリによって表示されるスプラッシュ画面の外観を定義します。 |
親要素
| Parent 要素 | 説明 |
|---|---|
| Application | パッケージで提供される機能の一部または全部を構成するアプリを表します。 |
解説
タイルディメンションの要件の詳細については、「 タイルサイズ」を参照してください。
ロゴ と SmallLogo イメージは、イメージ ファイルへの直接パスまたはリソースとして指定できます。 リソース参照を使用すると、Windows がデバイスと画面の解像度に最適なサイズを選択できるように、さまざまなスケールの画像を提供できます。 アクセシビリティのためのハイ コントラスト画像や、さまざまな UI 言語に対応するローカライズされた画像を提供することもできます。 この機能では、 DisplayName 属性と Description 属性をローカライズすることもできます。 詳細については、「 グローバリゼーション 」トピックを参照してください。
Applications/Application/Extensions/Extension/FileTypeAssociation/Logo Applications/Application/Extensions/Extension/Protocol/Logo
2 種類のロゴ画像のサイズ要件を次に示します。
Image attribute Scale Image size in pixels Applications\Application\VisualElements\@Logo 100 150x150 140 210x210 180 270x270 Applications\Application\VisualElements\@SmallLogo 100 30x30 140 42x42 180 54x544
サポートされている背景色の名前は次のとおりです。
| 名前 | 名前 | 名前 | 名前 | 名前 | 名前 |
|---|---|---|---|---|---|
| aliceBlue | antiqueWhite | aqua | aquamarine | azure | beige |
| bisque | black | blanchedAlmond | blue | blueViolet | brown |
| burlyWood | cadetBlue | chartreuse | chocolate | coral | cornflowerBlue |
| cornsilk | crimson | cyan | darkBlue | darkCyan | darkGoldenrod |
| darkGray | darkGreen | darkKhaki | darkMagenta | darkOliveGreen | darkOrange |
| darkOrchid | darkRed | darkSalmon | darkSeaGreen | darkSlateBlue | darkSlateGray |
| darkTurquoise | darkViolet | deepPink | deepSkyBlue | dimGray | ドッジャーブルー |
| firebrick | floralWhite | forestGreen | fuchsia | gainsboro | ghostWhite |
| gold | goldenrod | gray | green | greenYellow | honeydew |
| hotPink | indianRed | indigo | ivory | khaki | lavender |
| lavenderBlush | lawnGreen | lemonChiffon | ライトブルー | lightCoral | lightCyan |
| lightGoldenrodYellow | lightGreen | lightGray | lightPink | lightSalmon | lightSeaGreen |
| lightSkyBlue | lightSlateGray | lightSteelBlue | lightYellow | lime | limeGreen |
| linen | magenta | maroon | mediumAquamarine | mediumBlue | mediumOrchid |
| mediumPurple | mediumSeaGreen | mediumSlateBlue | mediumSpringGreen | mediumTurquoise | mediumVioletRed |
| midnightBlue | mintCream | mistyRose | moccasin | ナバホホワイト | navy |
| oldLace | olive | oliveDrab | orange | orangeRed | orchid |
| paleGoldenrod | paleGreen | paleTurquoise | paleVioletRed | パパヤホイップ | peachPuff |
| peru | pink | plum | powderBlue | purple | 赤 |
| rosyBrown | royalBlue | サドルブラウン | salmon | sandyBrown | seaGreen |
| 貝殻 | sienna | silver | スカイブルー | slateBlue | slateGray |
| snow | springGreen | steelBlue | tan | teal | thistle |
| tomato | transparent | turquoise | violet | wheat | 白 |
| 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>
こちらもご覧ください
クイック スタート: Visual Studio マニフェスト エディターを使用して既定のタイルを作成する
要件
| 値 | |
|---|---|
| Namespace | http://schemas.microsoft.com/appx/2010/manifest |
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示