VisualElements (Windows 8.1 の拡張機能スキーマ)
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>
キー
? 省略可能 (0 または 1)
& インターリーブ コネクタ (任意の順序で発生する可能性があります)
属性および要素
属性
| 属性 | 説明 | データ型 | 必須 | 既定値 |
|---|---|---|---|---|
| BackgroundColor | アプリ タイルの背景色を指定します。 色名については、「解説」セクションを参照してください。 ここで指定した背景色は、次の項目にも適用されます。
適用対象: Windows Phone透明] を選択すると、システムのアクセント カラーが使用されます。 |
"#" または名前付き色の前に 3 バイトの 16 進数。 | はい | |
| 説明 | アプリの説明。 この文字列はローカライズ可能です。詳細については、「解説」を参照してください。 |
タブ、復帰、改行などの文字を含めることはできません。長さが 1 ~ 2048 文字の文字列。 | Yes | |
| DisplayName | ユーザーに表示できるアプリの表示名。 この文字列はローカライズ可能です。詳細については、「解説」を参照してください。 Microsoft Store にアップロードされたアプリの DisplayName として使用できない明示的に予約された単語が 2 つあります。"NoUIEntryPoints" と "NoUIEntryPoints-DesignMode" です。 これらの識別子は、開発ツールとテスト スイートで使用するために予約されています。 |
長さが 1 ~ 256 文字の文字列。 この文字列はローカライズ可能です。 | はい | |
| ForegroundText | アプリ タイルの前景色を指定します。 適用対象: Windows Phone透明] を選択すると、システムのアクセント カラーが使用されます。 |
この属性は、次のいずれかの値になります。
|
Yes | |
| ロゴ | アプリの正方形のタイルとして使用される画像。 この属性でイメージを指定する方法の詳細については、「解説」を参照してください。 |
長さが 1 ~ 256 文字の文字列で、".jpg"、".png"、または ".jpeg" で終わる文字列。これらの文字を含めることはできません: <、 >、:、、"、|、?、または *。 この文字列では、 / 文字と \ 文字を最初または最後の文字にすることはできません。 また、文字列には / または \ を含め、両方を含め"、" は含め"、" は含め | Yes | |
| SmallLogo | アプリを識別するためにタイルの隅に表示される小さな画像。 この属性でイメージを指定する方法の詳細については、「解説」を参照してください。 適用対象: Windows Phone: Windows Phoneタイルの小さなロゴはサポートされていません。 これは、アプリの一覧でのみ使用されます。 |
長さが 1 ~ 256 文字の文字列で、".jpg"、".png"、または ".jpeg" で終わる文字列。これらの文字を含めることはできません: <、 >、:、、"、|、?、または *。 この文字列では、 / 文字と \ 文字を最初または最後の文字にすることはできません。 また、文字列には / または \ を含め、両方を含め"、" は含め"、" は含め | はい | |
| ToastCapable | 値 true は 、 アプリがトースト通知を提供できる状態を示します。 既定値は false です。 トースト通知を表示しない場合は、この属性の値を指定しない。 アプリでは、この値に基づいてトースト通知を送信するかどうかを決定する必要はない点に注意してください。 |
boolean | いいえ |
子要素
| 子要素 | 説明 |
|---|---|
| DefaultTile | アプリのアプリを表す既定のタイルスタート画面。 このタイルは、アプリが最初にインストールされた時点で、更新通知を受信する前に表示されます。 タイルに表示する通知がない場合、タイルは既定に戻されます。 |
| InitialRotationPreference | 最適なユーザー エクスペリエンスのためにアプリを表示する方向について説明します。 タブレットなど、回転できるデバイスでは、ここで指定されていない向きに対してアプリが再描画されません。 たとえば、アプリが横向きと横向きのみを指定し、デバイスが縦向きに回転する場合、アプリは回転されません。 回転できないデバイスでは、そのデバイスの既定の向きにアプリが表示され、アプリの優先方向は無視される可能性があります。 ただし、ローテーション ロックがアクティブになっているデバイスでは、アプリの優先ローテーションは引き続き受け入れらされます。 これらの向きの基本設定の選択は、[スプラッシュ スクリーン](element-splashscreen.md) とアプリの UI の両方に適用され、アプリの新しいセッションが起動されます。 ユーザー設定は、[AutoRotationPreferences](/uwp/api/Windows を使用して実行時に変更できます。Graphics.Display.DisplayInformation) プロパティ。 |
| LockScreen | システムがロックされているときに表示される、ロック画面のアプリを表すバッジと通知を定義します。 |
| SplashScreen | 起動中にアプリによって表示されるスプラッシュ スクリーンの外観を定義します。 |
親要素
この最も外側の (ドキュメント) 要素は、他の要素には含めできません。
注釈
タイル ディメンションの要件の詳細については、「タイルのサイズ」 を参照してください。
ロゴ と SmallLogo イメージは、イメージ ファイルへの直接パスとして、またはリソースとして指定できます。 リソース参照を使用すると、Windows がデバイスと画面の解像度に最適なサイズを選択できるように、さまざまなスケールの画像を提供できます。 アクセシビリティのためのハイ コントラスト画像や、さまざまな UI 言語に対応するローカライズされた画像を提供することもできます。 この機能を使用すると、DisplayName 属性と Description 属性をローカライズすることもできます。 詳細については、グローバリゼーションに関 するトピックを参照 してください。
Applications/Application/Extensions/Extension/FileTypeAssociation/Logo Applications/Application/Extensions/Protocol/Logo
次に示すのは、2 種類のロゴ 画像のサイズ要件です。
イメージ属性スケールイメージのサイズ (ピクセル単位) Application/Application\ visual30x30 の \ @Logo 100 150x150 正方形 140 210x210 180 270x270 アプリケーション \ visual \ @SmallLogo 100 140 42x42 180 54x54
サポートされている背景色の名前は次のとおりです。
| 名前 | 名前 | 名前 | 名前 | 名前 | 名前 |
|---|---|---|---|---|---|
| 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 | dodgerBlue |
| firebrick | floralWhite | forestGreen | fuchsia | gainsboro | ghostWhite |
| gold | goldenrod | gray | green | greenYellow | honeydew |
| ホットピンク | indianRed | indigo | ivory | khaki | lavender |
| lavenderBlush | lawnGreen | lemonChiffon | lightBlue | lightCoral | 水色 |
| lightGoldenrodYellow | ライトグリーン | lightGray | ライトピンク | ライトサーモンサーモン | lightSeaGreen |
| lightSkyBlue | ライト Slategray | ライト Steelblue | ライト黄 | lime | limeGreen |
| linen | magenta | maroon | mediumAquamarine | mediumBlue | mediumOrchid |
| mediumPurple | mediumSeaGreen | mediumSlateBlue | mediumSpringGreen | mediumTurquoise | mediumVioletRed |
| midnightBlue | mintCream | ミスティローズ | moccasin | ナビゲーションのホワイト | navy |
| oldLace | olive | oliveDrab | orange | またはピアリング | orchid |
| ・・・・・・・・・・・・・・ロッド | 中 Egreen | 男性 Eターコイズ | 中 ~ の Etred | papayaWhip | peachPuff |
| peru | pink | plum | powderBlue | purple | 赤 |
| rosyBrown | royalBlue | saddleBrown | salmon | sandyBrown | seaGreen |
| 貝殻 | sienna | silver | skyBlue | slateBlue | slateGray |
| snow | springGreen | steelBlue | tan | teal | thistle |
| tomato | transparent | turquoise | violet | wheat | 白 |
| ホワイトリスト | 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」を参照してください。
フィードバックの送信と表示