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:
|
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.
|
Esse atributo pode ter um dos seguintes valores:
|
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.
|
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
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 |