语言

AppNotificationBuilder.SetInlineImage 方法

定义

重载

名称 说明
SetInlineImage(Uri)

设置在任意文本元素之后内联显示的图像,并在应用通知中填充视觉区域的完整宽度。

SetInlineImage(Uri, AppNotificationImageCrop)

使用指定的裁剪行为设置内联显示的图像(在任何文本元素之后)填充应用通知中视觉区域的完整宽度。

SetInlineImage(Uri, AppNotificationImageCrop, String)

使用指定的裁剪行为设置内联显示的图像(在任何文本元素之后)填充应用通知中视觉区域的完整宽度。

SetInlineImage(Uri)

设置在任意文本元素之后内联显示的图像,并在应用通知中填充视觉区域的完整宽度。

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

参数

imageUri
Uri Uri

内联图像文件的 URI。

返回

返回 AppNotificationBuilder 实例,以便可以链接其他方法调用。

属性

示例

以下示例演示如何在应用通知的 XML 有效负载中设置内联图像。

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

AppNotificationManager.Default.Show(notification);

生成的 XML 有效负载:

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

注解

以下屏幕截图演示了内联图像的位置。

包含内联图像的应用通知的屏幕截图。

支持的映像文件类型包括:

  • .png
  • .jpg
  • .svg

有关使用 AppNotificationBuilder API 创建应用通知的 UI 的指导,请参阅 应用通知内容。

有关应用通知的 XML 架构的参考信息,请参阅 应用通知内容架构。

适用于

SetInlineImage(Uri, AppNotificationImageCrop)

使用指定的裁剪行为设置内联显示的图像(在任何文本元素之后)填充应用通知中视觉区域的完整宽度。

public:
 virtual AppNotificationBuilder ^ SetInlineImage(Uri ^ imageUri, AppNotificationImageCrop imageCrop) = SetInlineImage;
/// [Windows.Foundation.Metadata.Overload("SetInlineImage2")]
AppNotificationBuilder SetInlineImage(Uri const& imageUri, AppNotificationImageCrop const& imageCrop);
[Windows.Foundation.Metadata.Overload("SetInlineImage2")]
public AppNotificationBuilder SetInlineImage(System.Uri imageUri, AppNotificationImageCrop imageCrop);
function setInlineImage(imageUri, imageCrop)
Public Function SetInlineImage (imageUri As Uri, imageCrop As AppNotificationImageCrop) As AppNotificationBuilder

参数

imageUri
Uri Uri

内联图像文件的 URI。

imageCrop
AppNotificationImageCrop

指定裁剪方法的 AppNotificationImageCrop 枚举的成员。

返回

返回 AppNotificationBuilder 实例,以便可以链接其他方法调用。

属性

示例

以下示例演示如何在应用通知的 XML 有效负载中设置内联图像。

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

AppNotificationManager.Default.Show(notification);

生成的 XML 有效负载:

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

注解

以下屏幕截图演示了内联图像的位置。

包含内联图像的应用通知的屏幕截图。

支持的映像文件类型包括:

  • .png
  • .jpg
  • .svg

有关使用 AppNotificationBuilder API 创建应用通知的 UI 的指导,请参阅 应用通知内容。

有关应用通知的 XML 架构的参考信息,请参阅 应用通知内容架构。

适用于

SetInlineImage(Uri, AppNotificationImageCrop, String)

使用指定的裁剪行为设置内联显示的图像(在任何文本元素之后)填充应用通知中视觉区域的完整宽度。

public:
 virtual AppNotificationBuilder ^ SetInlineImage(Uri ^ imageUri, AppNotificationImageCrop imagecrop, Platform::String ^ alternateText) = SetInlineImage;
/// [Windows.Foundation.Metadata.Overload("SetInlineImage3")]
AppNotificationBuilder SetInlineImage(Uri const& imageUri, AppNotificationImageCrop const& imagecrop, winrt::hstring const& alternateText);
[Windows.Foundation.Metadata.Overload("SetInlineImage3")]
public AppNotificationBuilder SetInlineImage(System.Uri imageUri, AppNotificationImageCrop imagecrop, string alternateText);
function setInlineImage(imageUri, imagecrop, alternateText)
Public Function SetInlineImage (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 实例,以便可以链接其他方法调用。

属性

示例

以下示例演示如何在应用通知的 XML 有效负载中设置内联图像。

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

AppNotificationManager.Default.Show(notification);

生成的 XML 有效负载:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
            <image src='ms-appx:///Images/InlineImage.png' alt='Alternate text'/>
        </binding>
    </visual>
</toast>

注解

以下屏幕截图演示了内联图像的位置。

包含内联图像的应用通知的屏幕截图。

支持的映像文件类型包括:

  • .png
  • .jpg
  • .svg

有关使用 AppNotificationBuilder API 创建应用通知的 UI 的指导,请参阅 应用通知内容。

有关应用通知的 XML 架构的参考信息,请参阅 应用通知内容架构。

适用于