Partilhar via

binding (esquema de bloco)

  • Artigo

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

Hierarquia de elementos

<bloco>
<visual>
<binding>

Syntax

<binding template       = tileTemplateNameV2
         fallback?      = tileTemplateNameV1
         lang?          = string
         baseUri?       = anyURI
         branding?      = "none" | "logo" | "name"
         addImageQuery? = boolean
         contentId?     = string >

  <!-- Child elements -->
  ( image
  | text
  )*

</binding>

Chave

? opcional (zero ou um) * opcional (zero 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 escala, configuração de contraste e 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 que é 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 Logotipo
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 bloco largo.

 string No
fallback

Um modelo a ser usado se o nome do modelo primário não for reconhecido pelo destinatário, para uso com Windows 8 compatibilidade. Esse valor é o nome Windows 8 do valor no atributo de modelo. Novos modelos introduzidos após Windows 8 não têm um fallback.

 tileTemplateNameV1 (consulte Comentários) 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". A localidade especificada aqui substitui isso no visual, mas pode ser substituída por ela no 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
template

Um dos modelos fornecidos no qual basear o bloco. Normalmente, um desenvolvedor deve fornecer um formato quadrado e um formato largo, cada um como um elemento de associação separado. Entradas válidas são membros da enumeração tileTemplateType .

 tileTemplateNameV2 (consulte Comentários) Sim Nenhum

 

Elementos filho

Elemento filho Descrição
imagem

Especifica uma imagem usada no modelo de bloco. A imagem fornecida deve corresponder aos requisitos de tamanho e forma para o modelo ou imagem específico dentro desse modelo.
text

Especifica o texto usado no modelo de bloco.

 

Elementos pai

Elemento pai Descrição
visual

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

 

Comentários

O valor tileTemplateNameV2 usado no atributo de modelo pode ser um dos valores de cadeia de caracteres a seguir. Para obter detalhes sobre cada modelo, consulte O catálogo de modelos de bloco.

  • TileSquare150x150Block
  • TileSquare150x150Image
  • TileSquare150x150PeekImageAndText01
  • TileSquare150x150PeekImageAndText02
  • TileSquare150x150PeekImageAndText03
  • TileSquare150x150PeekImageAndText04
  • TileSquare150x150Text01
  • TileSquare150x150Text02
  • TileSquare150x150Text03
  • TileSquare150x150Text04
  • TileSquare310x310BlockAndText01
  • TileSquare310x310BlockAndText02
  • TileSquare310x310Image
  • TileSquare310x310ImageAndText01
  • TileSquare310x310ImageAndText02
  • TileSquare310x310ImageAndTextOverlay01
  • TileSquare310x310ImageAndTextOverlay02
  • TileSquare310x310ImageAndTextOverlay03
  • TileSquare310x310ImageCollection
  • TileSquare310x310ImageCollectionAndText01
  • TileSquare310x310ImageCollectionAndText02
  • TileSquare310x310SmallImagesAndTextList01
  • TileSquare310x310SmallImagesAndTextList02
  • TileSquare310x310SmallImagesAndTextList03
  • TileSquare310x310SmallImagesAndTextList04
  • TileSquare310x310Text01
  • TileSquare310x310Text02
  • TileSquare310x310Text03
  • TileSquare310x310Text04
  • TileSquare310x310Text05
  • TileSquare310x310Text06
  • TileSquare310x310Text07
  • TileSquare310x310Text08
  • TileSquare310x310TextList01
  • TileSquare310x310TextList02
  • TileSquare310x310TextList03
  • TileWide310x150BlockAndText01
  • TileWide310x150BlockAndText02
  • TileWide310x150Image
  • TileWide310x150ImageAndText01
  • TileWide310x150ImageAndText02
  • TileWide310x150ImageCollection
  • TileWide310x150PeekImage01
  • TileWide310x150PeekImage02
  • TileWide310x150PeekImage03
  • TileWide310x150PeekImage04
  • TileWide310x150PeekImage05
  • TileWide310x150PeekImage06
  • TileWide310x150PeekImageAndText01
  • TileWide310x150PeekImageAndText02
  • TileWide310x150PeekImageCollection01
  • TileWide310x150PeekImageCollection02
  • TileWide310x150PeekImageCollection03
  • TileWide310x150PeekImageCollection04
  • TileWide310x150PeekImageCollection05
  • TileWide310x150PeekImageCollection06
  • TileWide310x150SmallImageAndText01
  • TileWide310x150SmallImageAndText02
  • TileWide310x150SmallImageAndText03
  • TileWide310x150SmallImageAndText04
  • TileWide310x150SmallImageAndText05
  • TileWide310x150Text01
  • TileWide310x150Text02
  • TileWide310x150Text03
  • TileWide310x150Text04
  • TileWide310x150Text05
  • TileWide310x150Text06
  • TileWide310x150Text07
  • TileWide310x150Text08
  • TileWide310x150Text09
  • TileWide310x150Text10
  • TileWide310x150Text11

O valor tileTemplateNameV1 usado no atributo de fallback pode ser um dos valores de cadeia de caracteres a seguir. Esses são os nomes de modelo Windows 8. Para obter detalhes sobre cada modelo, consulte O catálogo de modelos de bloco.

  • TileSquareBlock
  • TileSquareImage
  • TileSquarePeekImageAndText01
  • TileSquarePeekImageAndText02
  • TileSquarePeekImageAndText03
  • TileSquarePeekImageAndText04
  • TileSquareText01
  • TileSquareText02
  • TileSquareText03
  • TileSquareText04
  • TileWideBlockAndText01
  • TileWideBlockAndText02
  • TileWideImage
  • TileWideImageAndText01
  • TileWideImageAndText02
  • TileWideImageCollection
  • TileWidePeekImage01
  • TileWidePeekImage02
  • TileWidePeekImage03
  • TileWidePeekImage04
  • TileWidePeekImage05
  • TileWidePeekImage06
  • TileWidePeekImageAndText01
  • TileWidePeekImageAndText02
  • TileWidePeekImageCollection01
  • TileWidePeekImageCollection02
  • TileWidePeekImageCollection03
  • TileWidePeekImageCollection04
  • TileWidePeekImageCollection05
  • TileWidePeekImageCollection06
  • TileWideSmallImageAndText01
  • TileWideSmallImageAndText02
  • TileWideSmallImageAndText03
  • TileWideSmallImageAndText04
  • TileWideSmallImageAndText05
  • TileWideText01
  • TileWideText02
  • TileWideText03
  • TileWideText04
  • TileWideText05
  • TileWideText06
  • TileWideText07
  • TileWideText08
  • TileWideText09
  • TileWideText10
  • TileWideText11

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 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 (pode não ser definido se o nome for neutro no idioma)
  • Caso contrário, a linguagem de interface do usuário do Shell (linguagem MUI)

Esse idioma será incluído na cadeia de caracteres de consulta se addImageQuery for true.

 

Requisitos

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