앱 알림 콘텐츠 스키마

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

Windows 앱 SDK 작성기 API 대신 원시 XML을 사용하려는 경우 XML 스키마 참조하세요.

ToastContent

ToastContent

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

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

ToastScenario

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

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

ToastVisual

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

재산 유형 필수 설명
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 문자열 false 지역화된 리소스를 사용하는 경우 시각적 페이로드의 대상 로캘로, "en-US" 또는 "fr-FR"와 같은 BCP-47 언어 태그로 지정됩니다. 바인딩이나 텍스트에 지정된 로캘이 있을 경우, 이 로캘은 해당 로캘에 의해 재정의됩니다. 제공되지 않으면 시스템 로캘이 대신 사용됩니다.

ToastBindingGeneric

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

재산 유형 필수 설명
자녀 IList<IToastBindingGenericChild> false 텍스트, 이미지 및 그룹을 포함할 수 있는 알림 본문의 내용입니다. 텍스트 요소는 다른 요소 앞에 와야 하며 3개의 텍스트 요소만 지원됩니다. 텍스트 요소가 다른 요소 뒤에 배치되면 위쪽으로 이동되거나 제거됩니다. 마지막으로 HintStyle과 같은 특정 텍스트 속성은 루트 자식 텍스트 요소에서 지원되지 않으며 AdaptiveSubgroup 내에서만 작동합니다.
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 문자열 false 지역화된 리소스를 사용하는 경우 시각적 페이로드의 대상 로캘로, "en-US" 또는 "fr-FR"와 같은 BCP-47 언어 태그로 지정됩니다. 바인딩이나 텍스트에 지정된 로캘이 있을 경우, 이 로캘은 해당 로캘에 의해 재정의됩니다. 제공되지 않으면 시스템 로캘이 대신 사용됩니다.

IToastBindingGenericChild

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

구현
AdaptiveText
AdaptiveImage
AdaptiveGroup
AdaptiveProgressBar

AdaptiveText

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

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

BindableString

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

재산 유형 필수 설명
BindingName 문자열 true 바인딩 데이터 값에 매핑되는 이름을 가져오거나 설정합니다.

AdaptiveTextStyle

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

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

AdaptiveTextAlign

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

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

AdaptiveImage

인라인 이미지입니다.

재산 유형 필수 설명
출처 문자열 true 이미지의 URL입니다. ms-appx, ms-appdata 및 http가 지원됩니다. 웹 이미지는 일반 연결에서 최대 3MB, 데이터 통신 연결에서 1MB까지 가능합니다.
HintCrop AdaptiveImageCrop false 이미지의 원하는 자르기를 제어합니다.
HintRemoveMargin bool? false 기본적으로 그룹/하위 그룹 내의 이미지는 주위에 8px 여백이 있습니다. 이 속성을 true로 설정하여 이 여백을 제거할 수 있습니다.
HintAlign AdaptiveImageAlign false 이미지의 가로 정렬입니다. 그룹/하위 그룹 내의 이미지에 대해서만 작동합니다.
AlternateText 문자열 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

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

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

AdaptiveImageAlign

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

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

AdaptiveGroup

그룹은 그룹의 콘텐츠가 전체적으로 표시되거나 적합하지 않은 경우 표시되지 않아야 임을 의미적으로 식별합니다. 또한 그룹은 여러 열을 만들 수 있습니다.

재산 유형 필수 설명
자녀 IList<AdaptiveSubgroup> false 하위 그룹은 세로 열로 표시됩니다. 하위 그룹을 사용하여 AdaptiveGroup 내의 모든 콘텐츠를 제공해야 합니다.

AdaptiveSubgroup

하위 그룹은 텍스트와 이미지를 포함할 수 있는 세로 열입니다.

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

IAdaptiveSubgroupChild

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

구현
AdaptiveText
AdaptiveImage

AdaptiveSubgroupTextStacking

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

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

AdaptiveProgressBar

진행률 표시줄입니다. 데스크톱에서만 지원됩니다.

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

AdaptiveProgressBarValue

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

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

BindableProgressBarValue

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

재산 유형 필수 설명
BindingName 문자열 true 바인딩 데이터 값에 매핑되는 이름을 가져오거나 설정합니다.

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

재산 유형 필수 설명
출처 문자열 true 이미지의 URL입니다. ms-appx, ms-appdata 및 http가 지원됩니다. Http 이미지는 200 KB 이하이어야 합니다.
HintCrop ToastGenericAppLogoCrop false 이미지를 자르는 방법을 지정합니다.
AlternateText 문자열 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

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

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

ToastGenericHeroImage

알림 센터와 토스트 알림에 표시되는 특별한 "hero" 이미지입니다.

재산 유형 필수 설명
출처 문자열 true 이미지의 URL입니다. ms-appx, ms-appdata 및 http가 지원됩니다. Http 이미지는 200 KB 이하이어야 합니다.
AlternateText 문자열 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

앱 알림의 맨 아래에 표시되는 특성 텍스트입니다.

재산 유형 필수 설명
텍스트 문자열 true 표시할 텍스트입니다.
Language 문자열 false 지역화된 리소스를 사용하는 경우 시각적 페이로드의 대상 로캘로, "en-US" 또는 "fr-FR"와 같은 BCP-47 언어 태그로 지정됩니다. 제공되지 않으면 시스템 로캘이 대신 사용됩니다.

IToastActions

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

구현
ToastActionsCustom
ToastActionsSnoozeAndDismiss

ToastActionsCustom

IToastActions 구현

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

재산 유형 필수 설명
입력 IList<IToastInput> false 입력란 및 선택 입력과 같은 입력입니다. 최대 5개의 입력만 허용됩니다.
단추 IList<IToastButton> false 단추는 모든 입력 후에 표시됩니다(또는 단추가 빠른 회신 단추로 사용되는 경우 입력에 인접). 최대 5개의 단추만 허용됩니다(상황에 맞는 메뉴 항목이 있는 경우 더 적은 수).
ContextMenuItems IList<ToastContextMenuItem> false 사용자 지정 상황에 맞는 메뉴 항목, 사용자가 알림을 마우스 오른쪽 단추로 클릭 하는 경우 추가 작업을 제공 합니다. 최대 5개의 단추와 상황에 맞는 메뉴 항목을 합쳐서 만만들 수 있습니다.

IToastInput

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

구현
ToastTextBox
ToastSelectionBox

ToastTextBox

IToastInput 구현

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

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

ToastSelectionBox

IToastInput 구현

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

재산 유형 필수 설명
ID 문자열 true ID가 필요합니다. 사용자가 이 항목을 선택한 경우 이 ID는 선택한 항목을 나타내는 앱의 코드로 다시 전달됩니다.
콘텐츠 문자열 true 콘텐츠가 필요하며 선택 항목에 표시되는 문자열입니다.

ToastSelectionBoxItem

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

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

IToastButton

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

구현
ToastButton
ToastButtonSnooze
ToastButtonDismiss

ToastButton

IToastButton을 구현

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

재산 유형 필수 설명
콘텐츠 문자열 true 필수입니다. 단추에 표시할 텍스트입니다.
인수 문자열 true 필수입니다. 사용자가 이 단추를 클릭하면 앱에서 나중에 수신할 앱 정의 인수 문자열입니다.
ActivationType ToastActivationType false 이 단추를 클릭할 때 사용할 활성화 유형을 제어합니다. 기본적으로 전경으로 설정됩니다.
ActivationOptions ToastActivationOptions false 알림 단추 활성화와 관련된 추가 옵션을 가져오거나 설정합니다.

ToastActivationType

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

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

ToastActivationOptions

활성화와 관련된 추가 옵션입니다.

재산 유형 필수 설명
AfterActivationBehavior ToastAfterActivationBehavior false 사용자가 이 작업을 호출할 때 알림에서 사용해야 하는 동작을 가져오거나 설정합니다. 이는 ToastButton 및 ToastContextMenuItem의 경우 Desktop에서만 작동합니다.
ProtocolActivationTargetApplicationPfn 문자열 false ToastActivationType.Protocol을 사용하는 경우 여러 앱이 동일한 프로토콜 URI를 처리하도록 등록되었는지 여부에 관계없이 원하는 앱이 항상 시작되도록 대상 PFN을 선택적으로 지정할 수 있습니다.

ToastAfterActivationBehavior

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

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

ToastButtonSnooze

IToastButton을 구현

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

재산 유형 필수 설명
CustomContent 문자열 false 지역화된 기본 "다시 알림" 텍스트를 재정의하는 단추에 표시되는 선택적 사용자 지정 텍스트입니다.

ToastButtonDismiss

IToastButton을 구현

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

재산 유형 필수 설명
CustomContent 문자열 false 기본 지역화된 "해제" 텍스트를 재정의하는 단추에 표시되는 선택적 사용자 지정 텍스트입니다.

ToastActionsSnoozeAndDismiss

* IToastActions 구현

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

재산 유형 필수 설명
ContextMenuItems IList<ToastContextMenuItem> false 사용자 지정 상황에 맞는 메뉴 항목, 사용자가 알림을 마우스 오른쪽 단추로 클릭 하는 경우 추가 작업을 제공 합니다. 최대 5개 항목만 사용할 수 있습니다.

ToastContextMenuItem

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

재산 유형 필수 설명
콘텐츠 문자열 true 필수입니다. 표시할 텍스트입니다.
인수 문자열 true 필수입니다. 사용자가 메뉴 항목을 클릭할 때 앱이 활성화되면 나중에 검색할 수 있는 앱 정의 인수 문자열입니다.
ActivationType ToastActivationType false 이 메뉴 항목을 클릭할 때 사용할 활성화 유형을 제어합니다. 기본적으로 전경으로 설정됩니다.
ActivationOptions ToastActivationOptions false 토스트 컨텍스트 메뉴 항목의 활성화와 관련된 추가 옵션입니다.

ToastAudio

앱 알림을 받을 때 재생할 오디오를 지정합니다.

재산 유형 필수 설명
Src URI false 기본 소리 대신 재생할 미디어 파일입니다. ms-appx 및 ms-resource만 지원됩니다. 다른 모든 항목(ms-appdata, http, C:등)은 지원되지 않습니다.
Loop 부울 false 토스트 알림이 표시되는 동안 소리가 반복되도록 하려면 true로 설정하고, false로 설정하면 한 번만 재생됩니다(기본값).
Silent 부울 false 소리를 음소거하려면 True입니다. false이면 앱 알림 소리를 재생할 수 있습니다(기본값).

ToastHeader

Notification Center 내에서 여러 알림을 함께 그룹화하는 사용자 지정 헤더입니다.

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