AppNotificationBuilder.SetHeroImage 메서드

정의

네임스페이스:

Microsoft.Windows.AppNotifications.Builder

오버로드

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

Hero 이미지 파일의 URI입니다.

반환

AppNotificationBuilder

추가 메서드 호출을 연결할 수 있도록 AppNotificationBuilder 인스턴스를 반환합니다.

특성

OverloadAttribute

예제

다음 예제에서는 앱 알림에 대한 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>

설명

다음 스크린샷은 Hero 이미지의 배치를 보여 줍니다.

지원되는 이미지 파일 형식은 다음과 같습니다.

• .png
• .jpg
• .svg

AppNotificationBuilder API를 사용하여 앱 알림에 대한 UI를 만드는 방법에 대한 지침은 앱 알림 콘텐츠참조하세요.

앱 알림에 대한 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

Hero 이미지 파일의 URI입니다.

alternateText

String

Platform::String

winrt::hstring

Hero 이미지의 대체 텍스트를 포함하는 문자열입니다.

반환

AppNotificationBuilder

추가 메서드 호출을 연결할 수 있도록 AppNotificationBuilder 인스턴스를 반환합니다.

특성

OverloadAttribute

예제

다음 예제에서는 앱 알림에 대한 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>

설명

다음 스크린샷은 Hero 이미지의 배치를 보여 줍니다.

지원되는 이미지 파일 형식은 다음과 같습니다.

• .png
• .jpg
• .svg

AppNotificationBuilder API를 사용하여 앱 알림에 대한 UI를 만드는 방법에 대한 지침은 앱 알림 콘텐츠참조하세요.

앱 알림에 대한 XML 스키마에 대한 참조 정보는 앱 알림 콘텐츠 스키마참조하세요.