Compartilhar via


VisualElements (esquema de extensões para Windows 8.1)

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

Hierarquia de elementos

<VisualElements>

Syntax

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

Chave

? opcional (zero ou um)

& conector de intercalar (pode ocorrer em qualquer ordem)

Atributos e elementos

Atributos

Atributo Descrição Tipo de dados Obrigatório Valor padrão
BackgroundColor

Especifica a cor da tela de fundo do seu aplicativo. Consulte a seção Comentários para ver os nomes de cores. Observe que a cor da tela de fundo especificada aqui também se aplica a estes itens:

  • A cor do botão em qualquer caixa de diálogo de propriedade do aplicativo
  • A página Descrição do Aplicativo no Microsoft Store

Aplica-se Windows Phone: escolher "transparente" faz com que a cor de destaque do sistema seja usada.

Um número hexadecimal de três byte precedido por "#" ou uma cor nomeada. Sim
Descrição

A descrição do aplicativo. Essa cadeia de caracteres é localizável; consulte Comentários para obter detalhes.

Uma cadeia de caracteres entre 1 e 2048 caracteres que não pode incluir caracteres como guias, retornos de carro e feeds de linha. Sim
DisplayName

Um nome amigável para o aplicativo que pode ser exibido aos usuários. Essa cadeia de caracteres é localizável; consulte Comentários para obter detalhes.

Há duas palavras explicitamente reservadas que podem não ser usadas como DisplayName para aplicativos carregados no Microsoft Store: "NoUIEntryPoints" e "NoUIEntryPoints-DesignMode". Esses identificadores são reservados para uso das ferramentas de desenvolvimento e dos pacotes de teste.

Uma cadeia de caracteres entre 1 e 256 caracteres de comprimento. Essa cadeia de caracteres é localizável. Yes
ForegroundText

Especifica a cor de primeiro plano do azulamento do aplicativo.

Aplica-se Windows Phone: escolher "transparente" faz com que a cor de destaque do sistema seja usada.

Esse atributo pode ter um dos seguintes valores:

  • luz
  • Escuro
Yes
Logotipo

Uma imagem usada como o lado quadrado do aplicativo. Para obter mais informações sobre como especificar a imagem nesse atributo, consulte Comentários.

Uma cadeia de caracteres entre 1 e 256 caracteres que termina com ".jpg", ".png" ou ".jpeg" que não pode conter esses caracteres: <, >, :, ", |, ?ou *. Nessa cadeia de caracteres, os caracteres /e \ não podem ser o primeiro ou o último caractere. Além disso, a cadeia de caracteres pode conter /ou \ mas não ambos. Yes
SmallLogo

Uma imagem pequena mostrada no canto do lado do lado para identificar o aplicativo. Para obter mais informações sobre como especificar a imagem nesse atributo, consulte Comentários.

Aplica-se Windows Phone: Windows Phone não dá suporte ao logotipo pequeno no grupo. Ele é usado somente na lista Aplicativos.

Uma cadeia de caracteres entre 1 e 256 caracteres que termina com ".jpg", ".png" ou ".jpeg" que não pode conter esses caracteres: <, >, :, ", |, ?ou *. Nessa cadeia de caracteres, os caracteres /e \ não podem ser o primeiro ou o último caractere. Além disso, a cadeia de caracteres pode conter /ou \ mas não ambos. Yes
ToastCapable

Um valor true indica que o aplicativo tem permissão para fornecer notificações do toast. O valor padrão é false. Se você não quiser que as notificações do toast apareçam, não especifique um valor para esse atributo. Observe que os aplicativos não devem tomar decisões sobre se devem enviar notificações do toast com base nesse valor.

booleano Não

 

Elementos filho

Elemento filho Descrição
DefaultTile

Oile padrão que representa o aplicativo no tela inicial. Esse tile é exibido quando o aplicativo é instalado pela primeira vez, antes de receber notificações de atualização. Quando um tile não tem nenhuma notificação para mostrar, o tile é reversível para esse padrão.

InitialRotationPreference

Descreve as orientações nas quais o aplicativo prefere ser mostrado para a melhor experiência do usuário. Em um dispositivo que pode ser girado, como um tablet, o aplicativo não será redesenhado para orientações que não são especificadas aqui. Por exemplo, se o aplicativo especificar apenas as orientações Landscape e LandscapeFlipped e o dispositivo for girado para uma orientação Retrato, o aplicativo não girará.

Observe que, em dispositivos que não podem ser girados, um aplicativo pode ser mostrado na orientação padrão do dispositivo e a orientação preferencial do aplicativo será ignorada. No entanto, em um dispositivo com um bloqueio de rotação ativado, a rotação preferencial do aplicativo ainda será acodada.

Essas opções de preferência de orientação se aplicam à [tela inicial](element-splashscreen.md) e à interface do usuário do aplicativo quando uma nova sessão é lançada para seu aplicativo. As preferências podem ser alteradas durante o tempo de operação por meio de [AutoRotationPreferences](/uwp/api/Windows. Propriedade Graphics.Display.DisplayInformation).

LockScreen

Define a notificação e as notificações que representam o aplicativo na tela de bloqueio, que é mostrada quando o sistema está bloqueado.

SplashScreen

Define a aparência da tela inicial, que é exibida pelo aplicativo durante o lançamento.

 

Elementos pai

Esse elemento mais externo (documento) pode não estar contido por outros elementos.

Comentários

Para obter mais informações sobre os requisitos de dimensão deile, consulte Tamanhos de tile.

Imagensde Logotipo e SmallLogo podem ser fornecidas como um caminho direto para um arquivo de imagem ou como um recurso. Usando uma referência de recurso, você pode fornecer imagens de escalas diferentes, para que o 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 traduzidas para corresponder a diferentes idiomas da interface do usuário. Esse recurso também permite que você localize os atributos DisplayNamee Description . Para obter mais informações, consulte o tópico Globalização .

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

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

Tamanho da imagem de escala do atributo de imagem em pixels Applications\Application\VisualElements\ @Logo 100 150x150 140 210x210 180 270x270 Applications\Application\VisualElements\ @SmallLogo 100 30x30 140 42x42 180 54x54

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

Nome Nome Nome Nome Nome Nome
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 lightBlue lightCoral lightCyan
lightGoldenrodYellow lightGreen lightGray 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 navajoWhite navy
Oldlace olive Olivedrab orange Orangered orchid
Palegoldenrod paleGreen Paleturquoise Palevioletred Papayawhip Peachpuff
peru pink plum Powderblue purple vermelha
Rosybrown Royalblue Saddlebrown salmon Sandybrown Seagreen
Seashell sienna silver Skyblue Slateblue Slategray
snow Springgreen Steelblue tan teal thistle
tomato transparent turquoise violet wheat white
Whitesmoke yellow Yellowgreen

 

Exemplos

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

Confira também

Imagens e capturas de tela do aplicativo

Classe Colors

Início Rápido: Criando umile padrão usando o editor de Visual Studio de manifesto

Requisitos

Valor
Namespace http://schemas.microsoft.com/appx/2010/manifest