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