uap:VisualElements (Windows 10)

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

要素の階層

<パッケージ>

    <アプリケーション>

         <Application>

              <uap:VisualElements>

構文

<uap:VisualElements
    DisplayName = 'A string with a value between 1 and 256 characters. This string is localizable.' 
    Description = 'A string between 1 and 2048 characters.'
    BackgroundColor = 'A three-byte hexadecimal number preceded by "#" or a named color. See Remarks for a list of named colors.'
    Square150x150Logo = 'A string 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 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".' >

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

</uap:VisualElements>

キー

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

属性と要素

属性

子要素

親要素

注釈

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

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

Applications/Application/Extensions/Extension/FileTypeAssociation/Logo Applications/Application/Extensions/Extension/Protocol/Logo

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

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

例

次の例は、SDK サンプルのパッケージ マニフェストから取得したものです。

<Applications>
    <Application Id="App" StartPage="default.html">
        <uap:VisualElements 
            DisplayName="ApplicationDataSample"
            Description="Application data sample"
            BackgroundColor="#FFFFFF"               
            Square150x150Logo="images\squareTile-sdk.png" 
            Square44x44Logo="images\smallTile-sdk.png" 
            AppListEntry="default">
            <uap:DefaultTile
                ShowName="allLogos" />
            <uap:LockScreen
                Notification="badge"
                BadgeLogo="images\badgeLogo.png" />
            <uap:SplashScreen
                BackgroundColor="white"
                Image="images\splash-sdk.png" />
            <uap:InitialRotationPreference> 
                <uap:Rotation
                    Preference="portrait" />
            </uap:InitialRotationPreference>            
        </uap:VisualElements>
    </Application>
</Applications>                             

こちらもご覧ください

• アプリのスクリーンショットと画像
• Colors クラス
• クイック スタート: Visual Studio マニフェスト エディターを使用して既定のタイルを作成する

必要条件