AppNotificationBuilder.SetAppLogoOverride 方法

定義

命名空間:: Microsoft.Windows.AppNotifications.Builder

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

名稱	Description
SetAppLogoOverride(Uri, AppNotificationImageCrop)	透過指定的裁切方法，設定顯示在應用程式通知左側的圖片。
SetAppLogoOverride(Uri, AppNotificationImageCrop, String)	透過指定的裁切方法和替代文字，設定顯示在應用程式通知左側的圖片。
SetAppLogoOverride(Uri)	設定顯示在應用程式通知左側的圖片。

SetAppLogoOverride(Uri, AppNotificationImageCrop)

編輯

透過指定的裁切方法，設定顯示在應用程式通知左側的圖片。

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

參數

imageUri: Uri Uri

應用程式標誌的 URI 會覆蓋圖片檔案。

imageCrop: AppNotificationImageCrop

AppNotificationImageCrop 列舉中的一位成員，指定了裁切方法。

傳回

AppNotificationBuilder

傳回 AppNotificationBuilder 實例，以便鏈結其他方法呼叫。

屬性: OverloadAttribute

範例

以下範例示範如何設定應用程式標誌覆蓋 XML 有效載荷的應用程式通知。

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

AppNotificationManager.Default.Show(notification);

產生的 XML 承載：

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

備註

以下截圖展示了 Circle 裁切法下應用程式標誌覆蓋圖片的位置。

一張應用程式通知截圖，圖片被裁切成圓形。

支援的影像檔案類型包括：

.png
.jpg
.svg

如需使用 AppNotificationBuilder API 來建立應用程式通知 UI 的指引，請參閱應用程式通知內容。

如需應用程式通知 XML 架構的參考資訊，請參閱應用程式通知內容架構。

適用於

SetAppLogoOverride(Uri, AppNotificationImageCrop, String)

編輯

透過指定的裁切方法和替代文字，設定顯示在應用程式通知左側的圖片。

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

參數

imageUri: Uri Uri

應用程式標誌的 URI 會覆蓋圖片檔案。

imageCrop: AppNotificationImageCrop

AppNotificationImageCrop 列舉中的一位成員，指定了裁切方法。

alternateText: String
Platform::String

winrt::hstring

包含應用程式標誌覆蓋圖片的替代文字的字串。

傳回

AppNotificationBuilder

傳回 AppNotificationBuilder 實例，以便鏈結其他方法呼叫。

屬性: OverloadAttribute

範例

以下範例示範如何在 XML payload 中設定應用程式標誌覆蓋影像，用於應用程式通知。

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

AppNotificationManager.Default.Show(notification);

產生的 XML 承載：

<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>

備註

以下截圖展示了 Circle 裁切法下應用程式標誌覆蓋圖片的位置。

一張應用程式通知截圖，圖片被裁切成圓形

支援的影像檔案類型包括：

.png
.jpg
.svg

如需使用 AppNotificationBuilder API 來建立應用程式通知 UI 的指引，請參閱應用程式通知內容。

如需應用程式通知 XML 架構的參考資訊，請參閱應用程式通知內容架構。

適用於

SetAppLogoOverride(Uri)

編輯

設定顯示在應用程式通知左側的圖片。

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

參數

imageUri: Uri Uri

應用程式標誌的 URI 會覆蓋圖片檔案。

傳回

AppNotificationBuilder

傳回 AppNotificationBuilder 實例，以便鏈結其他方法呼叫。

屬性: OverloadAttribute

範例

以下範例示範如何在 XML payload 中設定應用程式標誌覆蓋影像，用於應用程式通知。

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

AppNotificationManager.Default.Show(notification);

產生的 XML 承載：

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

備註

以下截圖展示了應用程式標誌覆蓋圖片的位置。

一張應用程式通知截圖，搭配應用程式標誌覆蓋圖片。

支援的影像檔案類型包括：

.png
.jpg
.svg

如需使用 AppNotificationBuilder API 來建立應用程式通知 UI 的指引，請參閱應用程式通知內容。

如需應用程式通知 XML 架構的參考資訊，請參閱應用程式通知內容架構。

適用於

意見反應

此頁面對您有幫助嗎？