Esquema de conteúdo de notificação do sistema
Veja a seguir a descrição de todas as propriedades e elementos dentro do conteúdo da notificação do sistema.
Se preferir usar XML bruto em vez da biblioteca de notificações, consulte o esquema XML.
ToastContent
ToastContent é o objeto de nível superior que descreve o conteúdo de uma notificação, incluindo elementos visuais, ações e áudio.
Propriedade | Type | Obrigatória | Descrição |
---|---|---|---|
Inicializar | string | false | Uma sequência que é passada para o aplicativo quando ele é ativado pela notificação do sistema. O formato e o conteúdo dessa sequência são definidos pelo aplicativo para seu próprio uso. Quando o usuário toca ou clica na notificação do sistema para iniciar seu aplicativo associado, a sequência de inicialização fornece o contexto para o aplicativo que permite que ele mostre ao usuário uma exibição relevante para o conteúdo da notificação do sistema, em vez de iniciar em sua maneira padrão. |
Visual | ToastVisual | true | Descreve a parte visual da notificação do sistema. |
Ações | IToastActions | false | Opcionalmente, crie ações personalizadas com botões e entradas. |
Áudio | ToastAudio | false | Descreve a parte de áudio da notificação do sistema. |
ActivationType | ToastActivationType | false | Especifica qual tipo de ativação será usado quando o usuário clicar no corpo desta notificação do sistema. |
ActivationOptions | ToastActivationOptions | false | Novo no Creators Update: opções adicionais relacionadas à ativação da notificação do sistema. |
Cenário | ToastScenario | false | Declara o cenário para o qual a notificação do sistema é usada, como um alarme ou lembrete. |
DisplayTimestamp | DateTimeOffset? | false | Novo no Creators Update: substitui o carimbo de data/hora padrão por um carimbo de data/hora personalizado que representa quando o conteúdo da notificação foi realmente entregue, em vez da hora em que a notificação foi recebida pela plataforma Windows. |
Cabeçalho | ToastHeader | false | Novo no Creators Update: adicione um cabeçalho personalizado à sua notificação para agrupar várias notificações na Central de Ações. |
ToastScenario
Especifica qual cenário a notificação do sistema representa.
Valor | Significado |
---|---|
Default | O comportamento normal da notificação do sistema. |
Lembrete | Uma notificação de lembrete. Será exibida pré-expandida e permanecerá na tela do usuário até ser descartada. |
Alarme | Uma notificação de alarme. Será exibida pré-expandida e permanecerá na tela do usuário até ser descartada. O áudio será repetido por padrão e usará áudio de alarme. |
IncomingCall | Notificações de recebimento de chamadas. Serão exibidas pré-expandidas em um formato de chamada especial e permanecerão na tela do usuário até serem descartadas. O áudio será repetido por padrão e usará áudio de toque. |
ToastVisual
A parte visual das notificações do sistema contém as associações, que contém texto, imagens, conteúdo adaptável e muito mais.
Propriedade | Type | Obrigatória | Descrição |
---|---|---|---|
BindingGeneric | ToastBindingGeneric | true | A associação genérica do sistema, que pode ser renderizada em todos os dispositivos. Essa associação é necessária e não pode ser nula. |
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. |
ToastBindingGeneric
A associação genérica é a associação padrão para notificações do sistema e é onde você especifica o texto, as imagens, o conteúdo adaptável e muito mais.
Propriedade | Type | Obrigatória | Descrição |
---|---|---|---|
Filhos | IList<IToastBindingGenericChild> | false | O conteúdo do corpo da Notificação do Sistema, que pode incluir texto, imagens e grupos (adicionado na Atualização de Aniversário). Os elementos de texto devem vir antes de quaisquer outros elementos, e apenas 3 elementos de texto são compatíveis. Se um elemento de texto for colocado depois de qualquer outro elemento, ele será puxado para o topo ou descartado. E, finalmente, certas propriedades de texto, como HintStyle, não são compatíveis com os elementos de texto filhos raiz e só funcionam dentro de um AdaptiveSubgroup. Se você usar o AdaptiveGroup em dispositivos sem a Atualização de Aniversário, o conteúdo do grupo será simplesmente descartado. |
AppLogoOverride | ToastGenericAppLogo | false | Um logotipo opcional para substituir o logotipo do aplicativo. |
HeroImage | ToastGenericHeroImage | false | Uma imagem "hero" opcional que é exibida na notificação do sistema e na Central de Ações. |
Atribuição | ToastGenericAttributionText | false | Texto de atribuição opcional que será exibido na parte inferior da notificação do sistema. |
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. |
IToastBindingGenericChild
Interface de marcador para elementos filho de notificação do sistema que incluem texto, imagens, grupos e muito mais.
Implementações |
---|
AdaptiveText |
AdaptiveImage |
AdaptiveGroup |
AdaptiveProgressBar |
AdaptiveText
Um elemento de texto adaptável. Se colocado no nível superior ToastBindingGeneric.Children, somente HintMaxLines será aplicado. Mas se isso for colocado como filho de um grupo/subgrupo, o estilo de texto completo será compatível.
Propriedade | Type | Obrigatória | Descrição |
---|---|---|---|
Text | string ou BindableString | false | O texto a ser exibido. O suporte à associação de dados foi adicionado no Creators Update, mas só funciona para elementos de texto de nível superior. |
HintStyle | AdaptiveTextStyle | false | O estilo controla o tamanho, a espessura e a opacidade da fonte do texto. Ele só funciona para elementos de texto dentro de um grupo/subgrupo. |
HintWrap | bool? | false | Defina isso como true para habilitar a quebra de texto. Os elementos de texto de nível superior ignoram essa propriedade e sempre quebram a moldura (é possível usar HintMaxLines = 1 para desabilitar a quebra automática de quebra automática para elementos de texto de nível superior). Os elementos de texto dentro de grupos/subgrupos têm como padrão false para quebra automática. |
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. Ele só funciona para elementos de texto dentro de um grupo/subgrupo. |
HintAlign | AdaptiveTextAlign | false | O alinhamento horizontal do texto. Ele só funciona para elementos de texto dentro de um grupo/subgrupo. |
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. |
BindableString
Um valor de associação para sequências.
Propriedade | Type | Obrigatória | Descrição |
---|---|---|---|
BindingName | string | true | Obtém ou define o nome que mapeia para o valor de dados de associação. |
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 os alinhadores horizontais 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 | Novo na Atualização de Aniversário: Controle 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. Ele só funciona para imagens dentro de um grupo/subgrupo. |
AlternateText | string | false | Texto alternativo descrevendo a imagem, usado para fins de acessibilidade. |
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" |
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 | Alinha a imagem ao centro, exibindo-a em sua resolução nativa. |
Right | Alinha a imagem à direita, exibindo-a em sua resolução nativa. |
AdaptiveGroup
Novo na Atualização de Aniversário: os grupos identificam semanticamente que o conteúdo do 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
Novo na Atualização de aniversário: os 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. |
AdaptiveProgressBar
Novo no Creators Update: uma barra de progresso. Compatível apenas em notificações do sistema no Desktop, compilação 15063 ou posterior.
Propriedade | Type | Obrigatória | Description |
---|---|---|---|
Título | string ou BindableString | false | Obtém ou define uma sequência de títulos opcional. Suporte para a associação de dados. |
Valor | double ou AdaptiveProgressBarValue ou BindableProgressBarValue | false | Obtém ou define o valor da barra de progresso. Suporte para a associação de dados. Assume o padrão de 0. |
ValueStringOverride | string ou BindableString | false | Obtém ou define uma sequência opcional a ser exibida em vez da sequência de porcentagem padrão. Se isso não for fornecido, algo como "70%" será exibido. |
Status | string ou BindableString | true | Obtém ou define uma sequência de status (obrigatório), que é exibida abaixo da barra de progresso à esquerda. Essa sequência deve refletir o status da operação, como "Baixando..." ou "Instalando..." |
AdaptiveProgressBarValue
Uma classe que representa o valor da barra de progresso.
Propriedade | Type | Obrigatória | Description |
---|---|---|---|
Valor | double | false | Obtém ou define o valor (0,0 - 1,0) que representa a porcentagem concluída. |
IsIndeterminate | bool | false | Obtém ou define um valor que indica se a barra de progresso é indeterminada. Se isso for verdade, o Valor será ignorado. |
BindableProgressBarValue
Um valor de barra de progresso vinculável.
Propriedade | Type | Obrigatória | Descrição |
---|---|---|---|
BindingName | string | true | Obtém ou define o nome que mapeia para o valor de dados de associação. |
ToastGenericAppLogo
Um logotipo a ser exibido em vez do logotipo do aplicativo.
Propriedade | Type | Obrigatória | Descrição |
---|---|---|---|
Origem | string | true | A URL para a imagem. ms-appx, ms-appdata e http são compatíveis. As imagens http devem ter tamanho de 200 KB ou inferior. |
HintCrop | ToastGenericAppLogoCrop | false | Especifique como você deseja que a imagem seja cortada. |
AlternateText | string | false | Texto alternativo descrevendo a imagem, usado para fins de acessibilidade. |
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" |
ToastGenericAppLogoCrop
Controla o recorte da imagem do logotipo do aplicativo.
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. |
ToastGenericHeroImage
Uma imagem de "herói" em destaque que é exibida na notificação do sistema e na Central de Ações.
Propriedade | Type | Obrigatória | Descrição |
---|---|---|---|
Origem | string | true | A URL para a imagem. ms-appx, ms-appdata e http 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 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" |
ToastGenericAttributionText
Texto de atribuição exibido na parte inferior da notificação do sistema.
Propriedade | Type | Obrigatória | Descrição |
---|---|---|---|
Texto | string | true | O texto a ser exibido. |
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". Se isso não for fornecido, a localidade do sistema será usada no lugar dele. |
IToastActions
Interface de marcador para ações/entradas do sistema.
Implementações |
---|
ToastActionsCustom |
ToastActionsSnoozeAndDismiss |
ToastActionsCustom
Implementa IToastActions
Crie suas próprias ações e entradas personalizadas, usando controles como botões, caixas de texto e entradas de seleção.
Propriedade | Type | Obrigatória | Descrição |
---|---|---|---|
Entradas | IList<IToastInput> | false | Entradas como caixas de texto e entradas de seleção. Apenas até 5 entradas são permitidas. |
Buttons | IList<IToastButton> | false | Os botões são exibidos após todas as entradas (ou adjacentes a uma entrada, se o botão for usado como um botão de resposta rápida). Apenas até 5 botões são permitidos (ou menos, se você também tiver itens do menu de contexto). |
ContextMenuItems | IList<ToastContextMenuItem> | false | Novo na Atualização de Aniversário: itens de menu de contexto personalizados, fornecendo ações adicionais se o usuário clicar com o botão direito do mouse na notificação. Só é possível ter até 5 botões e itens do menu de contexto combinados. |
IToastInput
Interface de marcador para entradas de notificação do sistema.
Implementações |
---|
ToastTextBox |
ToastSelectionBox |
ToastTextBox
Implementa IToastInput
O controle TextBox controla se um usuário pode digitar texto.
Propriedade | Type | Obrigatória | Descrição |
---|---|---|---|
Id | string | true | A ID é necessária e é usada para mapear o texto de entrada de usuário em um par chave-valor de id/valor que o aplicativo consome mais adiante. |
Título | string | false | Texto do título a ser exibido acima da caixa de texto. |
PlaceholderContent | string | false | Texto do espaço reservado a ser exibido na caixa de texto quando o usuário ainda não tiver digitado nenhum texto. |
DefaultInput | string | false | O texto inicial a ser colocado na caixa de texto. Deixe isso nulo se desejar uma caixa de texto em branco. |
ToastSelectionBox
Implementa IToastInput
Um controle de caixa de seleção, que permite aos usuários escolher em uma lista suspensa de opções.
Propriedade | Type | Obrigatória | Descrição |
---|---|---|---|
Id | string | true | O Id é obrigatório. Se o usuário selecionou esse item, esse ID será passado de volta para o código do aplicativo, representando qual seleção ele escolheu. |
Sumário | string | true | O conteúdo é obrigatório e é uma sequência exibida no item de seleção. |
ToastSelectionBoxItem
Um item de caixa de seleção (um item que o usuário pode selecionar na lista suspensa).
Propriedade | Type | Obrigatória | Descrição |
---|---|---|---|
Id | string | true | A ID é necessária e é usada para mapear o texto de entrada de usuário em um par chave-valor de id/valor que o aplicativo consome mais adiante. |
Título | string | false | Texto do título a ser exibido acima da caixa de seleção. |
DefaultSelectionBoxItemId | string | false | Controla qual item é selecionado por padrão e se refere à propriedade Id de ToastSelectionBoxItem. Se você não fornecer isso, a seleção padrão ficará vazia (o usuário não verá nada). |
Itens | IList<ToastSelectionBoxItem> | false | Os itens de seleção que o usuário pode escolher nesta SelectionBox. Apenas 5 itens podem ser adicionados. |
IToastButton
Interface de marcador para botões do sistema.
Implementações |
---|
ToastButton |
ToastButtonSnooze |
ToastButtonDismiss |
ToastButton
Implementa IToastButton
Um botão no qual o usuário pode clicar.
Propriedade | Type | Obrigatória | Descrição |
---|---|---|---|
Sumário | string | true | Obrigatória. O texto a ser exibido no botão. |
Argumentos | string | true | Obrigatória. Sequência definida pelo aplicativo que o aplicativo receberá mais adiante se o usuário clicar nesse botão. |
ActivationType | ToastActivationType | false | Controla que tipo de ativação esse botão usará quando clicado. O padrão é primeiro plano. |
ActivationOptions | ToastActivationOptions | false | Novo no Creators Update: obtém ou define opções adicionais relacionadas à ativação do botão de notificação do sistema. |
ToastActivationType
Decide o tipo de ativação que será usado quando o usuário interagir com uma ação específica.
Valor | Significado |
---|---|
Primeiro plano | Valor padrão. O aplicativo é iniciado em primeiro plano. |
Background | A tarefa em segundo plano correspondente (supondo que você configure tudo) é acionada e é possível executar código em segundo plano (como enviar a mensagem de resposta rápida do usuário) sem interromper o usuário. |
Protocolo | Inicie um aplicativo diferente usando a ativação de protocolo. |
ToastActivationOptions
Novo no Creators Update: opções adicionais relacionadas à ativação.
Propriedade | Type | Obrigatória | Descrição |
---|---|---|---|
AfterActivationBehavior | ToastAfterActivationBehavior | false | Novo no Fall Creators Update: obtém ou define o comportamento que a notificação do sistema deve usar quando o usuário invoca essa ação. Isso só funciona na área de trabalho, para ToastButton e ToastContextMenuItem. |
ProtocolActivationTargetApplicationPfn | string | false | Se você estiver usando ToastActivationType.Protocol, poderá opcionalmente especificar o PFN de destino, de modo que, independentemente de vários aplicativos estarem registrados para lidar com o mesmo uri de protocolo, o aplicativo desejado sempre será iniciado. |
ToastAfterActivationBehavior
Especifica o comportamento que a notificação do sistema deve usar quando o usuário executa uma ação na notificação do sistema.
Valor | Significado |
---|---|
Default | Comportamento padrão. A notificação do sistema será descartada quando o usuário executar uma ação na notificação do sistema. |
PendingUpdate | Depois que o usuário clicar em um botão em sua notificação do sistema, a notificação permanecerá presente, em um estado visual de "atualização pendente". Você deve atualizar imediatamente sua notificação do sistema a partir de uma tarefa em segundo plano para que o usuário não veja esse estado visual de "atualização pendente" por muito tempo. |
ToastButtonSnooze
Implementa IToastButton
Um botão de colocar em ociosidade manipulado pelo sistema que lida automaticamente com a ociosidade da notificação.
Propriedade | Type | Obrigatória | Descrição |
---|---|---|---|
CustomContent | string | false | Texto personalizado opcional exibido no botão que substitui o texto "Colocar em ociosidade" localizado padrão. |
ToastButtonDismiss
Implementa IToastButton
Um botão para ignorar manipulado pelo sistema que ignora a notificação quando clicado.
Propriedade | Type | Obrigatória | Descrição |
---|---|---|---|
CustomContent | string | false | Texto personalizado opcional exibido no botão que substitui o texto "Ignorar" localizado padrão. |
ToastActionsSnoozeAndDismiss
*Implementa IToastActions
Constrói automaticamente uma caixa de seleção para intervalos de ociosidade e botões de ociosidade/ignorar, todos localizados automaticamente, e a lógica de soneca é manipulada automaticamente pelo sistema.
Propriedade | Type | Obrigatória | Descrição |
---|---|---|---|
ContextMenuItems | IList<ToastContextMenuItem> | false | Novo na Atualização de Aniversário: itens de menu de contexto personalizados, fornecendo ações adicionais se o usuário clicar com o botão direito do mouse na notificação. Você só pode ter até 5 itens. |
ToastContextMenuItem
Uma entrada de item do menu de contexto.
Propriedade | Type | Obrigatória | Descrição |
---|---|---|---|
Sumário | string | true | Obrigatória. O texto a ser exibido. |
Argumentos | string | true | Obrigatória. Sequência definida pelo aplicativo de argumentos que o aplicativo pode recuperar mais tarde quando é ativado quando o usuário clica no item de menu. |
ActivationType | ToastActivationType | false | Controla que tipo de ativação este item de menu usará quando clicado. O padrão é primeiro plano. |
ActivationOptions | ToastActivationOptions | false | Novo no Creators Update: opções adicionais relacionadas à ativação do item do menu de contexto da notificação do sistema. |
ToastAudio
Especifique o áudio a ser reproduzido quando a notificação do sistema for recebida.
Propriedade | Type | Obrigatória | Descrição |
---|---|---|---|
Src | uri | false | O arquivo de mídia a ser reproduzido no lugar do som padrão. Somente ms-appx e ms-resource são compatíveis. Todo o resto (ms-appdata, http, C: etc.) não é compatível. |
Loop | boolean | false | Defina como true se o som deve se repetir enquanto a notificação do sistema for mostrada; false para jogar apenas uma vez (padrão). |
Silent | boolean | false | True para silenciar o som; false para permitir que o som da notificação do sistema seja reproduzido (padrão). |
ToastHeader
Novo no Creators Update: um cabeçalho personalizado que agrupa várias notificações na Central de Ações.
Propriedade | Type | Obrigatória | Descrição |
---|---|---|---|
Id | string | true | Um identificador criado pelo desenvolvedor que identifica exclusivamente esse cabeçalho. Se duas notificações tiverem a mesma ID de cabeçalho, elas serão exibidas abaixo do mesmo cabeçalho na Central de Ações. |
Título | string | true | Um título para o cabeçalho. |
Argumentos | string | true | Obtém ou define uma sequência de argumentos definida pelo desenvolvedor que é retornada ao aplicativo quando o usuário clica nesse cabeçalho. Não pode ser nulo. |
ActivationType | ToastActivationType | false | Obtém ou define o tipo de ativação que esse cabeçalho usará quando clicado. O padrão é primeiro plano. Observe que somente o Primeiro Plano e o Protocolo são compatíveis. |
ActivationOptions | ToastActivationOptions | false | Obtém ou define opções adicionais relacionadas à ativação do cabeçalho de notificação do sistema. |
Tópicos relacionados
Windows developer