Esquema de conteúdo do bloco

  • Artigo
  • 15 minutos para o fim da leitura

A seguir, são descritas todas as propriedades e elementos do conteúdo do bloco.

Se você preferir usar XML bruto em vez da Biblioteca de notificações, consulte o esquema XML.

TileContent

TileContent

TileContent é o objeto de nível superior que descreve o conteúdo da notificação de bloco, incluindo os elementos visuais.

Propriedade Tipo Obrigatório Descrição
Visual ToastVisual true Descreve a parte visual da notificação de bloco.

TileVisual

A parte visual dos blocos contém as especificações visuais de todos os tamanhos de bloco e mais propriedades relacionadas aos elementos visuais.

Propriedade Tipo Obrigatório Descrição
TileSmall TileBinding false Forneça uma associação pequena opcional para especificar o conteúdo do tamanho de bloco pequeno.
TileMedium TileBinding false Forneça uma associação média opcional para especificar o conteúdo do tamanho de bloco médio.
TileWide TileBinding false Forneça uma associação larga opcional para especificar o conteúdo do tamanho de bloco largo.
TileLarge TileBinding false Forneça uma associação grande opcional para especificar o conteúdo do tamanho de bloco grande.
Identidade visual TileBranding false O formato que o bloco deve usar para exibir a marca do app. Por padrão, herda a identidade visual do bloco padrão.
DisplayName string false Uma cadeia de caracteres opcional que substitui o nome de exibição do bloco durante a exibição dessa notificação.
Argumentos string false Novidades na Atualização de Aniversário: dados definidos pelo app que são retornados ao app por meio da propriedade TileActivatedInfo em LaunchActivatedEventArgs quando o usuário inicia o app no Bloco Dinâmico. Informa a você quais notificações de bloco o usuário viu quando tocou no Bloco Dinâmico. Nos dispositivos sem a Atualização de Aniversário, isso simplesmente será ignorado.
LockDetailedStatus1 string false Se você especificar isso, também deverá fornecer uma associação TileWide. Esse será a primeira linha de texto a ser exibida na tela de bloqueio se o usuário tiver selecionado o bloco como app de status detalhado.
LockDetailedStatus2 string false Se você especificar isso, também deverá fornecer uma associação TileWide. Esse será a segunda linha de texto a ser exibida na tela de bloqueio se o usuário tiver selecionado o bloco como app de status detalhado.
LockDetailedStatus3 string false Se você especificar isso, também deverá fornecer uma associação TileWide. Esse será a terceira linha de texto a ser exibida na tela de bloqueio se o usuário tiver selecionado o bloco como app de status detalhado.
BaseUri Uri false Uma URL base padrão que é combinada às URLs relativas nos atributos de origem da imagem.
AddImageQuery bool? false Defina como "true" para permitir que o Windows acrescente uma cadeia de caracteres de consulta à URL de imagem fornecida na notificação do sistema. 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" fornecido na notificação torna-se "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"
Idioma string false A localidade de destino da carga visual ao usar recursos localizados, especificados como marcações de idioma BCP-47 como "en-US" ou "pt-BR". Esse local é substituído por qualquer localidade especificada na associação ou no texto. Se não for fornecido, a localidade do sistema será usada em vez disso.

TileBinding

O objeto de associação possui o conteúdo visual para um tamanho de bloco específico.

Propriedade Tipo Obrigatório Descrição
Conteúdo ITileBindingContent false O conteúdo visual a ser exibido no bloco. Uma das TileBindingContentAdaptive, TileBindingContentIconic, TileBindingContentContact, TileBindingContentPeople ou TileBindingContentPhotos.
Identidade visual TileBranding false O formato que o bloco deve usar para exibir a marca do app. Por padrão, herda a identidade visual do bloco padrão.
DisplayName string false Uma cadeia de caracteres opcional que substitui o nome de exibição do bloco neste tamanho de bloco.
Argumentos string false Novidades na Atualização de Aniversário: dados definidos pelo app que são retornados ao app por meio da propriedade TileActivatedInfo em LaunchActivatedEventArgs quando o usuário inicia o app no Bloco Dinâmico. Informa a você quais notificações de bloco o usuário viu quando tocou no Bloco Dinâmico. Nos dispositivos sem a Atualização de Aniversário, isso simplesmente será ignorado.
BaseUri Uri false Uma URL base padrão que é combinada às URLs relativas nos atributos de origem da imagem.
AddImageQuery bool? false Defina como "true" para permitir que o Windows acrescente uma cadeia de caracteres de consulta à URL de imagem fornecida na notificação do sistema. 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" fornecido na notificação torna-se "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"
Idioma string false A localidade de destino da carga visual ao usar recursos localizados, especificados como marcações de idioma BCP-47 como "en-US" ou "pt-BR". Esse local é substituído por qualquer localidade especificada na associação ou no texto. Se não for fornecido, a localidade do sistema será usada em vez disso.

ITileBindingContent

Interface de marcador para conteúdo de associação do bloco. Permite que você escolha o que deseja especificar nos elementos visuais do bloco - Adaptável ou um dos modelos especiais.

Implementações
TileBindingContentAdaptive
TileBindingContentIconic
TileBindingContentContact
TileBindingContentPeople
TileBindingContentPhotos

TileBindingContentAdaptive

Compatível com todos os tamanhos. Esta é a maneira recomendada de especificar o conteúdo do bloco. Modelos de bloco adaptáveis novos no Windows 10; você pode criar uma ampla variedade de blocos personalizados por meio de modelos adaptáveis.

Propriedade Tipo Obrigatório Descrição
Filhos IList<ITileBindingContentAdaptiveChild> false Os elementos visuais embutidos. Os objetos AdaptiveText, AdaptiveImage e AdaptiveGroup podem ser adicionados. Os filhos são exibidos em um StackPanel vertical.
Backgroundimage TileBackgroundImage false Uma imagem de plano de fundo opcional exibida atrás do conteúdo do bloco, sangramento total.
PeekImage TilePeekImage false Uma imagem opcional animada que surge da parte superior do bloco.
TextStacking TileTextStacking false Controla o empilhamento de texto (alinhamento vertical) do conteúdo filho como um todo.

AdaptiveText

Um elemento de texto adaptável.

Propriedade Tipo Obrigatório Descrição
Texto string false O texto a ser exibido.
HintStyle AdaptiveTextStyle false O estilo controla o tamanho, a espessura e a opacidade da fonte do texto.
HintWrap bool? false Defina como true para habilitar a quebra automática de texto. Assume false como valor padrão.
HintMaxLines int? false O número máximo de linhas que o elemento de texto tem permissão de exibir.
HintMinLines int? false O número mínimo de linhas que o elemento de texto deve exibir.
HintAlign AdaptiveTextAlign false O alinhamento horizontal do texto.
Idioma string false A localidade de destino da carga XML, especificada como marcações de idioma BCP-47 como "en-US" ou "pt-BR". A localidade especificada aqui substitui qualquer outra localidade especificada, como na vinculação ou no visual. 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.

AdaptiveTextStyle

O estilo de texto controla o tamanho, a espessura e opacidade da fonte. A opacidade sutil é 60% opaca.

Valor Significado
Padrão Valor padrão. O estilo é determinado pelo renderizador.
Legenda Tamanho menor do que a fonte de parágrafo.
CaptionSubtle Mesmo que Caption, mas com opacidade sutil.
Corpo Tamanho da fonte de parágrafo.
BodySubtle Mesmo que Body, mas com opacidade sutil.
Base Tamanho da fonte de parágrafo, a espessura é negrito. Essencialmente a versão em negrito do corpo.
BaseSubtle Mesmo que Base, mas com opacidade sutil.
Subtítulo Tamanho da fonte H4.
SubtitleSubtle Mesmo que Subtitle, mas com opacidade sutil.
Título Tamanho da fonte H3.
TitleSubtle Mesmo que Title, mas com opacidade sutil.
TitleNumeral Igual a Title, mas com preenchimento superior ou inferior removido.
Subheader Tamanho da fonte H2.
SubheaderSubtle Mesmo que Subheader, mas com opacidade sutil.
SubheaderNumeral Igual a Subheader, mas com preenchimento superior ou inferior removido.
Cabeçalho Tamanho da fonte H1.
HeaderSubtle Mesmo que Header, mas com opacidade sutil.
HeaderNumeral Igual a Header, mas com preenchimento superior ou inferior removido.

AdaptiveTextAlign

Controla o alinhamento horizontal de texto.

Valor Significado
Padrão Valor padrão. O alinhamento é determinado automaticamente pelo renderizador.
Auto O alinhamento é determinado por idioma e cultura atual.
Left Alinha o texto horizontalmente à esquerda.
Centro Alinha o texto horizontalmente no centro.
Right Alinha o texto horizontalmente à direita.

AdaptiveImage

Uma imagem embutida.

Propriedade Tipo Obrigatório Descrição
Origem string true A URL da imagem. Suporte para ms-appx, ms-appdata e http. Na the Fall Creators Update, as imagens da Web podem ter até 3 MB em conexões normais e 1 MB em conexões limitadas. Em dispositivos que ainda não executam a Fall Creators Update, as imagens da Web devem ser maiores do que 200 KB.
HintCrop AdaptiveImageCrop false Controla o recorte desejado da imagem.
HintRemoveMargin bool? false Por padrão, as imagens em grupos/subgrupos têm uma margem de 8 px em volta. Você pode remover essa margem ao definir essa propriedade como true.
HintAlign AdaptiveImageAlign false O alinhamento horizontal da imagem.
AlternateText string false Texto alternativo que descreve a imagem, usado para fins de acessibilidade.
AddImageQuery bool? false Defina como "true" para permitir que o Windows acrescente uma cadeia de caracteres de consulta à URL de imagem fornecida na notificação do 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" fornecido na notificação torna-se "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

AdaptiveImageCrop

Especifica o recorte desejado da imagem.

Valor Significado
Padrão Valor padrão. Comportamento de corte determinado pelo renderizador.
Nenhuma A imagem não é cortada.
Circle A imagem é cortada na forma de círculo.

AdaptiveImageAlign

Especifica o alinhamento horizontal de uma imagem.

Valor Significado
Padrão Valor padrão. Comportamento de alinhamento determinado pelo renderizador.
Esticar A imagem é esticada para preencher a largura disponível (e a altura possivelmente disponível também, dependendo de onde a imagem é colocada).
Left Alinhe a imagem à esquerda, exibindo a imagem na resolução nativa.
Centro Alinhe a imagem horizontalmente no centro, exibindo a imagem na resolução nativa.
Right Alinhe a imagem à direita, exibindo a imagem na resolução nativa.

AdaptiveGroup

Os grupos identificam semanticamente que o conteúdo do grupo deve ser exibido como um todo ou não exibido se não couber. Os Grupos também permitem a criação de várias colunas.

Propriedade Tipo Obrigatório Descrição
Filhos IList<AdaptiveSubgroup> false Subgrupos são exibidos como colunas verticais. Você deve usar subgrupos para fornecer qualquer conteúdo em um AdaptiveGroup.

AdaptiveSubgroup

Os subgrupos são colunas verticais que podem conter texto e imagens.

Propriedade Tipo Obrigatório Descrição
Filhos IList<IAdaptiveSubgroupChild> false AdaptiveText e AdaptiveImage são filhos válidos de subgrupos.
HintWeight int? false Controle a largura da coluna do subgrupo ao especificar a espessura em relação aos outros subgrupos.
HintTextStacking AdaptiveSubgroupTextStacking false Controle o alinhamento vertical do conteúdo deste subgrupo.

IAdaptiveSubgroupChild

Interface de marcador para filhos de subgrupo.

Implementações
AdaptiveText
AdaptiveImage

AdaptiveSubgroupTextStacking

TextStacking especifica o alinhamento vertical do conteúdo.

Valor Significado
Padrão Valor padrão. O renderizador selecionará automaticamente o alinhamento vertical padrão.
Top Alinhamento vertical com a parte superior.
Centro Alinhamento vertical com o centro.
Menor Alinhamento vertical com a parte inferior.

TileBackgroundImage

Uma imagem de plano de fundo exibida com sangramento total no bloco.

Propriedade Tipo Obrigatório Descrição
Origem string true A URL da imagem. ms-appx, ms-appdata e http(s) são compatíveis. As imagens HTTP devem ter 200 KB ou menos.
HintOverlay int? false Uma sobreposição preta em uma imagem de plano de fundo. Este valor controla a opacidade da sobreposição preta, sendo 0 equivalente a nenhuma sobreposição e 100 equivalente a completamente preto. Assume 20 como valor padrão.
HintCrop TileBackgroundImageCrop false Novo na versão 1511: especifica como a imagem deve ser cortada. Nas versões anteriores a 1511, isso será ignorado e a imagem de plano de fundo será exibida sem cortes.
AlternateText string false Texto alternativo que descreve a imagem, usado para fins de acessibilidade.
AddImageQuery bool? false Defina como "true" para permitir que o Windows acrescente uma cadeia de caracteres de consulta à URL de imagem fornecida na notificação do 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" fornecido na notificação se torna "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

TileBackgroundImageCrop

Controla o recorte da imagem de plano de fundo.

Valor Significado
Padrão O corte usa o comportamento padrão do renderizador.
Nenhuma A imagem não é cortada, exibida em um quadrado.
Circle A imagem é cortada em círculo.

TilePeekImage

Uma imagem animada que surge da parte superior do bloco.

Propriedade Tipo Obrigatório Descrição
Origem string true A URL da imagem. ms-appx, ms-appdata e http(s) são compatíveis. As imagens HTTP devem ter 200 KB ou menos.
HintOverlay int? false Novo na versão 1511: uma sobreposição preta na imagem que surge. Este valor controla a opacidade da sobreposição preta, sendo 0 equivalente a nenhuma sobreposição e 100 equivalente a completamente preto. Assume 20 como valor padrão. Nas versões anteriores, este valor será ignorado e a imagem que surge será exibida com sobreposição 0.
HintCrop TilePeekImageCrop false Novo na versão 1511: especifica como a imagem deve ser cortada. Nas versões anteriores a 1511, isso será ignorado e a imagem que surge será exibida sem cortes.
AlternateText string false Texto alternativo que descreve a imagem, usado para fins de acessibilidade.
AddImageQuery bool? false Defina como "true" para permitir que o Windows acrescente uma cadeia de caracteres de consulta à URL de imagem fornecida na notificação do 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" fornecido na notificação se torna "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

TilePeekImageCrop

Controla o recorte da imagem que surge.

Valor Significado
Padrão O corte usa o comportamento padrão do renderizador.
Nenhuma A imagem não é cortada, exibida em um quadrado.
Circle A imagem é cortada em círculo.

TileTextStacking

O empilhamento de texto especifica o alinhamento vertical do conteúdo.

Valor Significado
Padrão Valor padrão. O renderizador selecionará automaticamente o alinhamento vertical padrão.
Top Alinhamento vertical com a parte superior.
Centro Alinhamento vertical com o centro.
Menor Alinhamento vertical com a parte inferior.

TileBindingContentIconic

Compatível com blocos pequenos e médios. Habilita um modelo de bloco icônico, em que você pode ter um ícone e um selo exibidos um ao lado do outro no bloco, no estilo clássico verdadeiro do Windows Phone. O número ao lado do ícone é obtido por meio de uma notificação de selo separada.

Propriedade Tipo Obrigatório Descrição
Ícone TileBasicImage true No mínimo, para dar suporte a blocos pequenos e médios na Área de Trabalho e no Celular forneça uma imagem de taxa de proporção quadrada com uma resolução de 200 x 200, formato PNG, com transparência e nenhuma outra cor além do branco. Para obter mais informações, consulte Modelos de bloco especiais.

TileBindingContentContact

Somente celular. Compatível com blocos pequenos, médios e largos.

Propriedade Tipo Obrigatório Descrição
Imagem TileBasicImage true A imagem a ser exibida.
Texto TileBasicText false Uma linha de texto exibida. Não é exibida em blocos pequenos.

TileBindingContentPeople

Novo na versão 1511: compatível com blocos médios, largos e grandes (Área de Trabalho e Celular). Antigamente, isso aplicava-se somente a celulares e a blocos médios e largos.

Propriedade Tipo Obrigatório Descrição
Imagens IList<TileBasicImage> true Imagens que percorrerão o entorno como círculos.

TileBindingContentPhotos

Oferece animação por meio de uma apresentação de slides de fotos. Compatível com todos os tamanhos.

Propriedade Tipo Obrigatório Descrição
Imagens IList<TileBasicImage> true Até 12 imagens podem ser fornecidas (o celular exibirá até nove imagens), que serão usadas na apresentação de slides. A adição de mais de 12 imagens gerará uma exceção.

TileBasicImage

Uma imagem usada em diversos modelos especiais.

Propriedade Tipo Obrigatório Descrição
Origem string true A URL da imagem. ms-appx, ms-appdata e http(s) são compatíveis. As imagens HTTP devem ter 200 KB ou menos.
AlternateText string false Texto alternativo que descreve a imagem, usado para fins de acessibilidade.
AddImageQuery bool? false Defina como "true" para permitir que o Windows acrescente uma cadeia de caracteres de consulta à URL de imagem fornecida na notificação do 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" fornecido na notificação torna-se "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

TileBasicText

Um elemento de texto básico usado em diversos modelos especiais.

Propriedade Tipo Obrigatório Descrição
Texto string false O texto a ser exibido.
Idioma string false A localidade de destino da carga XML, especificada como marcações de idioma BCP-47 como "en-US" ou "pt-BR". A localidade especificada aqui substitui qualquer outra localidade especificada, como na vinculação ou no visual. 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.