ToastNotification 클래스

정의

네임스페이스:

Windows.UI.Notifications

알림 메시지의 콘텐츠, 연결된 메타데이터 및 이벤트 및 만료 시간을 정의합니다.

public ref class ToastNotification sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Notifications.IToastNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ToastNotification final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Notifications.IToastNotificationFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ToastNotification

function ToastNotification(content)

Public NotInheritable Class ToastNotification

상속

Object Platform::Object IInspectable ToastNotification

특성

ActivatableAttribute ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

설명

앱에서 알림 메시지를 구현하는 방법에 대한 지침은 C# 앱에서 로컬 알림 메시지 보내기를 참조하세요.

알림 메시지에 대한 앱 활성화를 처리하기 위한 지침:

• UWP 애플리케이션은 알림 활성화를 처리하기 위해 OnActivated 를 사용해야 합니다.
• WinRT 빌드 19041부터 패키지된 앱(외부 위치가 있는 패키지된 앱 포함)은 ToastNotificationActionTrigger 를 사용하여 활성화를 처리할 수 있습니다.
• 데스크톱 앱은 데스크톱 - 로컬 알림 보내기에 따라 COM 활성화를 사용할 수 있습니다.
• 애플리케이션에 맞는 활성화 옵션이 없는 경우 이벤트 처리기를 제대로 사용하려면 이 문서의 예제를 따르세요.

버전 기록

Windows 버전	SDK 버전	추가된 값
1607	14393	NotificationMirroring
1607	14393	RemoteId
1703	15063	데이터
1703	15063	우선 순위
1903	18362	ExpiresOnReboot

생성자

ToastNotification(XmlDocument)

ToastNotification의 새 instance 만들고 초기화합니다.

속성

Content	현재 알림 메시지를 정의하는 XML을 가져옵니다.
Data	알림 메시지의 상태 대한 추가 정보를 가져오거나 설정합니다.
ExpirationTime	알림 메시지를 표시하지 않아야 하는 시간을 가져오거나 설정합니다.
ExpiresOnReboot	다시 부팅한 후 알림 센터에 알림 메시지가 남아 있는지 여부를 나타냅니다.
Group	알림에 대한 그룹 식별자를 가져오거나 설정합니다.
NotificationMirroring	알림 미러링이 허용되는지 여부를 지정하는 값을 가져오거나 설정합니다.
Priority	알림 메시지의 우선 순위를 가져오거나 설정합니다.
RemoteId	시스템에서 이 알림을 다른 디바이스에서 생성된 다른 알림과 상호 연결할 수 있도록 하는 알림의 원격 ID를 가져오거나 설정합니다.
SuppressPopup	알림의 팝업 UI가 사용자의 화면에 표시되는지 여부를 가져오거나 설정합니다.
Tag	알림 그룹 내에서 이 알림의 고유 식별자를 가져오거나 설정합니다.

이벤트

Activated	사용자가 클릭 또는 터치를 통해 알림 메시지를 활성화할 때 발생합니다. 실행 중인 앱은 이 이벤트를 구독합니다.
Dismissed	알림 메시지가 만료되거나 사용자가 명시적으로 해제하여 화면을 떠날 때 발생합니다. 실행 중인 앱은 이 이벤트를 구독합니다.
Failed	Windows에서 알림 메시지를 표시하려고 할 때 오류가 발생할 때 발생합니다. 실행 중인 앱은 이 이벤트를 구독합니다.

추가 정보

• 알림 사용 샘플
• 데스크톱 앱에서 알림 메시지 보내기 샘플
• 알림 XML 스키마
• 타일, 배지 및 알림
• 빠른 시작: 알림 메시지 보내기
• 빠른 시작: 알림 메시지 보내기
• 빠른 시작: 바탕 화면에서 알림 메시지 보내기
• 알림 메시지에 대한 지침 및 검사 목록
• 알림 메시지에서 활성화를 처리하는 방법
• 알림 메시지를 옵트인하는 방법
• 알림 메시지를 예약하는 방법
• AppUserModelID를 통해 데스크톱 알림 메시지를 사용하는 방법
• 알림 템플릿 카탈로그
• 알림 오디오 옵션