uap3:VisualElements (Windows 10)

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

要素の階層

<パッケージ>

      <アプリケーション>

            <Application>

                  <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) & インターリーブ コネクタ (任意の順序で発生する可能性があります)

属性と要素

属性

子要素

親要素

注釈

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

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

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

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

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

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

例

次の例では、[すべてのアプリ] リストに 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>

関連トピック

• Colors クラス
• クイック スタート: Visual Studio マニフェスト エディターを使用して既定のタイルを作成する

要件