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