AppNotificationBuilder.AddText Método

Definição

Namespace:

Microsoft.Windows.AppNotifications.Builder

Sobrecargas

AddText(String)	Adiciona um bloco de texto ao conteúdo XML para uma notificação de aplicativo.
AddText(String, AppNotificationTextProperties)	Adiciona um bloco de texto, com opções de exibição e localização, ao conteúdo XML de uma notificação de aplicativo.

AddText(String)

Adiciona um bloco de texto ao conteúdo XML para uma notificação de aplicativo.

public:
 virtual AppNotificationBuilder ^ AddText(Platform::String ^ text) = AddText;

/// [Windows.Foundation.Metadata.Overload("AddText")]
AppNotificationBuilder AddText(winrt::hstring const& text);

[Windows.Foundation.Metadata.Overload("AddText")]
public AppNotificationBuilder AddText(string text);

function addText(text)

Public Function AddText (text As String) As AppNotificationBuilder

Parâmetros

text

String

Platform::String

winrt::hstring

Uma cadeia de caracteres que contém o texto a ser exibido na notificação do aplicativo.

Retornos

AppNotificationBuilder

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

Atributos

OverloadAttribute

Exemplos

O exemplo a seguir demonstra como adicionar um bloco de texto ao conteúdo XML para uma notificação de aplicativo.

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

AppNotificationManager.Default.Show(notification);

O conteúdo XML resultante:

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

Comentários

No máximo três elementos de texto podem ser adicionados a uma notificação de aplicativo. Exceder esse limite gerará um erro.

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 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 de aplicativo.

AddText(String, AppNotificationTextProperties)

Adiciona um bloco de texto, com opções de exibição e localização, ao conteúdo XML de uma notificação de aplicativo.

public:
 virtual AppNotificationBuilder ^ AddText(Platform::String ^ text, AppNotificationTextProperties ^ properties) = AddText;

/// [Windows.Foundation.Metadata.Overload("AddText2")]
AppNotificationBuilder AddText(winrt::hstring const& text, AppNotificationTextProperties const& properties);

[Windows.Foundation.Metadata.Overload("AddText2")]
public AppNotificationBuilder AddText(string text, AppNotificationTextProperties properties);

function addText(text, properties)

Public Function AddText (text As String, properties As AppNotificationTextProperties) As AppNotificationBuilder

Parâmetros

text

String

Platform::String

winrt::hstring

Uma cadeia de caracteres que contém o texto a ser exibido na notificação do aplicativo.

properties

AppNotificationTextProperties

Um AppNotificationTextProperties que especifica propriedades de exibição e localização para o texto.

Retornos

AppNotificationBuilder

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

Atributos

OverloadAttribute

Exemplos

O exemplo a seguir demonstra como adicionar um bloco de texto ao conteúdo XML para uma notificação de aplicativo.

var notification = new AppNotificationBuilder()
    .AddText("Notification text.", new AppNotificationTextProperties().SetMaxLines(2))
    .BuildNotification();

AppNotificationManager.Default.Show(notification);

O conteúdo XML resultante:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text hint-maxLines='2'>Notification text.</text>
        </binding>
    </visual>
</toast>

Comentários

No máximo três elementos de texto podem ser adicionados a uma notificação de aplicativo. Exceder esse limite gerará um erro.

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 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 de aplicativo.