uap:VisualElements (Windows 10)

Descreve os aspectos visuais do aplicativo: seu bloco padrão, imagens de logotipo, cores de texto e plano de fundo, orientação inicial da tela, tela inicial e aparência do bloco de tela de bloqueio.

Hierarquia de elementos

<Package>
   └─ <Applications>
      └─ <Application>
         └─ <uap:VisualElements>

Sintaxe

<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>

Chave

? conector de intercalação opcional (zero ou um) & (pode ocorrer em qualquer ordem)

Atributos e elementos

Atributos

Elementos filho

Elementos pai

Observações

Para obter mais informações sobre os requisitos de dimensão do bloco, consulte tamanhos de bloco.

Para as imagens Square150x150Logo e Square44x44Logo, você pode fornecer imagens de escalas diferentes para que Windows possa escolher o melhor tamanho para o dispositivo e a resolução de tela. Você também pode fornecer imagens de alto contraste para acessibilidade e imagens localizadas para corresponder a diferentes idiomas da interface do usuário. Esse recurso também permite que você localize os atributos DisplayName e Description . Para obter mais informações, consulte o tópico Globalização .

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

Os requisitos de tamanho de dois tipos de imagens de logotipo são mostrados aqui:

Estes são os nomes de cores de plano de fundo com suporte:

Exemplos

O exemplo a seguir é extraído do manifesto do pacote de um exemplo de 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>                             

Consulte também

• Capturas de tela e imagens do aplicativo
• classe Colors
• Quickstart: criando um bloco padrão usando o editor de manifesto Visual Studio

Requisitos