uap3:VisualElements (Windows 10)

[アーティクル]
10/30/2023

アプリの視覚的側面 (既定のタイル、ロゴ画像、テキストと背景色、初期画面の向き、スプラッシュスクリーン、ロック画面タイルの外観) について説明します。

要素の階層

<uap3:VisualElements>

構文

<uap3:VisualElements
    DisplayName = 'A string with a value between 1 and 256 characters in length. This string is localizable.' 
    Description = 'A string between 1 and 2048 characters in length.'
    BackgroundColor = 'A three-byte hexadecimal number preceded by "#" or a named color. See Remarks for a list of named colors.'
    Square150x150Logo = 'A string with a value between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that cannot contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters cannot be the first or last characters. Also, the string can contain / or \ but not both.'
    Square44x44Logo = 'A string with a value between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that cannot contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters cannot be the first or last characters. Also, the string can contain / or \ but not both.'
    AppListEntry = 'An optional string that can have one of the following values: "default" or "none".' 
    VisualGroup = 'A string with a value between 1 and 256 characters in length that does not contain backslashes ("\").' />

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

</uap3:VisualElements>

キー

? 省略可能 (0 または 1) & インターリーブコネクタ (任意の順序で発生する可能性があります)

属性と要素

属性

属性	説明	データ型	必須
DisplayName	ユーザーに表示できるアプリのフレンドリ名。この文字列はローカライズ可能です。詳細については、「解説」を参照してください。	長さが 1 ~ 256 文字の値を持つ文字列。この文字列はローカライズ可能です。	はい
説明	アプリの説明。この文字列はローカライズ可能です。詳細については、「解説」を参照してください。	長さが 1 ~ 2048 文字の文字列。	Yes
BackgroundColor	アプリタイルの背景色を指定します。	前に 3 バイトの 16 進数 `#` または名前付き色を指定します。名前付き色の一覧については、「解説」を参照してください。	Yes
Square150x150Logo	アプリの [スタート画面] メディアタイルとして使用され、タスクスイッチャーで使用されるイメージ。この属性でイメージを指定する方法の詳細については、「解説」を参照してください。	長さが 1 ~ 256 文字の文字列。末尾が、、またはの文字`>\|?":<`を含めることはできません。`*.jpeg.png.jpg` この文字列では、 `/` 文字と `\` 文字を先頭または最後の文字にすることはできません。また、文字列にはまたはを含めることができますが、両方は含`/\`められません。	Yes
Square44x44Logo	アプリの [スタート画面] 小さいタイルとして使用され、[すべてのアプリ] リストで使用される画像。この属性でイメージを指定する方法の詳細については、「解説」を参照してください。	長さが 1 ~ 256 文字の文字列。末尾が、、またはの文字`>\|?":<`を含めることはできません。`*.jpeg.png.jpg` この文字列では、 `/` 文字と `\` 文字を先頭または最後の文字にすることはできません。また、文字列にはまたはを含めることができますが、両方は含`/\`められません。	Yes
AppListEntry	[すべてのアプリ] リストのエントリ。	省略可能な文字列。既定値またはなしのいずれかの値を指定できます。	いいえ
VisualGroup	アプリのタイルを格納する必要がある [すべてのアプリ] リストに作成するフォルダーの名前。	円記号 (`\`) またはスペースを含まない長さが 1 ~ 256 文字の文字列。	いいえ

注意

ここで指定した背景色は、次の項目にも適用されます。

アプリ所有のダイアログボックスのボタンの色。
ストアの [アプリの説明] ページ。

子要素

子要素	説明
uap:DefaultTile	スタート画面でアプリを表す既定のタイルを定義します。このタイルは、アプリが最初にインストールされると、更新通知を受信する前に表示されます。タイルに表示する通知がない場合、タイルはこの既定値に戻ります。
uap:LockScreen	システムがロックされたときに表示される、ロック画面でアプリを表すバッジと通知を定義します。
uap:SplashScreen	起動時にアプリによって表示されるスプラッシュスクリーンの外観を定義します。
uap:InitialRotationPreference	最適なユーザーエクスペリエンスのためにアプリを表示する場合の向きについて説明します。

親要素

Parent 要素	説明
Application	パッケージで提供される機能の一部または全部を構成するアプリを表します。

注釈

VisualGroup 属性を使用して、入れ子になったフォルダーの構造を作成することはできません。値に円記号 (\) を含める場合は、エラーが発生します。

マニフェストが 1 つのアプリのみを宣言している場合、 VisualGroup 属性は無効です。

タイルディメンションの要件の詳細については、「タイルサイズ」を参照してください。

Square150x150Logo および Square44x44Logo イメージの場合は、さまざまなスケールの画像を提供して、Windows がデバイスと画面の解像度に最適なサイズを選択できるようにします。アクセシビリティのためのハイコントラスト画像や、さまざまな UI 言語に対応するローカライズされた画像を提供することもできます。この機能を使用すると、 DisplayName 属性と Description 属性をローカライズすることもできます。詳細については、パッケージマニフェストのグローバリゼーションとローカライズに関するトピックを参照してください。

2 種類のロゴ画像のサイズ要件を次に示します。

Image 属性	スケール (ピクセル単位の画像サイズ)
`Applications/Application/VisualElements/@Square150x150Logo`	100 (150x150)
	250 (375 x 375)
`Applications/Application/VisualElements/@Square44x44Logo`	100 (44 x 44)
	250 (110x110)
`Applications/Application/VisualElements/@Tall150x310Logo`	100 (150x310)
	250 (375 x 775)

サポートされている背景色の名前は次のとおりです。

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
hotPink
indianRed
indigo
ivory
khaki
lavender
lavenderBlush
lawnGreen
lemonChiffon
ライトブルー
lightCoral
lightCyan
lightGoldenrodYellow
lightGray
lightGreen
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
papayaWhip
peachPuff
peru
pink
plum
powderBlue
purple
赤
rosyBrown
royalBlue
saddleBrown
salmon

sandyBrown
seaGreen
貝殻
sienna
silver
スカイブルー
slateBlue
slateGray
snow
springGreen
steelBlue
tan
teal
thistle
tomato
transparent
turquoise
violet
wheat
白
Whitesmoke
yellow
yellowGreen

例

次の例では、[すべてのアプリ] リストに App1 という名前のフォルダーを作成し、そのフォルダーに App1 のタイルを格納します。

<Package
    xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"  
    IgnorableNamespaces="... desktop">
    <Applications>
        <Application>
            <uap3:VisualElements
                DisplayName="App1" 
                Square150x150Logo="images/150x150.png" 
                Square44x44Logo="images/44x44.png" 
                Description="App1" 
                BackgroundColor="#777777" 
                AppListEntry="default" 
                VisualGroup="App1">  
                <uap:SplashScreen
                    BackgroundColor="#777777" 
                    Image="images/splash.png"/>  
           </uap3:VisualElements>  
        </Application>
    </Applications>
</Package>

要件

Item	値
Namespace	`http://schemas.microsoft.com/appx/manifest/uap/windows10/3`
Minimum OS Version	Windows 10 バージョン 1607 (ビルド 14393)

次の方法で共有

uap3:VisualElements (Windows 10)

要素の階層

構文

キー

属性と要素

属性

子要素

親要素

注釈

例

要件

フィードバック

その他のリソース

次の方法で共有

uap3:VisualElements (Windows 10)

要素の階層

構文

キー

属性と要素

属性

子要素

親要素

注釈

例

関連トピック

要件

フィードバック

その他のリソース