uap3:VisualElements (Windows 10)
Descreve os aspectos visuais do aplicativo: seu bloco padrão, imagens de logotipo, cores de texto e plano de fundo, orientação inicial da tela, tela inicial e aparência do bloco de tela de bloqueio.
Hierarquia de elementos
<uap3:VisualElements>
Syntax
<uap3:VisualElements
DisplayName = 'A string with a value between 1 and 256 characters in length. This string is localizable.'
Description = 'A string between 1 and 2048 characters in length.'
BackgroundColor = 'A three-byte hexadecimal number preceded by "#" or a named color. See Remarks for a list of named colors.'
Square150x150Logo = 'A string with a value between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that cannot contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters cannot be the first or last characters. Also, the string can contain / or \ but not both.'
Square44x44Logo = 'A string with a value between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that cannot contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters cannot be the first or last characters. Also, the string can contain / or \ but not both.'
AppListEntry = 'An optional string that can have one of the following values: "default" or "none".'
VisualGroup = 'A string with a value between 1 and 256 characters in length that does not contain backslashes ("\").' />
<!-- Child elements -->
uap:DefaultTile?
& uap:LockScreen?
& uap:SplashScreen?
& uap:InitialRotationPreference?
</uap3:VisualElements>
Chave
? conector de intercalação opcional (zero ou um) & (pode ocorrer em qualquer ordem)
Atributos e elementos
Atributos
| Atributo | Descrição | Tipo de dados | Obrigatório | Valor padrão |
|---|---|---|---|---|
| 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. | Uma cadeia de caracteres com um valor entre 1 e 256 caracteres de comprimento. Essa cadeia de caracteres é localizável. | 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. | Yes | |
| BackgroundColor | Especifica a cor da tela de fundo do bloco do aplicativo. | Um número hexadecimal de três bytes precedido por # ou uma cor nomeada. Consulte Comentários para obter uma lista de cores nomeadas . |
Yes | |
| Square150x150Logo | Uma imagem usada como bloco médio tela inicial do aplicativo e no Alternador de Tarefas. Para obter mais informações sobre como especificar a imagem nesse atributo, consulte Comentários. | Uma cadeia de caracteres com um valor entre 1 e 256 caracteres de comprimento que termina com , ou que não pode conter esses caracteres: <, >, :, , "|, ?ou *..jpeg.png.jpg Nessa cadeia de caracteres, os / caracteres e \ não podem ser os primeiros ou os últimos caracteres. Além disso, a cadeia de caracteres pode conter / ou \ não ambos. |
Yes | |
| Square44x44Logo | Uma imagem usada como bloco pequeno tela inicial do aplicativo e na Lista de Todos os Aplicativos. Para obter mais informações sobre como especificar a imagem nesse atributo, consulte Comentários. | Uma cadeia de caracteres com um valor entre 1 e 256 caracteres de comprimento que termina com , ou que não pode conter esses caracteres: <, >, :, , "|, ?ou *..jpeg.png.jpg Nessa cadeia de caracteres, os / caracteres e \ não podem ser os primeiros ou os últimos caracteres. Além disso, a cadeia de caracteres pode conter / ou \ não ambos. |
Yes | |
| AppListEntry | A entrada na Lista de Todos os Aplicativos. | Uma cadeia de caracteres opcional que pode ter um dos seguintes valores: padrão ou nenhum. | No | |
| VisualGroup | O nome de uma pasta a ser criada na Lista de Todos os Aplicativos, na qual o bloco do aplicativo deve ser armazenado. | Uma cadeia de caracteres com um valor entre 1 e 256 caracteres de comprimento que não contém barras invertidas (\) ou espaços. |
No |
Observação
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 na Loja.
Elementos filho
| Elemento filho | Descrição |
|---|---|
| uap:DefaultTile | Define 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 a serem exibidas, o bloco é revertido para esse padrão. |
| uap:LockScreen | Define o selo e as notificações que representam o aplicativo na tela de bloqueio, que é mostrada quando o sistema está bloqueado. |
| uap:SplashScreen | Define a aparência da tela inicial, que é exibida pelo aplicativo durante a inicialização. |
| uap:InitialRotationPreference | Descreve as orientações nas quais o aplicativo prefere ser mostrado para obter a melhor experiência do usuário. |
Elementos pai
| Elemento pai | Descrição |
|---|---|
| Aplicativo | Representa um aplicativo que compreende parte ou toda a funcionalidade entregue no pacote. |
Comentários
Você não pode usar o atributo VisualGroup para criar uma estrutura de pastas aninhadas. Se você incluir uma barra invertida (\) no valor , ocorrerá um erro.
O atributo VisualGroup não será válido se o manifesto declarar apenas um aplicativo.
Para obter mais informações sobre os requisitos de dimensão do bloco, consulte Tamanhos de bloco.
Para as imagens Square150x150Logo e Square44x44Logo , você pode fornecer imagens de diferentes escalas 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 localizar os atributos DisplayName e Description . Para obter mais informações, consulte os tópicos Globalização e Localização do manifesto do pacote .
Os requisitos de tamanho de dois tipos de imagens de logotipo são mostrados aqui:
| Atributo de imagem | Escala (Tamanho da imagem em pixels) |
|---|---|
Applications/Application/VisualElements/@Square150x150Logo |
100 (150x150) |
| 250 (375x375) | |
Applications/Application/VisualElements/@Square44x44Logo |
100 (44x44) |
| 250 (110x110) | |
Applications/Application/VisualElements/@Tall150x310Logo |
100 (150x310) |
| 250 (375x775) |
Estes são os nomes de cor da tela de fundo com suporte:
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
lightGray
Lightgreen
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 cria uma pasta chamada App1 na Lista de Todos os Aplicativos e armazena o bloco do App1 nessa pasta.
<Package
xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"
IgnorableNamespaces="... desktop">
<Applications>
<Application>
<uap3:VisualElements
DisplayName="App1"
Square150x150Logo="images/150x150.png"
Square44x44Logo="images/44x44.png"
Description="App1"
BackgroundColor="#777777"
AppListEntry="default"
VisualGroup="App1">
<uap:SplashScreen
BackgroundColor="#777777"
Image="images/splash.png"/>
</uap3:VisualElements>
</Application>
</Applications>
</Package>
Tópicos relacionados
Requisitos
| Item | Valor |
|---|---|
| Namespace | http://schemas.microsoft.com/appx/manifest/uap/windows10/3 |
| Minimum OS Version | Windows 10 versão 1607 (Build 14393) |
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de