Compartilhar via


VisualElements (esquema de pacote para Windows 8)

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

Hierarquia de elementos

<Pacote>
<Aplicativos>
<Aplicativo>
<VisualElements>

Syntax

<VisualElements DisplayName     = A string between 1 and 256 characters in length.
                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.
                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 >

  <!-- Child elements -->
  ( DefaultTile?
  & LockScreen?
  & SplashScreen
  & InitialRotationPreference?
  )

</VisualElements>

Chave

? opcional (zero ou um)

& conector interleave (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 bloco do aplicativo. Consulte a seção Comentários para obter 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 a Windows Phone: escolher "transparente" faz com que a cor de ênfase do sistema seja usada.
Um número hexadecimal de três bytes 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 de comprimento que não pode incluir caracteres como guias, retornos de carro e feeds de linha. Yes
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. Yes
ForegroundText

Especifica a cor do primeiro plano do bloco do aplicativo.

  • Aplica-se a Windows Phone: esse valor é ignorado. Todos os blocos usam a cor do texto claro.

Esse atributo pode ter um dos seguintes valores:

  • luz
  • Escuro
Yes
Logotipo

Uma imagem usada como bloco 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 de comprimento que termina com ".jpg", ".png" ou ".jpeg" que não pode conter esses caracteres: <, , >:, %, |, ?, ou *. Nesta cadeia de caracteres, os caracteres /e \ não podem ser os primeiros ou últimos caracteres. Além disso, a cadeia de caracteres pode conter/ou \ mas não ambas. Yes
SmallLogo

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

  • Aplica-se a Windows Phone: Windows Phone não exibe o logotipo pequeno no bloco. Ele é usado apenas na lista Aplicativos.
Uma cadeia de caracteres entre 1 e 256 caracteres de comprimento que termina com ".jpg", ".png" ou ".jpeg" que não pode conter esses caracteres: <, , >:, %, |, ?, ou *. Nesta cadeia de caracteres, os caracteres /e \ não podem ser os primeiros ou últimos caracteres. Além disso, a cadeia de caracteres pode conter/ou \ mas não ambas. Yes
ToastCapable

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

booleano No

 

Elementos filho

Elemento filho Descrição
DefaultTile

O bloco padrão que representa o aplicativo na tela Inicial. Esse bloco é exibido quando o aplicativo é instalado pela primeira vez, antes de receber notificações de atualização. Quando um bloco não tem notificações para mostrar, o bloco é revertido para esse padrão.

InitialRotationPreference

Descreve as orientações nas quais o aplicativo prefere ser mostrado para obter 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 orientações Landscape e LandscapeFlipped e o dispositivo for girado para uma orientação Retrato, o aplicativo não será girado.

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á honrada.

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

LockScreen

Define o selo 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 a inicialização.

 

Elementos pai

Elemento pai Descrição
Aplicativo

Representa um aplicativo que compreende parte ou toda a funcionalidade entregue no pacote.

 

Comentários

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

Imagens de 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 DisplayName e Description . Para obter mais informações, consulte o tópico Globalização .

Aplicativos/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:

Tamanho da imagem do atributo Scale Image 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 cor da tela 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 é extraído 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 um bloco padrão usando o editor de manifesto Visual Studio

Requisitos

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