Поделиться через


AppNotificationBuilder.SetHeroImage Метод

Определение

Перегрузки

SetHeroImage(Uri)

Задает изображение, отображаемое в верхней части уведомления приложения, которое занимает полную ширину уведомления.

SetHeroImage(Uri, String)

Задает изображение, отображаемое в верхней части уведомления приложения, которое занимает полную ширину уведомления с указанным альтернативным текстом.

SetHeroImage(Uri)

Задает изображение, отображаемое в верхней части уведомления приложения, которое занимает полную ширину уведомления.

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

Параметры

imageUri
Uri Uri

Универсальный код ресурса (URI) файла изображения героя.

Возвращаемое значение

Возвращает экземпляр AppNotificationBuilder, чтобы можно было связать дополнительные вызовы методов.

Атрибуты

Примеры

В следующем примере показано, как настроить изображение логотипа приложения переопределение изображения в полезных данных XML для уведомления приложения.

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

AppNotificationManager.Default.Show(notification);

Результирующая полезные данные XML:

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

Комментарии

На следующем снимках экрана показано размещение изображения героя.

Снимок экрана с уведомлением приложения с изображением героя.

Поддерживаемые типы файлов изображений включают:

  • .png
  • .jpg
  • .svg

Инструкции по использованию API AppNotificationBuilder для создания пользовательского интерфейса для уведомлений приложений см. в содержимомуведомлений приложений.

Справочные сведения о схеме XML для уведомлений приложений см. в схеме содержимого уведомления приложения.

Применяется к

SetHeroImage(Uri, String)

Задает изображение, отображаемое в верхней части уведомления приложения, которое занимает полную ширину уведомления с указанным альтернативным текстом.

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

Параметры

imageUri
Uri Uri

Универсальный код ресурса (URI) файла изображения героя.

alternateText
String

Platform::String

winrt::hstring

Строка, содержащая альтернативный текст для изображения героя.

Возвращаемое значение

Возвращает экземпляр AppNotificationBuilder, чтобы можно было связать дополнительные вызовы методов.

Атрибуты

Примеры

В следующем примере показано, как настроить изображение логотипа приложения переопределение изображения в полезных данных XML для уведомления приложения.

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

AppNotificationManager.Default.Show(notification);

Результирующая полезные данные XML:

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

Комментарии

На следующем снимках экрана показано размещение изображения героя.

Снимок экрана с уведомлением приложения с изображением героя.

Поддерживаемые типы файлов изображений включают:

  • .png
  • .jpg
  • .svg

Инструкции по использованию API AppNotificationBuilder для создания пользовательского интерфейса для уведомлений приложений см. в содержимомуведомлений приложений.

Справочные сведения о схеме XML для уведомлений приложений см. в схеме содержимого уведомления приложения.

Применяется к