Partilhar via

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

              <uap:VisualElements>

Syntax

<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

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. 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. Yes
BackgroundColor Especifica a cor da tela de fundo do bloco do aplicativo. Consulte a seção Comentários para obter nomes de cores. 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 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 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. Selecione nenhum para pontos de entrada que não precisam de blocos de menu iniciar. Uma cadeia de caracteres opcional que pode ter um dos seguintes valores: "default" ou "none". No default

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 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: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 Landscape orientações e LandscapeFlipped e o dispositivo for girado para uma Portrait orientação, o aplicativo não girará.
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.

Observação

Em dispositivos que não podem ser girados, um aplicativo pode ser mostrado na orientação padrão desse 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á respeitada.

Essas opções de preferência de orientação se aplicam à tela inicial e à 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 da propriedade AutoRotationPreferences .

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.

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 o tópico Globalização .

Aplicativos/Aplicativo/Extensões/Extensão/FileTypeAssociation/Logo Applications/Application/Extensions/Extension/Protocol/Logo

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 é obtido do manifesto do pacote de um exemplo de 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>

Confira também

Requisitos

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