Compartilhar via


Esquema de conteúdo do bloco

Observação

Os Blocos Dinâmicos são um recurso do Windows 10 que não é compatível com versões posteriores do Windows. Para novos aplicativos, recomendamos que você siga as diretrizes atuais para ícones de aplicativos.

Veja a seguir a descrição de todas as propriedades e elementos dentro do conteúdo do bloco.

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

TileContent

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

Propriedade Type Obrigatória Descrição
Visual ToastVisual true Ele descreve a parte visual da notificação do bloco.

TileVisual

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

Propriedade Type Obrigatória Descrição
TileSmall TileBinding false Fornece uma associação pequena opcional para especificar o conteúdo do tamanho de bloco pequeno.
TileMedium TileBinding false Fornece uma associação média opcional para especificar o conteúdo do tamanho de bloco médio.
TileWide TileBinding false Fornece uma associação larga opcional para especificar o conteúdo do tamanho de bloco largo.
TileLarge TileBinding false Fornece uma associação grande opcional para especificar o conteúdo do tamanho de bloco grande.
Identidade visual TileBranding false O formulário que o bloco deve usar para exibir a marca do aplicativo. Por padrão, herda a identidade visual do bloco padrão.
DisplayName string false Uma sequência opcional para substituir o nome de exibição do bloco ao mostrar essa notificação.
Argumentos string false Novo na Atualização de Aniversário: dados definidos pelo aplicativo que são passados de volta para o aplicativo por meio da propriedade TileActivatedInfo em LaunchActivatedEventArgs quando o usuário inicia o aplicativo a usando o Bloco Dinâmico. Isso permite que você saiba quais notificações de bloco o usuário viu quando tocou no Bloco Dinâmico. Em dispositivos sem a Atualização de Aniversário, isso será simplesmente ignorado.
LockDetailedStatus1 string false Se você especificar isso, também deverá fornecer uma associação TileWide. Essa é a primeira linha de texto que será exibida na tela de bloqueio se o usuário tiver selecionado o bloco como o aplicativo de status detalhado.
LockDetailedStatus2 string false Se você especificar isso, também deverá fornecer uma associação TileWide. Essa é a segunda linha de texto que será exibida na tela de bloqueio se o usuário tiver selecionado o bloco como o aplicativo de status detalhado.
LockDetailedStatus3 string false Se você especificar isso, também deverá fornecer uma associação TileWide. Essa é a terceira linha de texto que será exibida na tela de bloqueio se o usuário tiver selecionado o bloco como o aplicativo de status detalhado.
BaseUri Uri false Uma URL base padrão que é combinada com URLs relativas em atributos de origem de imagem.
AddImageQuery bool? false Defina como "true" para permitir que o Windows acrescente uma sequência de consulta à URL da imagem fornecida na notificação do sistema. Use esse atributo se o servidor hospedar imagens e puder manipular sequências de consulta, recuperando uma variante de imagem com base nas sequências de consulta ou ignorando a sequência de consulta e retornando a imagem conforme especificado sem a sequência de consulta. Essa sequência de consulta especifica escala, configuração de contraste e idioma; Por exemplo, um valor de "www.website.com/images/hello.png" dado 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 payload visual ao usar recursos localizados, especificados como tags de idioma BCP-47, como "en-US" ou "fr-FR". Essa localidade é substituída por qualquer localidade especificada em vinculação ou texto. Se isso não for fornecido, a localidade do sistema será usada no lugar dele.

TileBinding

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

Propriedade Type Obrigatória Descrição
Sumário ITileBindingContent false O conteúdo visual a ser exibido no bloco. Um deles> TileBindingContentAdaptive, TileBindingContentIconic, TileBindingContentContact, TileBindingContentPeople ou TileBindingContentPhotos.
Identidade visual TileBranding false O formulário que o bloco deve usar para exibir a marca do aplicativo. Por padrão, herda a identidade visual do bloco padrão.
DisplayName string false Uma sequência opcional para substituir o nome de exibição do bloco para esse tamanho de bloco.
Argumentos string false Novo na Atualização de Aniversário: dados definidos pelo aplicativo que são passados de volta para o aplicativo por meio da propriedade TileActivatedInfo em LaunchActivatedEventArgs quando o usuário inicia o aplicativo a usando o Bloco Dinâmico. Isso permite que você saiba quais notificações de bloco o usuário viu quando tocou no Bloco Dinâmico. Em dispositivos sem a Atualização de Aniversário, isso será simplesmente ignorado.
BaseUri Uri false Uma URL base padrão que é combinada com URLs relativas em atributos de origem de imagem.
AddImageQuery bool? false Defina como "true" para permitir que o Windows acrescente uma sequência de consulta à URL da imagem fornecida na notificação do sistema. Use esse atributo se o servidor hospedar imagens e puder manipular sequências de consulta, recuperando uma variante de imagem com base nas sequências de consulta ou ignorando a sequência de consulta e retornando a imagem conforme especificado sem a sequência de consulta. Essa sequência de consulta especifica escala, configuração de contraste e idioma; Por exemplo, um valor de "www.website.com/images/hello.png" dado 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 payload visual ao usar recursos localizados, especificados como tags de idioma BCP-47, como "en-US" ou "fr-FR". Essa localidade é substituída por qualquer localidade especificada em vinculação ou texto. Se isso não for fornecido, a localidade do sistema será usada no lugar dele.

ITileBindingContent

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

Implementações
TileBindingContentAdaptive
TileBindingContentIconic
TileBindingContentContact
TileBindingContentPeople
TileBindingContentPhotos

TileBindingContentAdaptive

Compatível com todos os tamanhos. Essa é a maneira recomendada de especificar o conteúdo do bloco. Modelos de Mosaico Adaptáveis novos no Windows 10 e é possível criar uma grande variedade de mosaicos personalizados por meio do adaptativo.

Propriedade Type Obrigatória Descrição
Filhos IList<ITileBindingContentAdaptiveChild> false Os elementos visuais embutidos. É possível adicionar os objetos AdaptiveText, AdaptiveImage e AdaptiveGroup. Os filhos são exibidos na forma de StackPanel vertical.
BackgroundImage TileBackgroundImage false Uma imagem de tela de fundo opcional que é exibida atrás de todo o conteúdo do bloco, com sangramento total.
PeekImage TilePeekImage false Uma imagem de visualização opcional que anima a partir 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 Type Obrigatória 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 isso como true para habilitar a quebra de texto. O padrão é falso.
HintMaxLines int? false O número máximo de linhas que o elemento de texto tem permissão para 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 payload XML ao usar recursos localizados, especificados como tags de idioma BCP-47, como "en-US" ou "fr-FR". A localidade especificada aqui substitui qualquer outra localidade especificada, como a de associação ou visual. Se esse valor for uma sequência literal, esse atributo assumirá como padrão a linguagem da interface do usuário. Se esse valor for uma referência de sequência, esse 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 a opacidade da fonte. A opacidade sutil é 60% opaca.

Valor Significado
Default Valor padrão. O estilo é determinado pelo renderizador.
Legenda Menor que o tamanho da fonte do parágrafo.
CaptionSubtle O mesmo que Legenda, mas com opacidade sutil.
Corpo Tamanho da fonte do parágrafo.
BodySubtle O mesmo que Corpo, mas com opacidade sutil.
Base Tamanho da fonte do parágrafo, peso em negrito. Essencialmente a versão em negrito do Corpo.
BaseSubtle O mesmo que Base, mas com opacidade sutil.
Subtítulo Tamanho da fonte H4.
SubtitleSubtle O mesmo que Legenda, mas com opacidade sutil.
Título Tamanho da fonte H3.
TitleSubtle O mesmo que Título, mas com opacidade sutil.
TitleNumeral O mesmo que Título, mas com preenchimento superior/inferior removido.
Subheader Tamanho da fonte H2.
SubheaderSubtle O mesmo que Subheader, mas com opacidade sutil.
SubheaderNumeral O mesmo que Subheader, mas com preenchimento superior/inferior removido.
Cabeçalho Tamanho da fonte H1.
HeaderSubtle O mesmo que Header, mas com opacidade sutil.
HeaderNumeral O mesmo que Header, mas com preenchimento superior/inferior removido.

AdaptiveTextAlign

Controla o alinhamento horizontal do texto.

Valor Significado
Default Valor padrão. O alinhamento é determinado automaticamente pelo renderizador.
Auto Alinhamento determinado pela linguagem e cultura atuais.
Left Alinha horizontalmente o texto à esquerda.
Center Alinha horizontalmente o texto ao centro.
Right Alinha horizontalmente o texto à direita.

AdaptiveImage

Uma imagem embutida.

Propriedade Type Obrigatória Descrição
Origem string true A URL para a imagem. ms-appx, ms-appdata e http são compatíveis. A partir do 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 o Fall Creators Update, as imagens da Web devem ter no máximo 200 KB.
HintCrop AdaptiveImageCrop false Controla o recorte desejado da imagem.
HintRemoveMargin bool? false Por padrão, as imagens dentro de grupos/subgrupos têm uma margem de 8px ao seu redor. É possível remover essa margem definindo essa propriedade como true.
HintAlign AdaptiveImageAlign false O alinhamento horizontal da imagem.
AlternateText string false Texto alternativo descrevendo a imagem, usado para fins de acessibilidade.
AddImageQuery bool? false Defina como "true" para permitir que o Windows anexe uma sequência de consulta à URL da imagem fornecida na notificação de bloco. Use esse atributo se o servidor hospedar imagens e puder manipular sequências de consulta, recuperando uma variante de imagem com base nas sequências de consulta ou ignorando a sequência de consulta e retornando a imagem conforme especificado sem a sequência de consulta. Essa sequência de consulta especifica escala, configuração de contraste e idioma; Por exemplo, um valor de "www.website.com/images/hello.png" dado 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
Default Valor padrão. Comportamento de corte determinado pelo renderizador.
Nenhuma A imagem não está cortada.
Circle A imagem está cortada em forma de círculo.

AdaptiveImageAlign

Especifica o alinhamento horizontal da imagem.

Valor Significado
Default Valor padrão. Comportamento de alinhamento determinado pelo renderizador.
Stretch A imagem se estende para preencher a largura disponível (e a altura potencialmente disponível também, dependendo de onde ela é colocada).
Left Alinha a imagem à esquerda, exibindo-a em sua resolução nativa.
Center Alinhe a imagem no centro horizontalmente, exibindo a imagem em sua resolução nativa.
Right Alinha a imagem à direita, exibindo-a em sua resolução nativa.

AdaptiveGroup

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

Propriedade Type Obrigatória Descrição
Filhos IList<AdaptiveSubgroup> false Os subgrupos são exibidos como colunas verticais. Você deve usar subgrupos para fornecer qualquer conteúdo dentro de um AdaptiveGroup.

AdaptiveSubgroup

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

Propriedade Type Obrigatória Descrição
Filhos IList<IAdaptiveSubgroupChild> false AdaptiveText e AdaptiveImage são filhos válidos de subgrupos.
HintWeight int? false Controle a largura dessa coluna de subgrupo especificando o peso, 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 texto.

Valor Significado
Default Valor padrão. O renderizador seleciona automaticamente o alinhamento vertical padrão.
Top Alinhamento vertical à parte superior.
Center Alinhamento vertical ao centro.
Menor Alinhamento vertical à parte inferior.

TileBackgroundImage

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

Propriedade Type Obrigatória Descrição
Origem string true A URL para a imagem. ms-appx, ms-appdata e http(s) são compatíveis. As imagens http devem ter tamanho de 200 KB ou inferior.
HintOverlay int? false Uma sobreposição preta na imagem da tela de fundo. Esse valor controla a opacidade da sobreposição preta, com 0 sendo nenhuma sobreposição e 100 sendo completamente preto. Padronizado como 20.
HintCrop TileBackgroundImageCrop false Novo na 1511: especifica como você deseja que a imagem seja cortada. Em versões anteriores à 1511, isso será ignorado e a imagem da tela de fundo será exibida sem qualquer corte.
AlternateText string false Texto alternativo descrevendo a imagem, usado para fins de acessibilidade.
AddImageQuery bool? false Defina como "true" para permitir que o Windows anexe uma sequência de consulta à URL da imagem fornecida na notificação de bloco. Use esse atributo se o servidor hospedar imagens e puder manipular sequências de consulta, recuperando uma variante de imagem com base nas sequências de consulta ou ignorando a sequência de consulta e retornando a imagem conforme especificado sem a sequência de consulta. Essa sequência de consulta especifica escala, configuração de contraste e idioma; Por exemplo, um valor de "www.website.com/images/hello.png" dado na notificação torna-se "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

TileBackgroundImageCrop

Controla o recorte da imagem da tela de fundo.

Valor Significado
Default O recorte usa o comportamento padrão do renderizador.
Nenhuma A imagem não é cortada, ela é exibida quadrada.
Circle A imagem é cortada em forma de círculo.

TilePeekImage

Uma imagem rápida que se anima a partir do topo do mosaico.

Propriedade Type Obrigatória Descrição
Origem string true A URL para a imagem. ms-appx, ms-appdata e http(s) são compatíveis. As imagens http devem ter tamanho de 200 KB ou inferior.
HintOverlay int? false Novo na 1511: uma sobreposição preta na imagem rápida. Esse valor controla a opacidade da sobreposição preta, com 0 sendo nenhuma sobreposição e 100 sendo completamente preto. Padronizado como 20. Nas versões anteriores, esse valor será ignorado e a imagem de visualização será exibida com sobreposição 0.
HintCrop TilePeekImageCrop false Novo na 1511: especifica como você deseja que a imagem seja cortada. Em versões anteriores à 1511, isso será ignorado e a imagem rápida será exibida sem qualquer corte.
AlternateText string false Texto alternativo descrevendo a imagem, usado para fins de acessibilidade.
AddImageQuery bool? false Defina como "true" para permitir que o Windows anexe uma sequência de consulta à URL da imagem fornecida na notificação de bloco. Use esse atributo se o servidor hospedar imagens e puder manipular sequências de consulta, recuperando uma variante de imagem com base nas sequências de consulta ou ignorando a sequência de consulta e retornando a imagem conforme especificado sem a sequência de consulta. Essa sequência de consulta especifica escala, configuração de contraste e idioma; Por exemplo, um valor de "www.website.com/images/hello.png" dado na notificação torna-se "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

TilePeekImageCrop

Controla o recorte da imagem rápida.

Valor Significado
Default O recorte usa o comportamento padrão do renderizador.
Nenhuma A imagem não é cortada, ela é exibida quadrada.
Circle A imagem é cortada em forma de círculo.

TileTextStacking

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

Valor Significado
Default Valor padrão. O renderizador seleciona automaticamente o alinhamento vertical padrão.
Top Alinhamento vertical à parte superior.
Center Alinhamento vertical ao centro.
Menor Alinhamento vertical à parte inferior.

TileBindingContentIconic

Compatível em Pequenas e Médias. Habilita um modelo de bloco icônico, onde é possível exibir um ícone e um selo um ao lado do outro no bloco, no verdadeiro estilo clássico do telefone Windows. O número ao lado do ícone é obtido por meio de uma notificação de selo separada.

Propriedade Type Obrigatória Descrição
Ícone TileBasicImage true No mínimo, para oferecer suporte a blocos de Área de Trabalho e Móveis, pequenos e médios, forneça uma imagem de proporção quadrada com resolução de 200x200, formato PNG, com transparência e nenhuma cor além do branco. Para obter mais informações, confira Modelo de bloco especiais.

TileBindingContentContact

Somente para dispositivos móveis. Compatível em Pequenas, Médias e Largas.

Propriedade Type Obrigatória Descrição
Imagem TileBasicImage true A imagem a ser exibida.
Text TileBasicText false Uma linha de texto que é exibida. Não é exibida no bloco pequeno.

TileBindingContentPeople

Novo no 1511: compatível em Pequenas, Médias e Largas (desktop e móvel). Anteriormente, isso era apenas para dispositivos móveis e apenas para blocos médios e largos.

Propriedade Type Obrigatória Descrição
Imagens IList<TileBasicImage> true Imagens que rolarão como círculos.

TileBindingContentPhotos

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

Propriedade Type Obrigatória Descrição
Imagens IList<TileBasicImage> true Até 12 imagens podem ser fornecidas (o celular exibirá apenas até 9), que serão usadas para a apresentação de slides. Adicionar mais de 12 lançará uma exceção.

TileBasicImage

Uma imagem usada em vários modelos especiais.

Propriedade Type Obrigatória Descrição
Origem string true A URL para a imagem. ms-appx, ms-appdata e http(s) são compatíveis. As imagens http devem ter tamanho de 200 KB ou inferior.
AlternateText string false Texto alternativo descrevendo a imagem, usado para fins de acessibilidade.
AddImageQuery bool? false Defina como "true" para permitir que o Windows anexe uma sequência de consulta à URL da imagem fornecida na notificação de bloco. Use esse atributo se o servidor hospedar imagens e puder manipular sequências de consulta, recuperando uma variante de imagem com base nas sequências de consulta ou ignorando a sequência de consulta e retornando a imagem conforme especificado sem a sequência de consulta. Essa sequência de consulta especifica escala, configuração de contraste e idioma; Por exemplo, um valor de "www.website.com/images/hello.png" dado 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 vários modelos especiais.

Propriedade Type Obrigatória Descrição
Texto string false O texto a ser exibido.
Idioma string false A localidade de destino da payload XML ao usar recursos localizados, especificados como tags de idioma BCP-47, como "en-US" ou "fr-FR". A localidade especificada aqui substitui qualquer outra localidade especificada, como a de associação ou visual. Se esse valor for uma sequência literal, esse atributo assumirá como padrão a linguagem da interface do usuário. Se esse valor for uma referência de sequência, esse atributo assumirá como padrão a localidade escolhida pelo Windows Runtime na resolução da sequência.