uap:VisualElements (Windows 10)

Descreve os aspetos visuais do aplicativo: seu bloco padrão, imagens de logotipo, texto e cores de plano de fundo, orientação inicial da tela, tela inicial e aparência do bloco da tela de bloqueio.

Hierarquia de elementos

<Package>
   └─ <Applications>
      └─ <Application>
         └─ <uap:VisualElements>

Sintaxe

<uap:VisualElements
    DisplayName = 'A string with a value between 1 and 256 characters. This string is localizable.' 
    Description = 'A string between 1 and 2048 characters.'
    BackgroundColor = 'A three-byte hexadecimal number preceded by "#" or a named color. See Remarks for a list of named colors.'
    Square150x150Logo = 'A string 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 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".' >

  <!-- Child elements -->
  uap:DefaultTile?
  & uap:LockScreen?
  & uap:SplashScreen?
  & uap:InitialRotationPreference?

</uap:VisualElements>

Chave

? conector de intercalação opcional (zero ou um) & (pode ocorrer em qualquer ordem)

Atributos e elementos

Attributes

Attribute Descrição Tipo de dados Obrigatório Valor predefinido
DisplayName Um nome amigável para a aplicação que pode ser mostrado aos utilizadores. Esta cadeia é localizável; ver Observações para mais detalhes. Uma cadeia com um valor entre 1 e 256 caracteres. Esta cadeia de caracteres é localizável. Sim
Descrição A descrição do aplicativo. Esta cadeia é localizável; ver Observações para mais detalhes. Uma cadeia entre 1 e 2048 caracteres. Sim
Cor de fundo Especifica a cor de fundo do bloco da aplicação. Consulte a secção de Observações para nomes de cores. Sim
Quadrado150x150Logótipo Uma imagem usada como bloco médio do ecrã de início da aplicação e no Switch de Tarefas. Para mais informações sobre como especificar a imagem neste atributo, veja Observações. Uma cadeia entre 1 e 256 caracteres que termina em .jpg, , ou .jpeg que não pode conter estes caracteres: <, >, :, ", |, ?, , ou *.png. Nesta cadeia, os / caracteres e \ não podem ser o primeiro ou o último caractere. Além disso, a corda pode conter / ou \ , mas não ambos. Sim
Quadrado44x44Logótipo Uma imagem usada como pequeno bloco do ecrã inicial da aplicação, e na lista de Todas as Aplicações. Para mais informações sobre como especificar a imagem neste atributo, veja Observações. Uma cadeia entre 1 e 256 caracteres que termina em .jpg, , ou .jpeg que não pode conter estes caracteres: <, >, :, ", |, ?, , ou *.png. Nesta cadeia, os / caracteres e \ não podem ser o primeiro ou o último caractere. Além disso, a corda pode conter / ou \ , mas não ambos. Sim
AppListEntry A entrada na Lista de Todas as Aplicações. Selecione nenhum para pontos de entrada que não precisem de peças do menu inicial. Uma cadeia opcional que pode ter um dos seguintes valores: "default" ou "nenhum". Não default

Observação

A cor de fundo aqui especificada também se aplica a estes itens:

  • A cor dos botões em qualquer caixa de diálogo pertencente à aplicação
  • A página de Descrição da App na Loja

Elementos filhos

Elemento subordinado Descrição
uap:DefaultTile O bloco padrão que representa o aplicativo na tela inicial. Este mosaico é apresentado quando a aplicação é instalada pela primeira vez, antes de receber quaisquer notificações de atualização. Quando um bloco não tem notificações para mostrar, o bloco reverte para esse padrão.
uap:InitialRotationPreference Descreve as orientações nas quais o aplicativo prefere ser mostrado para a melhor experiência do usuário. Num dispositivo que pode ser rodado, como um tablet, a aplicação não será redesenhada para orientações que não estejam aqui especificadas. Por exemplo, se a aplicação especificar apenas Landscape as orientações e LandscapeFlipped o dispositivo estiver rodado para uma Portrait orientação, a aplicação não rodará.
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 do ecrã inicial, que é exibido pela aplicação durante o lançamento.

Observação

Em dispositivos que não podem ser rodados, uma aplicação pode ser mostrada na orientação padrão desse dispositivo e a orientação preferida da aplicação será ignorada. No entanto, num dispositivo com bloqueio de rotação ativado, a rotação preferida da sua aplicação continuará a ser respeitada.

Estas escolhas de preferência de orientação aplicam-se tanto ao ecrã de arranque como à interface da aplicação quando uma nova sessão é iniciada para a sua aplicação. As preferências podem ser alteradas durante a execução através da propriedade AutoRotationPreferences.

Elementos principais

Elemento pai Descrição
Application Representa um aplicativo que compreende parte ou toda a funcionalidade fornecida no pacote.

Observações

Para mais informações sobre os requisitos de dimensões dos azulejos, consulte Tamanhos dos azulejos.

Para as imagens Square150x150Logo e Square444Logo, pode fornecer imagens de diferentes escalas para que Windows possa escolher o melhor tamanho para o dispositivo e a resolução do ecrã. Também pode fornecer imagens de alto contraste para acessibilidade e imagens localizadas para corresponder a diferentes linguagens de interface. Esta funcionalidade também permite localizar os atributos DisplayName e Description . Para mais informações, consulte o tópico Globalização .

Applications/Application/Extensões/Extensão/AssociaçãoDeTipoDeFicheiro/Logótipo Applications/Application/Extensões/Extensão/Protocolo/Logótipo

Os requisitos de tamanho para dois tipos de imagens de logótipos são apresentados aqui:

Atributo 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 das cores de fundo suportadas:

aliceBlue
antiqueWhite
aqua
Água-marinha
azure
bege
Bisque
preto
Amêndoa pálida.
azul
blueViolet
castanho
burlyWood
CadetBlue
Chartreuse
chocolate
coral
Azul de centáurea
seda de milho
carmesim
ciano
Azul-escuro
darkCyan
Vara-dourada escura

Cinzento-escuro
Verdeescuro
DarkKhaki
darkMagenta
VerdeAzeitona escuro.
Laranja-escuro
darkOrchid
vermelho escuro
salmão escuro
BlackSeaGreen
darkSlateBlue
escuroCinza-Ardósia
Turquesa escura
darkViolet
deepPink
deepSkyBlue
dimGray
dodgerBlue
tijolo refratário
floralWhite
Verde-floresta
fúcsia
Gainsboro
ghostWhite

Ouro
Vara de ouro
cinzento
verde
verdeAmarelo
melado
hotPink
indianRed
índigo
marfim
caqui
lavanda
lavandaBlush
LawnGreen
lemonChiffon
Azul-claro
lightCoral
lightCyan
Luz DouradoAmarelo
cinza claro
Verdeclaro
Rosa claro
LightSalmon
lightSeaGreen

lightSkyBlue
LuzCinza-Ardósia
lightSteelBlue
Amarelo claro
Cal
Verdelimão
linho
magenta
quilombola
médioÁgua-marinha
Médio Azul
Orquídea média
médioRoxo
médioSeaGreen
médioSlateBlue
MédioPrimaveraVerde
médioTurquesa
mediumVioletRed
MidnightBlue
MintCream
mistyRose
Mocassin
NavajoWhite

Marinha
velho Laca
Olive
oliveDrab
laranja
laranjaVermelho
Orquídea
PaleGoldenrod
Verde-pálido
Turquesa pálida
paleVioletRed
PapayaWhip
pêssegoPuff
Peru
cor-de-rosa
ameixa
powderBlue
roxo
vermelho
RosyBrown
Royal Blue
saddleBrown
Salmão

SandyBrown
seaGreen
seaShell
Sienna
prata
skyBlue
slateBlue
ardósiaGray
neve
SpringGreen
steelBlue
bronzeado
Azul-marinho
cardo
tomate
transparente
turquesa
Violet
Trigo
branco
Fumo branco
amarelo
amarelo-verde

Exemplos

O exemplo seguinte é retirado do manifesto do pacote de uma amostra SDK.

<Applications>
    <Application Id="App" StartPage="default.html">
        <uap:VisualElements 
            DisplayName="ApplicationDataSample"
            Description="Application data sample"
            BackgroundColor="#FFFFFF"               
            Square150x150Logo="images\squareTile-sdk.png" 
            Square44x44Logo="images\smallTile-sdk.png" 
            AppListEntry="default">
            <uap:DefaultTile
                ShowName="allLogos" />
            <uap:LockScreen
                Notification="badge"
                BadgeLogo="images\badgeLogo.png" />
            <uap:SplashScreen
                BackgroundColor="white"
                Image="images\splash-sdk.png" />
            <uap:InitialRotationPreference> 
                <uap:Rotation
                    Preference="portrait" />
            </uap:InitialRotationPreference>            
        </uap:VisualElements>
    </Application>
</Applications>

Consulte também

Requerimentos

Número valor
Espaço de nomes http://schemas.microsoft.com/appx/manifest/uap/windows10
Versão mínima do SO Windows 10 versão 1511 (Build 10586)
  • Last updated on