다음을 통해 공유

토스트 콘텐츠 스키마

다음은 토스트 메시지 내용 내의 모든 속성 및 요소에 대해 설명합니다.

알림 라이브러리 대신 원시 XML을 사용하려는 경우 XML 스키마를 참조하세요.

ToastContent

ToastContent

ToastContent는 시각적 개체, 작업 및 오디오를 포함하여 알림의 콘텐츠를 설명하는 최상위 개체입니다.

Property Type Required Description
Launch string false 알림(Toast)에 의해 활성화될 때 애플리케이션에 전달되는 문자열입니다. 이 문자열의 형식과 콘텐츠는 앱에서 자체적으로 사용하기 위해 정의합니다. 사용자가 알림을 탭하거나 클릭하여 연결된 앱을 시작하면 시작 문자열은 기본 방식으로 시작하는 대신 사용자에게 알림 콘텐츠와 관련된 보기를 표시할 수 있는 컨텍스트를 앱에 제공합니다.
Visual ToastVisual true 토스트 알림의 시각적 부분을 설명합니다.
Actions IToastActions false 필요에 따라 단추 및 입력을 사용하여 사용자 지정 작업을 만듭니다.
Audio ToastAudio false 알림 메시지의 오디오 부분을 설명합니다.
ActivationType ToastActivationType false 사용자가 이 Toast 알림의 바디를 클릭할 때 사용할 활성화 유형을 지정합니다.
ActivationOptions ToastActivationOptions false 크리에이터 업데이트의 새로운 기능: 토스트 알림 활성화와 관련된 추가 옵션.
Scenario ToastScenario false 이 토스트 알림이 사용되는 시나리오(예: 알람 또는 미리 알림)를 선언합니다.
DisplayTimestamp DateTimeOffset? false 크리에이터 업데이트의 새로운 기능: 기본 타임스탬프를 재정의하여, 알림 콘텐츠가 실제로 전달된 시간을 나타내는 사용자 지정 타임스탬프로 설정하세요. 이는 알림이 Windows 플랫폼에서 수신된 시간이 아니라 실제 전달된 시간을 기반으로 합니다.
Header ToastHeader false 크리에이터스 업데이트의 새로운 기능: 알림에 사용자 지정 헤더를 추가하여 알림 센터 내에서 여러 알림을 그룹화합니다.

ToastScenario

토스트 알림이 나타내는 시나리오를 지정합니다.

Value Meaning
Default 일반적인 토스트 동작입니다.
Reminder 미리 알림입니다. 미리 확장된 상태로 표시되며 해제될 때까지 사용자의 화면에 유지됩니다.
Alarm 경보 알림입니다. 미리 확장된 상태로 표시되며 해제될 때까지 사용자의 화면에 유지됩니다. 오디오는 기본적으로 반복되며 알람 오디오를 사용합니다.
IncomingCall 수신 전화 알림입니다. 이는 사용자 화면에 특수한 호출 형식으로 사전 확장된 상태로 표시되며, 사용자가 해제할 때까지 유지됩니다. 오디오는 기본적으로 반복되며 벨소리 오디오를 사용합니다.

ToastVisual

알림의 시각적 부분에는 텍스트, 이미지, 적응 콘텐츠 등이 포함된 바인딩이 포함되어 있습니다.

Property Type Required Description
BindingGeneric ToastBindingGeneric true 모든 디바이스에서 렌더링할 수 있는 일반적인 토스트 바인딩입니다. 이 바인딩은 필수이며 null일 수 없습니다.
BaseUri Uri false 이미지 소스 속성의 상대 URL과 결합되는 기본 URL입니다.
AddImageQuery bool? false Windows에서 알림 메시지에 제공된 이미지 URL에 쿼리 문자열을 추가할 수 있도록 하려면 "true"로 설정합니다. 서버에서 이미지를 호스트하고 쿼리 문자열을 기반으로 이미지 변형을 검색하거나 쿼리 문자열을 무시하고 쿼리 문자열 없이 지정된 대로 이미지를 반환하여 쿼리 문자열을 처리할 수 있는 경우 이 특성을 사용합니다. 이 쿼리 문자열은 배율, 대비 설정 및 언어를 지정합니다. 예를 들어 알림에 지정된 "www.website.com/images/hello.png" 값은 "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"가 됩니다.
Language string false 지역화된 리소스를 사용하는 경우 시각적 페이로드의 대상 로캘로, "en-US" 또는 "fr-FR"와 같은 BCP-47 언어 태그로 지정됩니다. 바인딩이나 텍스트에 지정된 로캘이 있을 경우, 이 로캘은 해당 로캘에 의해 재정의됩니다. 제공되지 않으면 시스템 로캘이 대신 사용됩니다.

ToastBindingGeneric

제네릭 바인딩은 토스트의 기본 바인딩이며, 텍스트, 이미지, 적응형 콘텐츠 등을 지정하는 장소입니다.

Property Type Required Description
Children IList<IToastBindingGenericChild> false 텍스트, 이미지 및 그룹을 포함할 수 있는 알림 본문의 내용입니다(1주년 업데이트에 추가됨). 텍스트 요소는 다른 요소 앞에 와야 하며 3개의 텍스트 요소만 지원됩니다. 텍스트 요소가 다른 요소 뒤에 배치되면 위쪽으로 이동되거나 제거됩니다. 마지막으로 HintStyle과 같은 특정 텍스트 속성은 루트 자식 텍스트 요소에서 지원되지 않으며 AdaptiveSubgroup 내에서만 작동합니다. 1주년 업데이트 없이 디바이스에서 AdaptiveGroup을 사용하는 경우 그룹 콘텐츠는 삭제됩니다.
AppLogoOverride ToastGenericAppLogo false 앱 로고를 재정의할 선택적 로고입니다.
HeroImage ToastGenericHeroImage false 알림 및 알림 센터 내에 표시되는 선택적 추천 "hero" 이미지입니다.
Attribution ToastGenericAttributionText false 알림 메시지 아래쪽에 표시되는 선택적 출처 텍스트입니다.
BaseUri Uri false 이미지 소스 속성의 상대 URL과 결합되는 기본 URL입니다.
AddImageQuery bool? false Windows에서 알림 메시지에 제공된 이미지 URL에 쿼리 문자열을 추가할 수 있도록 하려면 "true"로 설정합니다. 서버에서 이미지를 호스트하고 쿼리 문자열을 기반으로 이미지 변형을 검색하거나 쿼리 문자열을 무시하고 쿼리 문자열 없이 지정된 대로 이미지를 반환하여 쿼리 문자열을 처리할 수 있는 경우 이 특성을 사용합니다. 이 쿼리 문자열은 배율, 대비 설정 및 언어를 지정합니다. 예를 들어 알림에 지정된 "www.website.com/images/hello.png" 값은 "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"가 됩니다.
Language string false 지역화된 리소스를 사용하는 경우 시각적 페이로드의 대상 로캘로, "en-US" 또는 "fr-FR"와 같은 BCP-47 언어 태그로 지정됩니다. 바인딩이나 텍스트에 지정된 로캘이 있을 경우, 이 로캘은 해당 로캘에 의해 재정의됩니다. 제공되지 않으면 시스템 로캘이 대신 사용됩니다.

IToastBindingGenericChild

텍스트, 이미지, 그룹 등을 포함하는 토스트 알림의 자식 요소에 대한 표식 인터페이스입니다.

Implementations
AdaptiveText
AdaptiveImage
AdaptiveGroup
AdaptiveProgressBar

AdaptiveText

적응형 텍스트 요소입니다. 최상위 수준 ToastBindingGeneric.Children에 배치되는 경우 HintMaxLines만 적용됩니다. 그러나 그룹/하위 그룹의 자식으로 배치되는 경우 전체 텍스트 스타일이 지원됩니다.

Property Type Required Description
Text 문자열 또는 바인더블스트링 false 표시할 텍스트입니다. 데이터 바인딩 지원은 크리에이터스 업데이트에 추가되었지만 최상위 텍스트 요소에 대해서만 작동합니다.
HintStyle AdaptiveTextStyle false 이 스타일은 텍스트의 글꼴 크기, 두께 및 불투명도를 제어합니다. 그룹/하위 그룹 내의 텍스트 요소에 대해서만 작동합니다.
HintWrap bool? false 텍스트 줄 바꿈을 사용하려면 이를 true로 설정하십시오. 최상위 텍스트 요소는 이 속성을 무시하고 항상 래핑합니다(HintMaxLines = 1을 사용하여 최상위 텍스트 요소에 대한 래핑을 사용하지 않도록 설정할 수 있습니다). 그룹/하위 그룹 내의 텍스트 요소는 래핑에 대해 기본적으로 false로 설정됩니다.
HintMaxLines int? false 텍스트 요소가 표시할 수 있는 최대 줄 수입니다.
HintMinLines int? false 텍스트 요소가 표시해야 하는 최소 줄 수입니다. 그룹/하위 그룹 내의 텍스트 요소에 대해서만 작동합니다.
HintAlign AdaptiveTextAlign false 텍스트의 가로 정렬입니다. 그룹/하위 그룹 내의 텍스트 요소에 대해서만 작동합니다.
Language string false "en-US" 또는 "fr-FR"와 같은 BCP-47 언어 태그로 지정된 XML 페이로드의 대상 로캘입니다. 여기에 지정된 로캘은 바인딩이나 시각적 설정에 지정된 다른 로캘을 무시합니다. 이 값이 리터럴 문자열인 경우 이 특성은 기본적으로 사용자의 UI 언어로 설정됩니다. 이 값이 문자열 참조인 경우 이 특성은 기본적으로 문자열을 확인할 때 Windows 런타임에서 선택한 로캘로 설정됩니다.

BindableString

문자열에 대한 바인딩 값입니다.

Property Type Required Description
BindingName string true 바인딩 데이터 값에 매핑되는 이름을 가져오거나 설정합니다.

AdaptiveTextStyle

텍스트 스타일은 글꼴 크기, 두께 및 불투명도를 제어합니다. 미묘한 불투명도는 60% 불투명합니다.

Value Meaning
Default 기본값입니다. 스타일은 렌더러에 의해 결정됩니다.
Caption 단락 글꼴 크기보다 작습니다.
CaptionSubtle 캡션과 같지만, 불투명도가 약간 있습니다.
Body 단락 글꼴 크기
BodySubtle 본체와 같되 불투명도가 미묘합니다.
Base 단락 글꼴 크기, 굵은 두께 본질적으로 본문의 굵은 버전입니다.
BaseSubtle 기준과 동일하지만 불투명도가 미묘하게 다릅니다.
Subtitle 글꼴 크기 H4입니다.
SubtitleSubtle 부제와 동일하지만 약간의 투명도가 있는 상태입니다.
Title H3 글꼴 크기
TitleSubtle 제목과 동일하지만 불투명도가 미묘합니다.
TitleNumeral 제목과 동일하지만 위쪽/아래쪽 안쪽 여백이 제거되었습니다.
하위 헤더 H2 글꼴 크기입니다.
SubheaderSubtle 서브헤더와 동일하지만 불투명도가 미묘합니다.
SubheaderNumeral 하위 헤더와 동일하지만 위쪽/아래쪽 안쪽 여백이 제거되었습니다.
Header H1 글꼴 크기
HeaderSubtle 헤더와 동일하지만 미묘한 불투명도가 있습니다.
HeaderNumeral 헤더와 동일하지만 위쪽/아래쪽 안쪽 여백이 제거되었습니다.

AdaptiveTextAlign

텍스트의 가로 맞춤을 제어합니다.

Value Meaning
Default 기본값입니다. 맞춤은 렌더러에 의해 자동으로 결정됩니다.
Auto 현재 언어와 문화에 따라 결정되는 정렬입니다.
Left 텍스트를 왼쪽으로 정렬하세요.
Center 가운데에 있는 텍스트를 가로로 맞춥다.
Right 텍스트를 오른쪽으로 정렬합니다.

AdaptiveImage

인라인 이미지입니다.

Property Type Required Description
Source string true 이미지의 URL입니다. ms-appx, ms-appdata 및 http가 지원됩니다. Fall Creators Update를 기준으로 웹 이미지는 일반 연결에서 최대 3MB, 요금제 연결의 경우 1MB가 될 수 있습니다. 아직 Fall Creators Update를 실행하지 않는 디바이스에서는 웹 이미지가 200KB 이하여야 합니다.
HintCrop AdaptiveImageCrop false 1주년 업데이트의 새로운 기능: 이미지의 원하는 자르기를 제어합니다.
HintRemoveMargin bool? false 기본적으로 그룹/하위 그룹 내의 이미지는 주위에 8px 여백이 있습니다. 이 속성을 true로 설정하여 이 여백을 제거할 수 있습니다.
HintAlign AdaptiveImageAlign false 이미지의 가로 정렬입니다. 그룹/하위 그룹 내의 이미지에 대해서만 작동합니다.
AlternateText string false 접근성을 위해 사용되는 이미지를 설명하는 대체 텍스트입니다.
AddImageQuery bool? false Windows에서 알림 메시지에 제공된 이미지 URL에 쿼리 문자열을 추가할 수 있도록 하려면 "true"로 설정합니다. 서버에서 이미지를 호스트하고 쿼리 문자열을 기반으로 이미지 변형을 검색하거나 쿼리 문자열을 무시하고 쿼리 문자열 없이 지정된 대로 이미지를 반환하여 쿼리 문자열을 처리할 수 있는 경우 이 특성을 사용합니다. 이 쿼리 문자열은 배율, 대비 설정 및 언어를 지정합니다. 예를 들어 알림에 지정된 "www.website.com/images/hello.png" 값은 "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"가 됩니다.

AdaptiveImageCrop

이미지의 원하는 자르기를 지정합니다.

Value Meaning
Default 기본값입니다. 렌더러에 의해 결정되는 자르기 동작입니다.
None 이미지가 잘리지 않습니다.
Circle 이미지가 원 모양으로 잘립니다.

AdaptiveImageAlign

이미지의 가로 맞춤을 지정합니다.

Value Meaning
Default 기본값입니다. 정렬 동작은 렌더러에 의해 결정됩니다.
Stretch 이미지가 확장되어 사용 가능한 너비를 채웁니다(이미지가 배치되는 위치에 따라 잠재적으로 사용 가능한 높이도 포함).
Left 이미지를 왼쪽에 맞추고 기본 해상도로 표시합니다.
Center 이미지를 가로 방향으로 가운데에 맞춰 이미지를 기본 해상도로 표시합니다.
Right 이미지를 오른쪽에 배치하고, 기본 해상도로 표시합니다.

AdaptiveGroup

1주년 업데이트의 새로운 기능: 그룹은 콘텐츠가 의미상 전체적으로 표시되거나, 공간이 부족할 경우 표시되지 않아야 한다는 것을 식별합니다. 또한 그룹은 여러 열을 만들 수 있습니다.

Property Type Required Description
Children IList<AdaptiveSubgroup> false 하위 그룹은 세로 열로 표시됩니다. 하위 그룹을 사용하여 AdaptiveGroup 내의 모든 콘텐츠를 제공해야 합니다.

AdaptiveSubgroup

1주년 업데이트의 새로운 기능: 하위 그룹은 텍스트와 이미지를 포함할 수 있는 세로 열입니다.

Property Type Required Description
Children IList<IAdaptiveSubgroupChild> false AdaptiveText 및 AdaptiveImage 하위 그룹의 유효한 자식입니다.
HintWeight int? false 다른 하위 그룹을 기준으로 가중치를 지정하여 이 하위 그룹 열의 너비를 제어합니다.
HintTextStacking AdaptiveSubgroupTextStacking false 이 하위 그룹의 콘텐츠의 세로 맞춤을 제어합니다.

IAdaptiveSubgroupChild

하위 그룹 자식을 위한 마커 인터페이스입니다.

Implementations
AdaptiveText
AdaptiveImage

AdaptiveSubgroupTextStacking

TextStacking은 콘텐츠의 세로 맞춤을 지정합니다.

Value Meaning
Default 기본값입니다. 렌더러는 기본 세로 맞춤을 자동으로 선택합니다.
Top 세로 정렬을 위쪽으로 합니다.
Center 가운데로 세로 정렬하십시오.
Bottom 맨 아래로 세로 정렬합니다.

AdaptiveProgressBar

크리에이터스 업데이트의 새로운 기능: 진행률 표시줄 데스크톱의 토스트 알림에서만 지원되며, 빌드 15063 이상에서 가능합니다.

Property Type Required Description
Title 문자열 또는 바인더블스트링 false 선택적 제목 문자열을 가져오거나 설정합니다. 데이터 바인딩을 지원합니다.
Value 더블 또는 AdaptiveProgressBarValue 또는 BindableProgressBarValue false 진행률 표시줄의 값을 가져오거나 설정합니다. 데이터 바인딩을 지원합니다. 기본값은 0입니다.
ValueStringOverride 문자열 또는 바인더블스트링 false 기본 백분율 문자열 대신 표시할 선택적 문자열을 가져오거나 설정합니다. 이 정보가 제공되지 않으면 "70%"와 같은 내용이 표시됩니다.
Status 문자열 또는 바인더블스트링 true 왼쪽의 진행률 표시줄 아래에 표시되는 상태 문자열(필수)을 가져오거나 설정합니다. 이 문자열은 "다운로드 중..."처럼 작업의 상태를 반영해야 합니다. 또는 "설치 중..."

AdaptiveProgressBarValue

진행률 표시줄의 값을 나타내는 클래스입니다.

Property Type Required Description
Value double false 완료 백분율을 나타내는 값(0.0 - 1.0)을 가져오거나 설정합니다.
IsIndeterminate bool false 진행률 표시줄이 확정되지 않았는지 여부를 나타내는 값을 가져오거나 설정합니다. 만약 이것이 사실이라면, 값은 무시됩니다.

BindableProgressBarValue

바인딩 가능한 진행률 표시줄 값입니다.

Property Type Required Description
BindingName string true 바인딩 데이터 값에 매핑되는 이름을 가져오거나 설정합니다.

앱 로고 대신 표시할 로고입니다.

Property Type Required Description
Source string true 이미지의 URL입니다. ms-appx, ms-appdata 및 http가 지원됩니다. Http 이미지는 200 KB 이하이어야 합니다.
HintCrop ToastGenericAppLogoCrop false 이미지를 자르는 방법을 지정합니다.
AlternateText string false 접근성을 위해 사용되는 이미지를 설명하는 대체 텍스트입니다.
AddImageQuery bool? false Windows에서 알림 메시지에 제공된 이미지 URL에 쿼리 문자열을 추가할 수 있도록 하려면 "true"로 설정합니다. 서버에서 이미지를 호스트하고 쿼리 문자열을 기반으로 이미지 변형을 검색하거나 쿼리 문자열을 무시하고 쿼리 문자열 없이 지정된 대로 이미지를 반환하여 쿼리 문자열을 처리할 수 있는 경우 이 특성을 사용합니다. 이 쿼리 문자열은 배율, 대비 설정 및 언어를 지정합니다. 예를 들어 알림에 지정된 "www.website.com/images/hello.png" 값은 "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"가 됩니다.

ToastGenericAppLogoCrop

앱 로고 이미지의 자르기를 제어합니다.

Value Meaning
Default 자르기는 렌더러의 기본 동작을 사용합니다.
None 이미지가 잘리지 않고 사각형으로 표시됩니다.
Circle 이미지는 원형으로 잘려집니다.

ToastGenericHeroImage

알림 창 및 알림 센터에 표시되는 대표 "히어로" 이미지입니다.

Property Type Required Description
Source string true 이미지의 URL입니다. ms-appx, ms-appdata 및 http가 지원됩니다. Http 이미지는 200 KB 이하이어야 합니다.
AlternateText string false 접근성을 위해 사용되는 이미지를 설명하는 대체 텍스트입니다.
AddImageQuery bool? false Windows에서 알림 메시지에 제공된 이미지 URL에 쿼리 문자열을 추가할 수 있도록 하려면 "true"로 설정합니다. 서버에서 이미지를 호스트하고 쿼리 문자열을 기반으로 이미지 변형을 검색하거나 쿼리 문자열을 무시하고 쿼리 문자열 없이 지정된 대로 이미지를 반환하여 쿼리 문자열을 처리할 수 있는 경우 이 특성을 사용합니다. 이 쿼리 문자열은 배율, 대비 설정 및 언어를 지정합니다. 예를 들어 알림에 지정된 "www.website.com/images/hello.png" 값은 "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"가 됩니다.

ToastGenericAttributionText

알림 메시지 아래쪽에 표시되는 토스트 알림의 출처 텍스트입니다.

Property Type Required Description
Text string true 표시할 텍스트입니다.
Language string false 지역화된 리소스를 사용하는 경우 시각적 페이로드의 대상 로캘로, "en-US" 또는 "fr-FR"와 같은 BCP-47 언어 태그로 지정됩니다. 제공되지 않으면 시스템 로캘이 대신 사용됩니다.

IToastActions

토스트 작업/입력에 대한 마커 인터페이스입니다.

Implementations
ToastActionsCustom
ToastActionsSnoozeAndDismiss

ToastActionsCustom

IToastActions 구현

단추, 텍스트 상자 및 선택 입력과 같은 컨트롤을 사용하여 사용자 지정 작업 및 입력을 만듭니다.

Property Type Required Description
Inputs IList<IToastInput> false 입력란 및 선택 입력과 같은 입력입니다. 최대 5개의 입력만 허용됩니다.
Buttons IList<IToastButton> false 단추는 모든 입력 후에 표시됩니다(또는 단추가 빠른 회신 단추로 사용되는 경우 입력에 인접). 최대 5개의 단추만 허용됩니다(상황에 맞는 메뉴 항목이 있는 경우 더 적은 수).
ContextMenuItems IList<ToastContextMenuItem> false 1주년 업데이트의 새로운 기능: 사용자 지정 상황에 맞는 메뉴 항목으로, 사용자가 알림을 마우스 오른쪽 단추로 클릭하면 추가 작업을 제공합니다. 최대 5개의 단추와 상황에 맞는 메뉴 항목을 합쳐서 만만들 수 있습니다.

IToastInput

토스트 입력에 대한 표식 인터페이스입니다.

Implementations
ToastTextBox
ToastSelectionBox

ToastTextBox

IToastInput 구현

사용자가 텍스트를 입력할 수 있는 텍스트 상자 컨트롤입니다.

Property Type Required Description
Id string true ID는 필수이며, 사용자가 입력한 텍스트를 앱에서 나중에 사용하는 ID/값의 키-값 쌍에 매핑하는 데 사용됩니다.
Title string false 텍스트 상자 위에 표시할 제목 텍스트입니다.
PlaceholderContent string false 사용자가 아직 텍스트를 입력하지 않은 경우 텍스트 상자에 표시할 자리 표시자 텍스트입니다.
DefaultInput string false 텍스트 상자에 배치할 초기 텍스트입니다. 빈 텍스트 상자의 경우 이 null을 그대로 둡니다.

ToastSelectionBox

구현 IToastInput

사용자가 옵션 드롭다운 목록에서 선택할 수 있는 선택 상자 컨트롤입니다.

Property Type Required Description
Id string true ID가 필요합니다. 사용자가 이 항목을 선택한 경우 이 ID는 선택한 항목을 나타내는 앱의 코드로 다시 전달됩니다.
Content string true 콘텐츠가 필요하며 선택 항목에 표시되는 문자열입니다.

ToastSelectionBoxItem

선택 상자 항목(사용자가 드롭다운 목록에서 선택할 수 있는 항목)입니다.

Property Type Required Description
Id string true ID는 필수이며, 사용자가 입력한 텍스트를 앱에서 나중에 사용하는 ID/값의 키-값 쌍에 매핑하는 데 사용됩니다.
Title string false 선택 상자 위에 표시할 제목 텍스트입니다.
DefaultSelectionBoxItemId string false 기본적으로 선택된 항목을 제어하며, 이는 ToastSelectionBoxItem의 Id 속성을 참조합니다. 이 옵션을 제공하지 않으면 기본 선택 영역이 비어 있습니다(사용자에게 아무 것도 표시되지 않음).
Items IList<ToastSelectionBoxItem> false 이 SelectionBox에서 사용자가 선택할 수 있는 선택 항목입니다. 5개 항목만 추가할 수 있습니다.

IToastButton

알림 단추에 대한 표식 인터페이스입니다.

Implementations
ToastButton
ToastButtonSnooze
ToastButtonDismiss

ToastButton

IToastButton을 구현

사용자가 클릭할 수 있는 단추입니다.

Property Type Required Description
Content string true Required. 단추에 표시할 텍스트입니다.
Arguments string true Required. 사용자가 이 단추를 클릭하면 앱에서 나중에 수신할 앱 정의 인수 문자열입니다.
ActivationType ToastActivationType false 이 단추를 클릭할 때 사용할 활성화 유형을 제어합니다. 기본적으로 전경으로 설정됩니다.
ActivationOptions ToastActivationOptions false 크리에이터스 업데이트의 새로운 기능: 토스트 버튼 활성화와 관련된 추가 옵션을 설정하거나 가져옵니다.

ToastActivationType

사용자가 특정 작업과 상호 작용할 때 사용할 활성화 유형을 결정합니다.

Value Meaning
Foreground 기본값입니다. 전면 앱이 실행되었습니다.
Background 해당 백그라운드 작업(모든 것을 설정했다고 가정)이 트리거되며 사용자를 방해하지 않고 백그라운드에서 코드를 실행할 수 있습니다(예: 사용자의 빠른 회신 메시지 보내기).
Protocol 프로토콜 활성화를 사용하여 다른 앱을 시작합니다.

ToastActivationOptions

크리에이터스 업데이트의 새로운 기능: 활성화와 관련된 추가 옵션입니다.

Property Type Required Description
AfterActivationBehavior ToastAfterActivationBehavior false Fall Creators Update의 새로운 기능: 사용자가 이 작업을 호출할 때 알림에서 사용해야 하는 동작을 가져오거나 설정합니다. 이는 ToastButton 및 ToastContextMenuItem의 경우 Desktop에서만 작동합니다.
ProtocolActivationTargetApplicationPfn string false ToastActivationType.Protocol을 사용하는 경우 여러 앱이 동일한 프로토콜 URI를 처리하도록 등록되었는지 여부에 관계없이 원하는 앱이 항상 시작되도록 대상 PFN을 선택적으로 지정할 수 있습니다.

ToastAfterActivationBehavior

사용자가 토스트 알림에 대해 작업을 수행할 때 알림이 사용해야 하는 동작을 지정합니다.

Value Meaning
Default 기본 동작 사용자가 토스트 알림에 대한 작업을 수행하면 알림이 해제됩니다.
PendingUpdate 사용자가 알림 메시지의 단추를 클릭하면 알림이 "보류 중인 업데이트" 시각적 상태로 유지됩니다. 백그라운드 작업에서 알림을 신속히 업데이트하셔야 합니다. 그래야만 사용자에게 이 "보류 중인 업데이트" 시각적 상태가 너무 오래 표시되지 않습니다.

ToastButtonSnooze

IToastButton을 구현합니다

알림의 스누즈를 자동으로 처리하는 시스템 처리 스누즈 버튼입니다.

Property Type Required Description
CustomContent string false 지역화된 기본 "다시 알림" 텍스트를 재정의하는 단추에 표시되는 선택적 사용자 지정 텍스트입니다.

ToastButtonDismiss

IToastButton를 구현합니다

클릭할 때 알림을 해제하는 시스템 처리 해제 단추입니다.

Property Type Required Description
CustomContent string false 기본 지역화된 "해제" 텍스트를 재정의하는 단추에 표시되는 선택적 사용자 지정 텍스트입니다.

ToastActionsSnoozeAndDismiss

* IToastActions 구현

다시 알림 간격을 위한 선택 상자를 자동으로 구성하고, 다시 알림/해제 버튼을 자동으로 지역화하며, 다시 알림 논리는 시스템에서 자동으로 처리합니다.

Property Type Required Description
ContextMenuItems IList<ToastContextMenuItem> false 1주년 업데이트의 새로운 기능: 사용자 지정 상황에 맞는 메뉴 항목으로, 사용자가 알림을 마우스 오른쪽 단추로 클릭하면 추가 작업을 제공합니다. 최대 5개 항목만 사용할 수 있습니다.

ToastContextMenuItem

상황에 맞는 메뉴 항목입니다.

Property Type Required Description
Content string true Required. 표시할 텍스트입니다.
Arguments string true Required. 사용자가 메뉴 항목을 클릭할 때 앱이 활성화되면 나중에 검색할 수 있는 앱 정의 인수 문자열입니다.
ActivationType ToastActivationType false 이 메뉴 항목을 클릭할 때 사용할 활성화 유형을 제어합니다. 기본적으로 전경으로 설정됩니다.
ActivationOptions ToastActivationOptions false 크리에이터스 업데이트의 새로운 기능: 토스트 알림 상황에 맞는 메뉴 항목의 활성화에 관한 추가 옵션.

ToastAudio

알림 메시지를 받을 때 재생할 토스트 오디오를 지정합니다.

Property Type Required Description
Src uri false 기본 소리 대신 재생할 미디어 파일입니다. ms-appx 및 ms-resource만 지원됩니다. 다른 모든 항목(ms-appdata, http, C:등)은 지원되지 않습니다.
Loop boolean false 토스트 알림이 표시되는 동안 소리가 반복되도록 하려면 true로 설정하고, false로 설정하면 한 번만 재생됩니다(기본값).
Silent boolean false 소리를 음소거하려면 True입니다. 토스트 알림 소리가 재생되도록 허용하려면 False입니다(기본값).

ToastHeader

크리에이터스 업데이트의 새로운 기능: 알림 센터 내에서 여러 알림을 함께 그룹화하는 사용자 지정 헤더입니다.

Property Type Required Description
Id string true 이 헤더를 고유하게 식별하는 개발자가 만든 식별자입니다. 두 알림의 헤더 ID가 같으면 알림 센터의 동일한 헤더 아래에 표시됩니다.
Title string true 헤더의 제목입니다.
Arguments string true 사용자가 이 헤더를 클릭할 때 앱에 반환되는 개발자 정의 인수 문자열을 가져오거나 설정합니다. null일 수 없습니다.
ActivationType ToastActivationType false 이 헤더를 클릭할 때 사용할 활성화 유형을 가져오거나 설정합니다. 기본적으로 전경으로 설정됩니다. 포그라운드 및 프로토콜만 지원됩니다.
ActivationOptions ToastActivationOptions false 알림 헤더 활성화와 관련된 추가 옵션을 가져오거나 설정합니다.
  • Last updated on