Condividi tramite

AppNotificationBuilder.SetHeroImage Metodo

Definizione

Spazio dei nomi:
Microsoft.Windows.AppNotifications.Builder

Overload

Nome Descrizione
SetHeroImage(Uri)

Imposta l'immagine visualizzata nella parte superiore di una notifica dell'app, occupando tutta la larghezza della notifica.
SetHeroImage(Uri, String)

Imposta l'immagine visualizzata nella parte superiore di una notifica dell'app, occupando tutta la larghezza della notifica, con il testo alternativo specificato.

SetHeroImage(Uri)

Modifica

Imposta l'immagine visualizzata nella parte superiore di una notifica dell'app, occupando tutta la larghezza della notifica.

public:
 virtual AppNotificationBuilder ^ SetHeroImage(Uri ^ imageUri) = SetHeroImage;
/// [Windows.Foundation.Metadata.Overload("SetHeroImage")]
AppNotificationBuilder SetHeroImage(Uri const& imageUri);
[Windows.Foundation.Metadata.Overload("SetHeroImage")]
public AppNotificationBuilder SetHeroImage(System.Uri imageUri);
function setHeroImage(imageUri)
Public Function SetHeroImage (imageUri As Uri) As AppNotificationBuilder

Parametri

imageUri
Uri Uri

URI del file di immagine hero.

Valori restituiti

AppNotificationBuilder

Restituisce il 'istanza di AppNotificationBuilder in modo che sia possibile concatenare altre chiamate al metodo.

Attributi
OverloadAttribute

Esempio

Nell'esempio seguente viene illustrata l'impostazione di un'immagine di override del logo dell'app nel payload XML per una notifica dell'app.

var notification = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetHeroImage(new Uri("ms-appx:///Images/HeroImage.png"))
    .BuildNotification();

AppNotificationManager.Default.Show(notification);

Payload XML risultante:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
            <image placement='hero' src='ms-appx:///Images/HeroImage.png'/>
        </binding>
    </visual>
</toast>

Commenti

Lo screenshot seguente illustra il posizionamento dell'immagine hero.

Screenshot di una notifica dell'app con un'immagine hero.

I tipi di file di immagine supportati includono:

  • .png
  • .jpg
  • .svg

Per indicazioni sull'uso delle API di AppNotificationBuilder per creare l'interfaccia utente per le notifiche dell'app, vedere contenuto di notifica dell'app.

Per informazioni di riferimento su XML Schema per le notifiche delle app, vedere Schema del contenuto di notifica dell'app.

Si applica a

SetHeroImage(Uri, String)

Modifica

Imposta l'immagine visualizzata nella parte superiore di una notifica dell'app, occupando tutta la larghezza della notifica, con il testo alternativo specificato.

public:
 virtual AppNotificationBuilder ^ SetHeroImage(Uri ^ imageUri, Platform::String ^ alternateText) = SetHeroImage;
/// [Windows.Foundation.Metadata.Overload("SetHeroImage2")]
AppNotificationBuilder SetHeroImage(Uri const& imageUri, winrt::hstring const& alternateText);
[Windows.Foundation.Metadata.Overload("SetHeroImage2")]
public AppNotificationBuilder SetHeroImage(System.Uri imageUri, string alternateText);
function setHeroImage(imageUri, alternateText)
Public Function SetHeroImage (imageUri As Uri, alternateText As String) As AppNotificationBuilder

Parametri

imageUri
Uri Uri

URI del file di immagine hero.

alternateText
String

Platform::String

winrt::hstring

Stringa contenente il testo alternativo per l'immagine hero.

Valori restituiti

AppNotificationBuilder

Restituisce il 'istanza di AppNotificationBuilder in modo che sia possibile concatenare altre chiamate al metodo.

Attributi
OverloadAttribute

Esempio

Nell'esempio seguente viene illustrata l'impostazione di un'immagine di override del logo dell'app nel payload XML per una notifica dell'app.

var notification = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetHeroImage(new Uri("ms-appx:///Images/HeroImage.png"), "Alternate text")
    .BuildNotification();

AppNotificationManager.Default.Show(notification);

Payload XML risultante:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
            <image placement='hero' src='ms-appx:///Images/HeroImage.png'/>
        </binding>
    </visual>
</toast>

Commenti

Lo screenshot seguente illustra il posizionamento dell'immagine hero.

Screenshot di una notifica dell'app con un'immagine hero.

I tipi di file di immagine supportati includono:

  • .png
  • .jpg
  • .svg

Per indicazioni sull'uso delle API di AppNotificationBuilder per creare l'interfaccia utente per le notifiche dell'app, vedere contenuto di notifica dell'app.

Per informazioni di riferimento su XML Schema per le notifiche delle app, vedere Schema del contenuto di notifica dell'app.

Si applica a