AppNotificationBuilder.AddText Método

Definición

Espacio de nombres:

Microsoft.Windows.AppNotifications.Builder

Sobrecargas

AddText(String)	Agrega un bloque de texto a la carga XML para una notificación de aplicación.
AddText(String, AppNotificationTextProperties)	Agrega un bloque de texto, con opciones de visualización y localización, a la carga XML de una notificación de aplicación.

AddText(String)

Agrega un bloque de texto a la carga XML para una notificación de aplicación.

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

Cadena que contiene el texto que se va a mostrar en la notificación de la aplicación.

Devoluciones

AppNotificationBuilder

Devuelve la instancia de AppNotificationBuilder para que se puedan encadenar llamadas de método adicionales.

Atributos

OverloadAttribute

Ejemplos

En el ejemplo siguiente se muestra cómo agregar un bloque de texto a la carga XML para una notificación de aplicación.

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

AppNotificationManager.Default.Show(notification);

La carga XML resultante:

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

Comentarios

Se puede agregar un máximo de tres elementos de texto a una notificación de aplicación. Si se supera este límite, se producirá un error.

Para obtener instrucciones sobre el uso de las API de AppNotificationBuilder para crear la interfaz de usuario para las notificaciones de la aplicación, consulte Contenido de la notificación de la aplicación.

Para obtener información de referencia sobre el esquema XML para las notificaciones de aplicaciones, consulte Esquema de contenido de notificación de aplicaciones.

AddText(String, AppNotificationTextProperties)

Agrega un bloque de texto, con opciones de visualización y localización, a la carga XML de una notificación de aplicación.

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

Cadena que contiene el texto que se va a mostrar en la notificación de la aplicación.

properties

AppNotificationTextProperties

AppNotificationTextProperties que especifica las propiedades de visualización y localización del texto.

Devoluciones

AppNotificationBuilder

Devuelve la instancia de AppNotificationBuilder para que se puedan encadenar llamadas de método adicionales.

Atributos

OverloadAttribute

Ejemplos

En el ejemplo siguiente se muestra cómo agregar un bloque de texto a la carga XML para una notificación de aplicación.

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

AppNotificationManager.Default.Show(notification);

La carga XML resultante:

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

Comentarios

Se puede agregar un máximo de tres elementos de texto a una notificación de aplicación. Si se supera este límite, se producirá un error.

Para obtener instrucciones sobre el uso de las API de AppNotificationBuilder para crear la interfaz de usuario para las notificaciones de la aplicación, consulte Contenido de la notificación de la aplicación.

Para obtener información de referencia sobre el esquema XML para las notificaciones de aplicaciones, consulte Esquema de contenido de notificación de aplicaciones.