Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O texto a seguir descreve todas as propriedades e elementos dentro do conteúdo do toast.
Se você preferir usar o XML bruto ao invés 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 visuais, ações e áudio.
| Property | Tipo | Required | Description |
|---|---|---|---|
| Launch | cadeia | false | Uma cadeia de caracteres que é passada para o aplicativo quando ele é ativado pelo Toast. O formato e o conteúdo dessa cadeia de caracteres são definidos pelo aplicativo para uso próprio. Quando o usuário toca ou clica no Toast para iniciar seu aplicativo associado, a cadeia de caracteres 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 do Toast, em vez de iniciar da maneira padrão. |
| Visual | ToastVisual | true | Descreve a parte visual da notificação de toast. |
| Actions | IToastActions | false | Opcionalmente, crie ações personalizadas com botões e entradas. |
| Audio | ToastAudio | false | Descreve a parte de áudio da notificação de brinde. |
| ActivationType | ToastActivationType | false | Especifica qual tipo de ativação será usado quando o usuário clicar no corpo deste Toast. |
| ActivationOptions | ToastActivationOptions | false | Novidades na Atualização dos Criadores: opções adicionais relacionadas à ativação da notificação de brindes. |
| Scenario | ToastScenario | false | Declara a situação para a qual a sua notificação é usada, como um alarme ou lembrete. |
| DisplayTimestamp | DateTimeOffset? | false | Novo no Creators Update: substitua 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. |
| Header | ToastHeader | false | Novidades na Atualização de Criadores: adicione um cabeçalho personalizado à notificação para agrupar várias notificações na Central de Ações. |
ToastScenario
Especifica qual cenário a notificação representa.
| Value | Meaning |
|---|---|
| Default | O comportamento normal do sistema. |
| Reminder | Uma notificação de lembrete. Isso será exibido previamente e permanecerá na tela do usuário até ser ignorado. |
| Alarm | Uma notificação de alarme. Isso será exibido previamente e permanecerá na tela do usuário até ser ignorado. O áudio será reproduzido em loop por padrão e utilizará o som do alarme. |
| IncomingCall | Uma notificação de chamada de entrada. Isso será exibido previamente expandido em um formato de chamada especial e permanecerá na tela do usuário até ser ignorado. O áudio será reproduzido em loop por padrão e usará áudio de toque de chamada. |
ToastVisual
A seção visual das mensagens informativas contém as associações, que contêm texto, imagens, conteúdo adaptável e muito mais.
| Property | Tipo | Required | Description |
|---|---|---|---|
| BindingGeneric | ToastBindingGeneric | true | O vínculo genérico de notificação, que pode ser exibido 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 string de consulta à URL da imagem fornecida na notificação toast. Use esse atributo se o servidor hospedar imagens e puder lidar com cadeias de caracteres de consulta, recuperando uma variante de imagem com base nas cadeias de caracteres de consulta ou ignorando a cadeia de caracteres de consulta e retornando 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 se torna "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us" |
| Language | cadeia | false | A localidade de destino do conteúdo visual ao usar recursos localizados, especificados como marcas de idioma BCP-47, como "en-US" ou "fr-FR". Essa localidade é substituída por qualquer localidade especificada em associação ou texto. Caso não seja fornecido, a localidade do sistema será usada. |
ToastBindingGeneric
A associação genérica é a associação padrão para notificações e é onde você especifica o texto, as imagens, o conteúdo adaptável e muito mais.
| Property | Tipo | Required | Description |
|---|---|---|---|
| Children | IList<IToastBindingGenericChild> | false | O conteúdo do corpo do Toast, que pode incluir texto, imagens e grupos (adicionados à Atualização de Aniversário). Os elementos de texto devem vir antes de qualquer outro elemento, e apenas 3 elementos de texto têm suporte. Se um elemento de texto for colocado após qualquer outro elemento, ele será puxado para a parte superior ou descartado. Por fim, certas propriedades de texto, como HintStyle, não têm suporte nos elementos de texto principais e funcionam apenas dentro de um AdaptiveSubgroup. Se você usar 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 em destaque exibida no sistema e na Central de Ações. |
| Attribution | ToastGenericAttributionText | false | Texto de atribuição opcional que será exibido na parte inferior do alerta tipo toast. |
| 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 string de consulta à URL da imagem fornecida na notificação toast. Use esse atributo se o servidor hospedar imagens e puder lidar com cadeias de caracteres de consulta, recuperando uma variante de imagem com base nas cadeias de caracteres de consulta ou ignorando a cadeia de caracteres de consulta e retornando 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 se torna "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us" |
| Language | cadeia | false | A localidade de destino do conteúdo visual ao usar recursos localizados, especificados como marcas de idioma BCP-47, como "en-US" ou "fr-FR". Essa localidade é substituída por qualquer localidade especificada em associação ou texto. Caso não seja fornecido, a localidade do sistema será usada. |
IToastBindingGenericChild
Interface de marcador para elementos filho do toast que incluem texto, imagens, grupos e muito mais.
| Implementations |
|---|
| AdaptiveText |
| AdaptiveImage |
| AdaptiveGroup |
| AdaptiveProgressBar |
AdaptiveText
Um elemento de texto adaptável. Se for colocado no nível superior de ToastBindingGeneric.Children, apenas HintMaxLines será aplicado. No entanto, se isso for colocado como um elemento de um grupo/subgrupo, o estilo de texto completo é suportado.
| Property | Tipo | Required | Description |
|---|---|---|---|
| Text | cadeia de caracteres ou BindableString | false | O texto a ser exibido. Suporte à associação de dados adicionado ao Creators Update, mas só funciona para elementos de texto de nível superior. |
| HintStyle | AdaptiveTextStyle | false | O estilo controla o tamanho, o peso e a opacidade da fonte do texto. Só funciona para elementos de texto dentro de um grupo/subgrupo. |
| HintWrap | bool? | false | Defina isso como true para habilitar o encapsulamento de texto. Elementos de texto de nível superior ignoram essa propriedade e sempre encapsulam (você pode usar HintMaxLines = 1 para desabilitar o encapsulamento para elementos de texto de nível superior). Elementos de texto dentro de grupos/subgrupos têm como padrão o valor false para quebra de linha. |
| 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. Só funciona para elementos de texto dentro de um grupo/subgrupo. |
| HintAlign | AdaptiveTextAlign | false | O alinhamento horizontal do texto. Só funciona para elementos de texto dentro de um grupo/subgrupo. |
| Language | cadeia | false | A localidade de destino do conteúdo XML, especificada como marcas de idioma BCP-47, como "en-US" ou "fr-FR". A localidade especificada aqui substitui qualquer outra localidade definida, como a usada em associação de dados ou visual. Se esse valor for uma cadeia de caracteres literal, esse atributo usará como padrão a linguagem de interface do usuário. Se esse valor for uma referência de cadeia de caracteres, esse atributo usará como padrão a localidade escolhida pelo Windows Runtime na resolução da cadeia de caracteres. |
BindableString
Um valor de associação para cadeias de caracteres.
| Property | Tipo | Required | Description |
|---|---|---|---|
| BindingName | cadeia | true | Obtém ou define o nome que mapeia para o valor de dados da sua vinculação. |
AdaptiveTextStyle
O estilo de texto controla o tamanho da fonte, o peso e a opacidade. A opacidade sutil é 60% opaca.
| Value | Meaning |
|---|---|
| Default | Valor padrão. O estilo é determinado pelo renderizador. |
| Caption | Menor que o tamanho da fonte do parágrafo. |
| CaptionSubtle | O mesmo que Legenda, mas com leve opacidade. |
| Body | 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 de Body. |
| BaseSubtle | O mesmo que Base, mas com opacidade sutil. |
| Subtitle | Tamanho da fonte H4. |
| SubtitleSubtle | O mesmo que Subtítulo, mas com opacidade sutil. |
| Title | Tamanho da fonte H3. |
| TitleSubtle | O mesmo que o Título, mas com opacidade sutil. |
| TitleNumeral | Igual ao Título, mas com a margem superior/inferior removida. |
| Subheader | Tamanho da fonte H2. |
| SubheaderSubtle | O mesmo que Subheader, mas com opacidade sutil. |
| SubheaderNumeral | O mesmo que o Subheader, mas com a margem superior e inferior removida. |
| Header | Tamanho da fonte H1. |
| HeaderSubtle | Mesmo que o cabeçalho, mas com uma opacidade sutil. |
| HeaderNumeral | O mesmo que Cabeçalho, mas com o espaçamento superior/inferior removido. |
AdaptiveTextAlign
Controla o alinhamento horizontal do texto.
| Value | Meaning |
|---|---|
| Default | Valor padrão. O alinhamento é determinado automaticamente pelo renderizador. |
| Auto | Alinhamento determinado pela linguagem e pela cultura atuais. |
| Left | Alinhe horizontalmente o texto à esquerda. |
| Center | Alinhe horizontalmente o texto no centro. |
| Right | Alinhe horizontalmente o texto à direita. |
AdaptiveImage
Uma imagem embutida.
| Property | Tipo | Required | Description |
|---|---|---|---|
| Source | cadeia | true | A URL da imagem. Há suporte para ms-appx, ms-appdata e http. 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 não devem ter mais de 200 KB. |
| HintCrop | AdaptiveImageCrop | false | Novidade na Atualização de Aniversário: controlar o corte desejado da imagem. |
| HintRemoveMargin | bool? | false | Por padrão, as imagens dentro de grupos/subgrupos têm uma margem de 8px em torno delas. Você pode remover essa margem definindo essa propriedade como true. |
| HintAlign | AdaptiveImageAlign | false | O alinhamento horizontal da imagem. Só funciona para imagens dentro de um grupo/subgrupo. |
| AlternateText | cadeia | false | Texto alternativo que descreve a imagem, usada para fins de acessibilidade. |
| AddImageQuery | bool? | false | Defina como "true" para permitir que o Windows acrescente uma string de consulta à URL da imagem fornecida na notificação toast. Use esse atributo se o servidor hospedar imagens e puder lidar com cadeias de caracteres de consulta, recuperando uma variante de imagem com base nas cadeias de caracteres de consulta ou ignorando a cadeia de caracteres de consulta e retornando 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 se torna "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us" |
AdaptiveImageCrop
Especifica o corte desejado da imagem.
| Value | Meaning |
|---|---|
| Default | Valor padrão. Comportamento de corte determinado pelo renderizador. |
| None | A imagem não é cortada. |
| Circle | A imagem é cortada em uma forma de círculo. |
AdaptiveImageAlign
Especifica o alinhamento horizontal de uma imagem.
| Value | Meaning |
|---|---|
| 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 a imagem é colocada). |
| Left | Alinhe a imagem à esquerda, exibindo a imagem em sua resolução nativa. |
| Center | Alinhe a imagem no centro horizontalmente, exibindo a imagem em sua resolução nativa. |
| Right | Alinhe a imagem à direita, exibindo a imagem em sua resolução nativa. |
AdaptiveGroup
Novidades na Atualização de Aniversário: os grupos identificam semanticamente que o conteúdo no grupo deve ser exibido como um todo, ou não exibido, se não puder ser acomodado. Os grupos também permitem a criação de várias colunas.
AdaptiveSubgroup
Novidades na Atualização de Aniversário: subgrupos são colunas verticais que podem conter texto e imagens.
| Property | Tipo | Required | Description |
|---|---|---|---|
| Children | 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 desse subgrupo. |
IAdaptiveSubgroupChild
Interface de marcador para filhos de subgrupo.
| Implementations |
|---|
| AdaptiveText |
| AdaptiveImage |
AdaptiveSubgroupTextStacking
TextStacking especifica o alinhamento vertical do conteúdo.
| Value | Meaning |
|---|---|
| Default | Valor padrão. O renderizador seleciona automaticamente o alinhamento vertical padrão. |
| Top | Alinhar verticalmente ao topo. |
| Center | Alinhamento vertical ao centro. |
| Bottom | Alinhar verticalmente à parte inferior. |
AdaptiveProgressBar
Novidades na Atualização de Criadores: uma barra de progresso. Apenas com suporte para notificações tipo "toast" na Área de Trabalho, build 15063 ou posterior.
| Property | Tipo | Required | Description |
|---|---|---|---|
| Title | cadeia de caracteres ou BindableString | false | Obtém ou define uma cadeia de caracteres de título opcional. Dá suporte à associação de dados. |
| Value | double ou AdaptiveProgressBarValue ou BindableProgressBarValue | false | Obtém ou define o valor da barra de progresso. Dá suporte à associação de dados. O valor padrão é 0. |
| ValueStringOverride | cadeia de caracteres ou BindableString | false | Obtém ou define uma cadeia de caracteres opcional a ser exibida em vez da cadeia de caracteres de porcentagem padrão. Se isso não for fornecido, algo como "70%" será exibido. |
| Status | cadeia de caracteres ou BindableString | true | Obtém ou define uma cadeia de caracteres de status (obrigatório), que é exibida abaixo da barra de progresso à esquerda. Essa cadeia de caracteres deve refletir o status da operação, como "Baixando..." ou "Instalando..." |
AdaptiveProgressBarValue
Uma classe que representa o valor da barra de progresso.
| Property | Tipo | Required | Description |
|---|---|---|---|
| Value | 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, Valor será ignorado. |
BindableProgressBarValue
Um valor vinculável de barra de progresso.
| Property | Tipo | Required | Description |
|---|---|---|---|
| BindingName | cadeia | true | Obtém ou define o nome que mapeia para o valor de dados da sua vinculação. |
ToastGenericAppLogo
Um logotipo a ser exibido em vez do logotipo do aplicativo.
| Property | Tipo | Required | Description |
|---|---|---|---|
| Source | cadeia | true | A URL da imagem. Há suporte para ms-appx, ms-appdata e http. As imagens http devem ter 200 KB ou menos de tamanho. |
| HintCrop | ToastGenericAppLogoCrop | false | Especifique como você gostaria que a imagem fosse cortada. |
| AlternateText | cadeia | false | Texto alternativo que descreve a imagem, usada para fins de acessibilidade. |
| AddImageQuery | bool? | false | Defina como "true" para permitir que o Windows acrescente uma string de consulta à URL da imagem fornecida na notificação toast. Use esse atributo se o servidor hospedar imagens e puder lidar com cadeias de caracteres de consulta, recuperando uma variante de imagem com base nas cadeias de caracteres de consulta ou ignorando a cadeia de caracteres de consulta e retornando 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 se torna "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us" |
ToastGenericAppLogoCrop
Controla o corte da imagem do logotipo do aplicativo.
| Value | Meaning |
|---|---|
| Default | O recorte utiliza o comportamento padrão do renderizador. |
| None | A imagem não é cortada, exibida em formato quadrado. |
| Circle | A imagem é recortada em formato de círculo. |
ToastGenericHeroImage
Uma imagem de destaque "hero" exibida no toast e na Central de Ações.
| Property | Tipo | Required | Description |
|---|---|---|---|
| Source | cadeia | true | A URL da imagem. Há suporte para ms-appx, ms-appdata e http. As imagens http devem ter 200 KB ou menos de tamanho. |
| AlternateText | cadeia | false | Texto alternativo que descreve a imagem, usada para fins de acessibilidade. |
| AddImageQuery | bool? | false | Defina como "true" para permitir que o Windows acrescente uma string de consulta à URL da imagem fornecida na notificação toast. Use esse atributo se o servidor hospedar imagens e puder lidar com cadeias de caracteres de consulta, recuperando uma variante de imagem com base nas cadeias de caracteres de consulta ou ignorando a cadeia de caracteres de consulta e retornando 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 se torna "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.
| Property | Tipo | Required | Description |
|---|---|---|---|
| Text | cadeia | true | O texto a ser exibido. |
| Language | cadeia | false | A localidade de destino do conteúdo visual ao usar recursos localizados, especificados como marcas de idioma BCP-47, como "en-US" ou "fr-FR". Caso não seja fornecido, a localidade do sistema será usada. |
IToastActions
Interface de marcador para ações/entradas de notificações.
| Implementations |
|---|
| 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.
| Property | Tipo | Required | Description |
|---|---|---|---|
| Inputs | IList<IToastInput> | false | Entradas como caixas de texto e campos de seleção. Somente 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). Somente até 5 botões são permitidos (ou menos se você também tiver itens de menu de contexto). |
| ContextMenuItems | IList<ToastContextMenuItem> | false | Novidade 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 botões e itens de menu de contexto combinados. |
IToastInput
Interface de marcador para entradas do sistema.
| Implementations |
|---|
| ToastTextBox |
| ToastSelectionBox |
ToastTextBox
Implementa IToastInput
Um controle de caixa de texto no qual o usuário pode digitar texto.
| Property | Tipo | Required | Description |
|---|---|---|---|
| Id | cadeia | true | A ID é necessária e é usada para mapear o texto inserido pelo usuário em um par chave-valor de id/valor que seu aplicativo consumirá posteriormente. |
| Title | cadeia | false | Texto do título a ser exibido acima da caixa de texto. |
| PlaceholderContent | cadeia | false | Texto de espaço reservado exibido na caixa de texto quando o usuário ainda não digitou nenhum texto. |
| DefaultInput | cadeia | false | O texto inicial a ser colocado na caixa de texto. Deixe isso nulo para uma caixa de texto em branco. |
ToastSelectionBox
Implementa IToastInput
Um controle de caixa de seleção, que permite que os usuários escolham em uma lista suspensa de opções.
| Property | Tipo | Required | Description |
|---|---|---|---|
| Id | cadeia | true | A ID é necessária. Se o usuário tiver selecionado esse item, essa ID será passada de volta para o código do aplicativo, representando qual seleção ele escolheu. |
| Content | cadeia | true | O conteúdo é necessário e é uma cadeia de caracteres 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).
| Property | Tipo | Required | Description |
|---|---|---|---|
| Id | cadeia | true | A ID é necessária e é usada para mapear o texto inserido pelo usuário em um par chave-valor de id/valor que seu aplicativo consumirá posteriormente. |
| Title | cadeia | false | Texto do título a ser exibido acima da caixa de seleção. |
| DefaultSelectionBoxItemId | cadeia | false | Isso controla qual item é selecionado por padrão e se refere à propriedade ID do ToastSelectionBoxItem. Se você não fornecer isso, a seleção padrão estará vazia (o usuário não verá nada). |
| Items | IList<ToastSelectionBoxItem> | false | Os itens de seleção que o usuário pode escolher neste SelectionBox. Somente 5 itens podem ser adicionados. |
IToastButton
Interface de marcador para botões de notificação.
| Implementations |
|---|
| ToastButton |
| ToastButtonSnooze |
| ToastButtonDismiss |
ToastButton
Implementa IToastButton
Um botão em que o usuário pode clicar.
| Property | Tipo | Required | Description |
|---|---|---|---|
| Content | cadeia | true | Required. O texto a ser exibido no botão. |
| Arguments | cadeia | true | Required. Cadeia de caracteres de argumentos definida pelo aplicativo que o aplicativo receberá posteriormente 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 é Foreground. |
| ActivationOptions | ToastActivationOptions | false | Novidades na Atualização para Criadores: obtém ou define opções adicionais relacionadas à ativação do botão de notificação. |
ToastActivationType
Decide o tipo de ativação que será usado quando o usuário interagir com uma ação específica.
| Value | Meaning |
|---|---|
| Foreground | Valor padrão. Seu aplicativo em primeiro plano é iniciado. |
| Background | Sua tarefa em segundo plano correspondente (supondo que você configurou tudo) é disparada e você pode executar código em segundo plano (como enviar a mensagem de resposta rápida do usuário) sem interromper o usuário. |
| Protocol | Inicie um aplicativo diferente usando a ativação do protocolo. |
ToastActivationOptions
Novidades na Atualização de Criadores: opções adicionais relacionadas à ativação.
| Property | Tipo | Required | Description |
|---|---|---|---|
| AfterActivationBehavior | ToastAfterActivationBehavior | false | Novo no Fall Creators Update: obtém ou define o comportamento que a notificação deve adotar quando o usuário invoca essa ação. Isso só funciona no desktop, para ToastButton e ToastContextMenuItem. |
| ProtocolActivationTargetApplicationPfn | cadeia | false | Se você estiver usando ToastActivationType.Protocol, opcionalmente poderá 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 (toast) deve usar quando o usuário toma uma ação na notificação.
| Value | Meaning |
|---|---|
| Default | Comportamento padrão. A notificação será descartada quando o usuário tomar ação sobre a notificação. |
| PendingUpdate | Depois que o usuário clicar em um botão no seu sistema, a notificação permanecerá presente, em um estado visual de "atualização pendente". Você deve atualizar imediatamente sua notificação a partir de uma tarefa em segundo plano para que o usuário não veja este estado visual de "atualização pendente" por muito tempo. |
ToastButtonSnooze
Implementa IToastButton
Um botão de soneca controlado pelo sistema que lida automaticamente com o adiamento da notificação.
| Property | Tipo | Required | Description |
|---|---|---|---|
| CustomContent | cadeia | false | Texto personalizado opcional exibido no botão que substitui o texto "Soneca" localizado padrão. |
ToastButtonDismiss
Implementa IToastButton
Um botão de descarte manipulado pelo sistema que descarta a notificação quando clicado.
| Property | Tipo | Required | Description |
|---|---|---|---|
| CustomContent | cadeia | false | Texto personalizado opcional exibido no botão que substitui o texto "Ignorar" localizado padrão. |
ToastActionsSnoozeAndDismiss
Implementa IToastActions
Constroi automaticamente uma lista de seleção para intervalos de soneca e botões de soneca/dispensa, todos localizados automaticamente, e a lógica de soneca é tratada automaticamente pelo sistema.
| Property | Tipo | Required | Description |
|---|---|---|---|
| ContextMenuItems | IList<ToastContextMenuItem> | false | Novidade 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 menu de contexto.
| Property | Tipo | Required | Description |
|---|---|---|---|
| Content | cadeia | true | Required. O texto a ser exibido. |
| Arguments | cadeia | true | Required. Cadeia de caracteres de argumentos definida pelo aplicativo que o aplicativo pode recuperar posteriormente quando é ativado quando o usuário clica no item de menu. |
| ActivationType | ToastActivationType | false | Controla que tipo de ativação esse item de menu usará quando clicado. O padrão é Foreground. |
| ActivationOptions | ToastActivationOptions | false | Novidades na Atualização dos Criadores: opções adicionais relacionadas à ativação do item de menu de contexto de notificação. |
ToastAudio
Especifique o áudio a ser reproduzido quando a notificação do Toast for recebida.
| Property | Tipo | Required | Description |
|---|---|---|---|
| Src | uri | false | O arquivo de mídia a ser reproduzido no lugar do som padrão. Há suporte apenas para ms-appx e ms-resource. Não há suporte para todos os outros (ms-appdata, http, C:, etc.). |
| Loop | boolean | false | Defina como true se o som deve se repetir enquanto o Toast é mostrado; false para reproduzir apenas uma vez (padrão). |
| Silent | boolean | false | Verdadeiro para silenciar o som; Falso para permitir que o som de notificação toast toque (padrão). |
ToastHeader
Novo no Creators Update: um cabeçalho personalizado que agrupa várias notificações na Central de Ações.
| Property | Tipo | Required | Description |
|---|---|---|---|
| Id | cadeia | 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. |
| Title | cadeia | true | Um título para o cabeçalho. |
| Arguments | cadeia | true | Obtém ou define uma string de argumentos definida pelo desenvolvedor que é retornada ao aplicativo quando o usuário clica neste 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 é Foreground. Observe que há suporte apenas para o Primeiro Plano e o Protocolo. |
| ActivationOptions | ToastActivationOptions | false | Obtém ou define opções adicionais relacionadas à ativação do cabeçalho da notificação. |
Tópicos relacionados
Windows developer