다음을 통해 공유


image(Toast XML 스키마)

알림 템플릿에 사용되는 이미지를 지정합니다.

요소 계층 구조

<토스트>
<시각>
<binding>
<이미지>

Syntax

<image id             = integer
       src            = string
       alt?           = string
       addImageQuery? = boolean 
       placement? = "appLogoOverride" | "hero"
       hint-crop? = "circle" />

? 선택 사항(0개 또는 1개)

특성 및 요소

특성

attribute Description 데이터 형식 필수 기본값
addImageQuery

Windows가 알림 메시지에 제공된 이미지 URI에 쿼리 문자열을 추가할 수 있도록 하려면 "true"로 설정합니다. 서버에서 이미지를 호스트하고, 쿼리 문자열을 기반으로 이미지 변형을 검색하거나 쿼리 문자열을 무시하고 쿼리 문자열 없이 지정된 이미지를 반환하여 쿼리 문자열을 처리할 수 있는 경우 이 특성을 사용합니다. 이 쿼리 문자열은 크기 조정, 대비 설정 및 언어를 지정합니다. 의 값인 instance

"www.website.com/images/hello.png"

알림에 지정된 가 됩니다.

"www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

boolean false
alt

보조 기술 사용자를 위한 이미지에 대한 설명입니다.

문자열 None
id

이 이미지가 의도한 알림 템플릿의 이미지 요소입니다. 템플릿에 이미지가 하나만 있는 경우 이 값은 1입니다. 사용 가능한 이미지 위치 수는 템플릿 정의를 기반으로 합니다.

integer 없음
src

다음 프로토콜 처리기 중 하나를 사용하는 이미지 원본의 URI입니다.

  • http:// 또는 https://

    웹 기반 이미지입니다.

  • ms-appx:///

    앱 패키지에 포함된 이미지입니다.

  • ms-appdata:///local/

    로컬 스토리지에 저장된 이미지입니다.

  • 파일:///

    로컬 이미지입니다. (데스크톱 앱에 대해서만 지원됩니다. 이 프로토콜은 UWP 앱에서 사용할 수 없습니다.)

문자열 없음
배치

이미지의 배치입니다.

  • "appLogoOverride" - 이미지는 알림 메시지에서 앱의 로고를 대체합니다.
  • "hero" - 이미지가 영웅 이미지로 표시됩니다.

자세한 내용은 알림 콘텐츠를 참조하세요.

문자열 None
힌트 자르기

이미지 자르기입니다.

  • "circle" - 이미지가 원으로 잘립니다.
  • 지정되지 않음 - 이미지가 잘리고 정사각형으로 표시되지 않습니다.

자세한 내용은 알림 콘텐츠를 참조하세요.

문자열 None

 

자식 요소

없음

부모 요소

부모 요소 Description
binding

알림 템플릿을 지정합니다. 하나의 바인딩 요소만 알림 메시지에 포함할 수 있습니다.

추가 정보