ToastNotification 클래스

정의

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

public ref class ToastNotification sealed
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Notifications.IToastNotificationFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class ToastNotification final
/// [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")]
class ToastNotification final
/// [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.Activatable(typeof(Windows.UI.Notifications.IToastNotificationFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public sealed class ToastNotification
[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")]
public sealed class ToastNotification
[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
특성

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에서 알림 메시지를 표시하려고 할 때 오류가 발생할 때 발생합니다. 실행 중인 앱은 이 이벤트를 구독합니다.

적용 대상

추가 정보