Share via


AppNotificationButton Classe

Definição

Representa um botão exibido em uma notificação de aplicativo.

public ref class AppNotificationButton sealed
/// [Windows.Foundation.Metadata.Activatable(Microsoft.Windows.AppNotifications.Builder.IAppNotificationButtonFactory, 65536, "Microsoft.Windows.AppNotifications.Builder.AppNotificationBuilderContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.Windows.AppNotifications.Builder.AppNotificationBuilderContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Windows.AppNotifications.Builder.AppNotificationBuilderContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AppNotificationButton final
[Windows.Foundation.Metadata.Activatable(typeof(Microsoft.Windows.AppNotifications.Builder.IAppNotificationButtonFactory), 65536, "Microsoft.Windows.AppNotifications.Builder.AppNotificationBuilderContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.Windows.AppNotifications.Builder.AppNotificationBuilderContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Windows.AppNotifications.Builder.AppNotificationBuilderContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AppNotificationButton
function AppNotificationButton(content)
Public NotInheritable Class AppNotificationButton
Herança
Object Platform::Object IInspectable AppNotificationButton
Atributos

Exemplos

O exemplo a seguir demonstra a adição de um botão ao conteúdo XML para uma notificação de aplicativo.

var notification = new AppNotificationBuilder()
    .AddText("Send a message.")
    .AddTextBox("textBox")
    .AddButton(new AppNotificationButton("Send")
        .AddArgument("action", "sendMessage"))
    .BuildNotification();

AppNotificationManager.Default.Show(notification);

O conteúdo XML resultante:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Send a message.</text>
        </binding>
    </visual>
    <actions>
        <input id='textBox' type='text'/><action content='Send' arguments='action=sendMessage'/>
    </actions>
</toast>

Comentários

Adicione um botão ao conteúdo XML para uma notificação de aplicativo chamando AppNotificationBuilder.AddButton. Até cinco botões podem ser adicionados a uma única notificação de aplicativo.

Para obter diretrizes sobre como usar as APIs AppNotificationBuilder para criar a interface do usuário para notificações de aplicativo, consulte Conteúdo da notificação de aplicativo.

Para obter informações de referência sobre o esquema XML para notificações de aplicativo, consulte Esquema de conteúdo de notificação de aplicativo.

Construtores

AppNotificationButton()

Inicializa uma nova instância da classe AppNotificationButton .

AppNotificationButton(String)

Inicializa uma nova instância da classe AppNotificationButton com o texto do botão especificado.

Propriedades

Arguments

Obtém ou define os argumentos associados ao AppNotificationButton.

ButtonStyle

Obtém ou define o estilo de um botão.

Content

Obtém ou define o texto do botão para um AppNotificationButton.

ContextMenuPlacement

Obtém ou define um valor que especifica se o botão é exibido dentro do menu de contexto de notificação do aplicativo.

Icon

Obtém ou define o ícone de um AppNotificationButton.

InputId

Obtém ou define a ID de entrada de um AppNotificationButton.

InvokeUri

Obtém ou define o URI que é iniciado quando o botão de notificação do aplicativo é clicado.

TargetAppId

Obtém ou define o PFN (Nome da Família de Pacotes) para o aplicativo a ser iniciado quando o botão de notificação do aplicativo é clicado.

ToolTip

Obtém ou define o texto da dica de ferramenta para o botão de notificação do aplicativo.

Métodos

AddArgument(String, String)

Adiciona um argumento composto por um par chave/valor ao conteúdo XML de um botão de notificação de aplicativo.

IsButtonStyleSupported()

Retorna um valor que indica se há suporte para estilos de botão para botões de notificação de aplicativo no dispositivo atual.

IsToolTipSupported()

Retorna um valor que indica se há suporte para dicas de ferramenta para botões de notificação de aplicativo no dispositivo atual.

SetButtonStyle(AppNotificationButtonStyle)

Define o estilo do botão para o botão de notificação do aplicativo.

SetContextMenuPlacement()

Solicita que o botão de notificação do aplicativo seja colocado no menu de contexto da notificação.

SetIcon(Uri)

Define o ícone de um AppNotificationButton.

SetInputId(String)

Define a ID de entrada para um AppNotificationButton.

SetInvokeUri(Uri)

Define o URI que é iniciado quando o botão de notificação do aplicativo é clicado.

SetInvokeUri(Uri, String)

Define o URI que é iniciado quando o botão de notificação do aplicativo é clicado, com um PFN (Nome da Família de Pacotes) fornecido para desambiguação.

SetToolTip(String)

Define o texto da dica de ferramenta para o botão de notificação do aplicativo.

Aplica-se a