interface ICoreWebView2Notification

interface ICoreWebView2Notification
  : public IUnknown

This is the ICoreWebView2Notification that represents a HTML Notification object.

Summary

Applies to

Members

add_CloseRequested

Add an event handler for the CloseRequested event.

public HRESULT add_CloseRequested(ICoreWebView2NotificationCloseRequestedEventHandler * eventHandler, EventRegistrationToken * token)

This event is raised when the notification is closed by the web code, such as through notification.close(). You don't need to call ReportClosed since this is coming from the web code.

get_BadgeUri

A string containing the URI of the image used to represent the notification when there isn't enough space to display the notification itself.

public HRESULT get_BadgeUri(LPWSTR * value)

The default value is an empty string.

The caller must free the returned string with CoTaskMemFree. See API Conventions.

get_Body

A string representing the body text of the notification.

public HRESULT get_Body(LPWSTR * value)

The default value is an empty string.

The caller must free the returned string with CoTaskMemFree. See API Conventions.

get_BodyImageUri

A string containing the URI of an image to be displayed in the notification.

public HRESULT get_BodyImageUri(LPWSTR * value)

The default value is an empty string.

The caller must free the returned string with CoTaskMemFree. See API Conventions.

get_Direction

The text direction in which to display the notification.

public HRESULT get_Direction(COREWEBVIEW2_TEXT_DIRECTION_KIND * value)

This corresponds to Notification.dir DOM API. The default value is COREWEBVIEW2_TEXT_DIRECTION_KIND_DEFAULT.

get_IconUri

A string containing the URI of an icon to be displayed in the notification.

public HRESULT get_IconUri(LPWSTR * value)

The default value is an empty string.

The caller must free the returned string with CoTaskMemFree. See API Conventions.

get_IsSilent

Indicates whether the notification should be silent – i.e., no sounds or vibrations should be issued, regardless of the device settings.

public HRESULT get_IsSilent(BOOL * value)

This corresponds to Notification.silent DOM API. The default value is FALSE.

get_Language

The notification's language, as intended to be specified using a string representing a language tag (such as en-US) according to BCP47.

public HRESULT get_Language(LPWSTR * value)

Note that no validation is performed on this property and it can be any string the notification sender specifies. This corresponds to Notification.lang DOM API. The default value is an empty string.

The caller must free the returned string with CoTaskMemFree. See API Conventions.

get_RequiresInteraction

A boolean value indicating that a notification should remain active until the user clicks or dismisses it, rather than closing automatically.

public HRESULT get_RequiresInteraction(BOOL * value)

This corresponds to Notification.requireInteraction DOM API. Note that you may not be able to necessarily implement this due to native API limitations. The default value is FALSE.

get_ShouldRenotify

Indicates whether the user should be notified after a new notification replaces an old one.

public HRESULT get_ShouldRenotify(BOOL * value)

This corresponds to Notification.renotify DOM API. The default value is FALSE.

get_Tag

A string representing an identifying tag for the notification.

public HRESULT get_Tag(LPWSTR * value)

This corresponds to Notification.tag DOM API. The default value is an empty string.

The caller must free the returned string with CoTaskMemFree. See API Conventions.

get_Timestamp

Indicates the time at which a notification is created or applicable (past, present, or future) as the number of milliseconds since the UNIX epoch.

public HRESULT get_Timestamp(double * value)

get_Title

The title of the notification.

public HRESULT get_Title(LPWSTR * value)

The caller must free the returned string with CoTaskMemFree. See API Conventions.

GetVibrationPattern

Gets the vibration pattern for devices with vibration hardware to emit.

public HRESULT GetVibrationPattern(UINT32 * count, UINT64 ** vibrationPattern)

The vibration pattern can be represented by an array of 64-bit unsigned integers describing a pattern of vibrations and pauses. See Vibration API for more information. This corresponds to Notification.vibrate DOM API. An empty array is returned if no vibration patterns are specified.

remove_CloseRequested

Remove an event handler previously added with add_CloseRequested.

public HRESULT remove_CloseRequested(EventRegistrationToken token)

ReportClicked

The host may run this to report the notification has been clicked, and it will cause the click event to be raised for non-persistent notifications and the notificationclick event for persistent notifications.

public HRESULT ReportClicked()

Use ReportClickedWithActionIndex to specify an action to activate a persistent notification. You must not run this unless you are handling the NotificationReceived event. Returns HRESULT_FROM_WIN32(ERROR_INVALID_STATE) if Handled is FALSE or ReportShown has not been run when this is called.

ReportClosed

The host may run this to report the notification was dismissed, and it will cause the close event to be raised for non-persistent notifications and the notificationclose event for persistent notifications.

public HRESULT ReportClosed()

You must not run this unless you are handling the NotificationReceived event. Returns HRESULT_FROM_WIN32(ERROR_INVALID_STATE) if Handled is FALSE or ReportShown has not been run when this is called.

ReportShown

The host may run this to report the notification has been displayed and it will cause the show event to be raised for non-persistent notifications.

public HRESULT ReportShown()

You must not run this unless you are handling the NotificationReceived event. Returns HRESULT_FROM_WIN32(ERROR_INVALID_STATE) if Handled is FALSE when this is called.