Partilhar via

action (Esquema XML do Toast)

  • Artigo

Especifica um botão mostrado em uma notificação do sistema.

Hierarquia de elementos

<Brinde>
<Ações>
<Entrada>

Syntax

<action content = string
    arguments = string
    activationType? = "foreground" | "background" | "protocol"
    afterActivationBehavior? = "default" | "pendingUpdate"
    placement? = "contextMenu"
    imageUri? = string
    hint-inputid = string
    hint-buttonStyle = "Success" | "Critical"
    hint-toolTip = string
/>

Chave

? opcional (zero ou um)

Atributos e elementos

Atributos

Atributo Descrição Tipo de dados Obrigatório Valor padrão
conteúdo O conteúdo exibido no botão. string Sim Nenhum
argumentos Cadeia de caracteres de argumentos definida pelo aplicativo e ele receberá posteriormente se o usuário clicar neste botão. string Sim Nenhum
tipo Uma cadeia de caracteres de argumento que pode ser passada para o aplicativo associado para fornecer detalhes sobre a ação que ele deve executar em resposta à ação do usuário. string Sim Nenhum
Activationtype Decide o tipo de ativação que será usada quando o usuário interage com uma ação específica.
  • "foreground" – valor padrão. O aplicativo em primeiro plano é iniciado.
  • "background" – sua tarefa em segundo plano correspondente é disparada e você pode executar o código em segundo plano sem interromper o usuário.
  • "protocolo" – inicie um aplicativo diferente usando a ativação de protocolo.
 string No "primeiro plano"
afterActivationBehavior Especifica o comportamento que a notificação do sistema deve usar quando o usuário executa ações referentes à notificação do sistema.
  • "default" – valor padrão. A notificação do sistema será ignorada quando o usuário executar ações referentes à notificação do sistema.
  • "pendingUpdate" – depois que o usuário clicar em um botão no sistema, a notificação permanecerá presente, em um estado visual de "atualização pendente". Você deve atualizar imediatamente a notificação do sistema de uma tarefa em segundo plano para que o usuário não veja esse estado visual de "atualização pendente" por muito tempo.
 string No "default"
posicionamento Quando definida como "contextMenu", a ação se torna uma ação de menu de contexto adicionada ao menu de contexto da notificação do sistema em vez de um botão do sistema tradicional. string Não Nenhum
imageUri O URI da origem da imagem para um ícone de botão do sistema. Esses ícones são imagens de 16 x 16 pixels transparentes em branco com escala de 100% e não devem ter nenhum preenchimento incluído na própria imagem. Se você optar por fornecer ícones em uma notificação do sistema, é necessário fornecer ícones para todos os seus botões na notificação, pois isso transforma o estilo dos botões em botões de ícones. Use um dos seguintes manipuladores de protocolo:
  • http:// ou https:// – uma imagem baseada na Web.
  • ms-appx:/// - Uma imagem incluída no pacote do aplicativo.
  • ms-appdata:///local/ – Uma imagem salva no armazenamento local.
  • file:/// - Uma imagem local. (Com suporte apenas para aplicativos da área de trabalho. Este protocolo não pode ser usado por aplicativos UWP.)
 string Não Nenhum
hint-inputId Defina como a ID de uma entrada para posicionar o botão ao lado da entrada. string Não Nenhum
hint-buttonStyle O estilo do botão. useButtonStyle deve ser definido como true no elemento toast .
  • "Êxito" – O botão está verde
  • "Crítico" – o botão é vermelho.
Observe que esses valores diferenciam maiúsculas de minúsculas.		 string Não Nenhum
dica-toolTip A dica de ferramenta para um botão, se o botão tiver uma cadeia de caracteres de conteúdo vazia. string Não Nenhum

Elementos filho

Nenhum

Elementos pai

Elemento pai Descrição
actions Elemento container para declarar até cinco entradas e até cinco ações de botão para a notificação do sistema.

Confira também