visual (esquema de bloco)

  • Artigo

Contém vários elementos filho de associação , cada um dos quais define um bloco.

Hierarquia de elementos

<bloco>
<visual>

Syntax

<visual version?       = integer
        lang?          = string
        baseUri?       = anyURI
        branding?      = "none" | "logo" | "name"
        addImageQuery? = boolean
        contentId?     = string >

  <!-- Child elements -->
  binding+

</visual>

Chave

? opcional (zero ou um) + necessário (um ou mais)

Atributos e elementos

Atributos

Atributo Descrição Tipo de dados Obrigatório Valor padrão
addImageQuery

Defina como true para permitir que o Windows acrescente uma cadeia de caracteres de consulta ao URI da imagem fornecido na notificação de bloco. Use esse atributo se o servidor hospedar imagens e conseguir manipular cadeias de caracteres de consulta, ao recuperar uma variante da imagem com base nas cadeias de caracteres de consulta ou ao ignorar a cadeia de caracteres de consulta e retornar a imagem conforme especificado sem a cadeia de caracteres de consulta. Essa cadeia de caracteres de consulta especifica a escala, a configuração de contraste e o idioma; por exemplo, um valor de

"www.website.com/images/hello.png"

incluído na notificação torna-se

"www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

 booleano No false
baseUri

Um URI base padrão combinado com URIs relativos em atributos de origem de imagem.

 anyURI No ms-appx:///
Marca

O formato que o bloco deve usar para exibir a marca do app.

Esse atributo pode ter um dos seguintes valores:

  • nenhum
  • Logotipo
  • name
 Não Nenhum
Contentid

Defina como uma cadeia de caracteres definida pelo remetente que identifica exclusivamente o conteúdo da notificação. Isso impede duplicatas na situação em que um modelo de bloco grande está exibindo as últimas três notificações de blocos largos.

 string Não Nenhum
Lang

A localidade de destino do conteúdo XML, especificada como uma marca de idioma BCP-47 , como "en-US" ou "fr-FR". Essa localidade é substituída por qualquer localidade especificada em associação ou texto. Se esse valor é uma cadeia de caracteres literal, esse atributo assume como padrão o idioma do usuário da interface do usuário. Se esse valor for uma referência de sequência, este atributo assumirá como padrão a localidade escolhida pelo Windows Runtime na resolução da sequência. Consulte Comentários para quando esse valor não for especificado.

 string Não Nenhum
version

A versão do esquema XML do bloco para a qual essa carga específica foi desenvolvida. Ele pode ter dois valores, 1 ou 2. A versão 1 requer uma carga válida no esquema Windows 8. A versão 2 reconhece os novos modelos de bloco grandes, os novos Windows 8.1 nomes de modelo para modelos existentes e o atributo de fallback do elemento de associação.

 inteiro Não 1

 

Elementos filho

Elemento filho Descrição
binding

Especifica o modelo de bloco. Cada notificação deve incluir um elemento de associação para cada tamanho de bloco com suporte.

 

Elementos pai

Elemento pai Descrição
tile

Elemento de bloco base, que contém um único elemento visual .

 

Comentários

A tabela a seguir explica como o sistema responde quando lang não é especificado.

Para... A resposta do sistema
O idioma da notificação
  • Se definido explicitamente, use visual.lang ou binding.lang
  • Caso contrário, a configuração de linguagem específica do aplicativo (o idioma, se houver, que o [Resource Management System](/previous-versions/windows/apps/jj552947(v=win.10)) determina que o aplicativo será executado em dado o perfil de idioma atual)
  • Caso contrário, o idioma do nome de exibição no bloco, conforme resolvido por Windows Runtime
  • Caso contrário, a linguagem de interface do usuário do Shell (linguagem MUI)

Essa linguagem influencia principalmente o layout de colunas em modelos que apresentam colunas.
Elementos de texto com texto literal
  • Se definido explicitamente, use visual.lang ou binding.lang
  • Caso contrário, a configuração de linguagem específica do aplicativo (o idioma, se houver, que o [Resource Management System](/previous-versions/windows/apps/jj552947(v=win.10)) determina que o aplicativo será executado em dado o perfil de idioma atual)
  • Caso contrário, o idioma do nome de exibição no bloco, conforme resolvido por Windows Runtime
  • Caso contrário, a linguagem de interface do usuário do shell (linguagem MUI)
Elementos de texto com conteúdo ms-resource
  • Se definido explicitamente, use visual.lang ou binding.lang e a linguagem explícita será acrescentada à lista de idiomas do [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) usado para resolve cadeia de caracteres
  • Caso contrário, o [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) usado como inicializado com o perfil de idioma do usuário

Depois que a cadeia de caracteres é resolvida, o idioma da cadeia de caracteres resolvida é atribuído ao elemento de texto. Essa linguagem forma o alinhamento de texto (LTR vs. RTL) e a seleção de fonte para interface do usuário.
ms-appx:/// image
  • Se definido explicitamente, use visual.lang ou binding.lang, a linguagem explícita será acrescentada à lista de idiomas do [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) usado para resolve cadeia de caracteres
  • Caso contrário, o [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) é usado como inicializado com o perfil de idioma do usuário
Imagens de nuvem
  • Se definido explicitamente, use visual.lang ou binding.lang
  • Caso contrário, a configuração de idioma específica do aplicativo (o idioma, se houver, que o [Sistema de Gerenciamento de Recursos](/previous-versions/windows/apps/jj552947(v=win.10)) determina que o aplicativo será executado em dado o perfil de idioma atual)
  • Caso contrário, o idioma do nome de exibição no bloco, conforme resolvido por Windows Runtime (pode não ser definido se o nome for neutro em idioma)
  • Caso contrário, a linguagem de interface do usuário do Shell (linguagem MUI)

Essa linguagem será incluída na cadeia de caracteres de consulta se addImageQuery for true.

 

Requisitos

Valor
Namespace http://schemas.microsoft.com/notifications/2012/tile.xsd