uap3:VisualElements (Windows 10)

  • Artigo

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

<Pacote>

      <Aplicativos>

            <Aplicativo>

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

Requisitos

Item Valor
Namespace http://schemas.microsoft.com/appx/manifest/uap/windows10/3
Minimum OS Version Windows 10 versão 1607 (Build 14393)