AppNotificationBuilder.SetScenario(AppNotificationScenario) Método

Definição

Namespace:

Microsoft.Windows.AppNotifications.Builder

Define o cenário para a notificação do aplicativo, o que faz com que o sistema ajuste alguns dos comportamentos de notificação para apresentar uma experiência consistente para o cenário especificado.

public:
 virtual AppNotificationBuilder ^ SetScenario(AppNotificationScenario value) = SetScenario;

AppNotificationBuilder SetScenario(AppNotificationScenario const& value);

public AppNotificationBuilder SetScenario(AppNotificationScenario value);

function setScenario(value)

Public Function SetScenario (value As AppNotificationScenario) As AppNotificationBuilder

Parâmetros

value

AppNotificationScenario

Um valor da enumeração AppNotificationScenario especificando o cenário para a notificação do aplicativo.

Retornos

AppNotificationBuilder

Retorna a instância AppNotificationBuilder para que chamadas de método adicionais possam ser encadeadas.

Exemplos

O exemplo a seguir demonstra como definir o cenário de notificação no conteúdo XML de uma notificação do aplicativo.

var notification = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetScenario(AppNotificationScenario.Reminder)
    .BuildNotification();

AppNotificationManager.Default.Show(notification);

O conteúdo XML resultante:

<toast scenario='reminder'>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
</toast>

Comentários

O valor de cenário de urgente só tem suporte no Windows 10 Build 19041 e posterior. Chame IsUrgentScenarioSupported para determinar em runtime se há suporte para o cenário urgente no dispositivo atual.

Para obter diretrizes sobre como usar as APIs AppNotificationBuilder para criar a interface do usuário para notificações de aplicativo, consulte conteúdo de notificação do 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 do aplicativo.