AppNotificationBuilder.SetAppLogoOverride Methode

Definition

Namespace:

Microsoft.Windows.AppNotifications.Builder

Überlädt

SetAppLogoOverride(Uri)	Legt das Bild fest, das auf der linken Seite einer App-Benachrichtigung angezeigt wird.
SetAppLogoOverride(Uri, AppNotificationImageCrop)	Legt das Bild fest, das auf der linken Seite einer App-Benachrichtigung mit der angegebenen Zuschneidemethode angezeigt wird.
SetAppLogoOverride(Uri, AppNotificationImageCrop, String)	Legt das Bild fest, das auf der linken Seite einer App-Benachrichtigung mit der angegebenen Zuschneidemethode und alternativen Text angezeigt wird.

SetAppLogoOverride(Uri)

Legt das Bild fest, das auf der linken Seite einer App-Benachrichtigung angezeigt wird.

public:
 virtual AppNotificationBuilder ^ SetAppLogoOverride(Uri ^ imageUri) = SetAppLogoOverride;

/// [Windows.Foundation.Metadata.Overload("SetAppLogoOverride")]
AppNotificationBuilder SetAppLogoOverride(Uri const& imageUri);

[Windows.Foundation.Metadata.Overload("SetAppLogoOverride")]
public AppNotificationBuilder SetAppLogoOverride(System.Uri imageUri);

function setAppLogoOverride(imageUri)

Public Function SetAppLogoOverride (imageUri As Uri) As AppNotificationBuilder

Parameter

imageUri

Uri Uri

Der URI der App-Logo-Überschreibungsbilddatei.

Gibt zurück

AppNotificationBuilder

Gibt die AppNotificationBuilder- Instanz zurück, sodass zusätzliche Methodenaufrufe verkettet werden können.

Attribute

OverloadAttribute

Beispiele

Das folgende Beispiel veranschaulicht das Festlegen eines Bilds zum Außerkraftsetzen eines App-Logos in der XML-Nutzlast für eine App-Benachrichtigung.

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

AppNotificationManager.Default.Show(notification);

Die resultierende XML-Nutzlast:

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

Hinweise

Der folgende Screenshot veranschaulicht die Platzierung des Bilds zum Außerkraftsetzen des App-Logos.

Zu den unterstützten Bilddateitypen gehören:

• .png
• .jpg
• .svg

Anleitungen zur Verwendung der AppNotificationBuilder--APIs zum Erstellen der Benutzeroberfläche für App-Benachrichtigungen finden Sie unter App-Benachrichtigungsinhalt.

Referenzinformationen zum XML-Schema für App-Benachrichtigungen finden Sie unter App-Benachrichtigungsinhaltsschema.

SetAppLogoOverride(Uri, AppNotificationImageCrop)

Legt das Bild fest, das auf der linken Seite einer App-Benachrichtigung mit der angegebenen Zuschneidemethode angezeigt wird.

public:
 virtual AppNotificationBuilder ^ SetAppLogoOverride(Uri ^ imageUri, AppNotificationImageCrop imageCrop) = SetAppLogoOverride;

/// [Windows.Foundation.Metadata.Overload("SetAppLogoOverride2")]
AppNotificationBuilder SetAppLogoOverride(Uri const& imageUri, AppNotificationImageCrop const& imageCrop);

[Windows.Foundation.Metadata.Overload("SetAppLogoOverride2")]
public AppNotificationBuilder SetAppLogoOverride(System.Uri imageUri, AppNotificationImageCrop imageCrop);

function setAppLogoOverride(imageUri, imageCrop)

Public Function SetAppLogoOverride (imageUri As Uri, imageCrop As AppNotificationImageCrop) As AppNotificationBuilder

Parameter

imageUri

Uri Uri

Der URI der App-Logo-Überschreibungsbilddatei.

imageCrop

AppNotificationImageCrop

Ein Element der AppNotificationImageCrop Enumeration, die die Zuschneidemethode angibt.

Gibt zurück

AppNotificationBuilder

Gibt die AppNotificationBuilder- Instanz zurück, sodass zusätzliche Methodenaufrufe verkettet werden können.

Attribute

OverloadAttribute

Beispiele

Das folgende Beispiel veranschaulicht das Festlegen eines App-Logos, das das XML-Nutzlast für eine App-Benachrichtigung außer Kraft setzt.

var notification = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetAppLogoOverride(new Uri("ms-appx:///Images/AppLogo.png"), AppNotificationImageCrop.Circle)
    .BuildNotification();

AppNotificationManager.Default.Show(notification);

Die resultierende XML-Nutzlast:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
            <image placement='appLogoOverride' src='ms-appx:///Images/AppLogo.png' hint-crop='circle'/>
        </binding>
    </visual>
</toast>

Hinweise

Der folgende Screenshot veranschaulicht die Platzierung des Bilds zum Überschreiben des App-Logos mit der Circle Cropping-Methode.

Zu den unterstützten Bilddateitypen gehören:

• .png
• .jpg
• .svg

Anleitungen zur Verwendung der AppNotificationBuilder--APIs zum Erstellen der Benutzeroberfläche für App-Benachrichtigungen finden Sie unter App-Benachrichtigungsinhalt.

Referenzinformationen zum XML-Schema für App-Benachrichtigungen finden Sie unter App-Benachrichtigungsinhaltsschema.

SetAppLogoOverride(Uri, AppNotificationImageCrop, String)

Legt das Bild fest, das auf der linken Seite einer App-Benachrichtigung mit der angegebenen Zuschneidemethode und alternativen Text angezeigt wird.

public:
 virtual AppNotificationBuilder ^ SetAppLogoOverride(Uri ^ imageUri, AppNotificationImageCrop imageCrop, Platform::String ^ alternateText) = SetAppLogoOverride;

/// [Windows.Foundation.Metadata.Overload("SetAppLogoOverride3")]
AppNotificationBuilder SetAppLogoOverride(Uri const& imageUri, AppNotificationImageCrop const& imageCrop, winrt::hstring const& alternateText);

[Windows.Foundation.Metadata.Overload("SetAppLogoOverride3")]
public AppNotificationBuilder SetAppLogoOverride(System.Uri imageUri, AppNotificationImageCrop imageCrop, string alternateText);

function setAppLogoOverride(imageUri, imageCrop, alternateText)

Public Function SetAppLogoOverride (imageUri As Uri, imageCrop As AppNotificationImageCrop, alternateText As String) As AppNotificationBuilder

Parameter

imageUri

Uri Uri

Der URI der App-Logo-Überschreibungsbilddatei.

imageCrop

AppNotificationImageCrop

Ein Element der AppNotificationImageCrop Enumeration, die die Zuschneidemethode angibt.

alternateText

String

Platform::String

winrt::hstring

Eine Zeichenfolge mit dem alternativen Text für das App-Logo überschreibt das Bild.

Gibt zurück

AppNotificationBuilder

Gibt die AppNotificationBuilder- Instanz zurück, sodass zusätzliche Methodenaufrufe verkettet werden können.

Attribute

OverloadAttribute

Beispiele

Das folgende Beispiel veranschaulicht das Festlegen eines Bilds zum Außerkraftsetzen eines App-Logos in der XML-Nutzlast für eine App-Benachrichtigung.

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

AppNotificationManager.Default.Show(notification);

Die resultierende XML-Nutzlast:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
            <image placement='appLogoOverride' src='ms-appx:///Images/AppLogo.png' alt='Alternate text' hint-crop='circle'/>
        </binding>
    </visual>
</toast>

Hinweise

Der folgende Screenshot veranschaulicht die Platzierung des Bilds zum Überschreiben des App-Logos mit der Circle Cropping-Methode.

Zu den unterstützten Bilddateitypen gehören:

• .png
• .jpg
• .svg

Anleitungen zur Verwendung der AppNotificationBuilder--APIs zum Erstellen der Benutzeroberfläche für App-Benachrichtigungen finden Sie unter App-Benachrichtigungsinhalt.

Referenzinformationen zum XML-Schema für App-Benachrichtigungen finden Sie unter App-Benachrichtigungsinhaltsschema.