Struct ashpd::desktop::notification::NotificationProxy

pub struct NotificationProxy<'a>(_);

The interface lets sandboxed applications send and withdraw notifications.

It is not possible for the application to learn if the notification was actually presented to the user. Not a portal in the strict sense, since there is no user interaction.

Note that in contrast to most other portal requests, notifications are expected to outlast the running application. If a user clicks on a notification after the application has exited, it will get activated again.

Notifications can specify actions that can be activated by the user. Actions whose name starts with ‘app.’ are assumed to be exported and will be activated via the ActivateAction() method in the org.freedesktop.Application interface. Other actions are activated by sending the #org.freedeskop.portal.Notification::ActionInvoked signal to the application.

Implementations

impl<'a> NotificationProxy<'a>

pub async fn new(
    connection: &Connection
) -> Result<NotificationProxy<'a>, Error>

Create a new instance of NotificationProxy.

pub fn inner(&self) -> &Proxy<'_>

Get a reference to the underlying Proxy.

pub async fn receive_action_invoked(&self) -> Result<Action, Error>

Signal emitted when a particular action is invoked.

pub async fn add_notification(
    &self,
    id: &str,
    notification: Notification
) -> Result<(), Error>

Sends a notification.

The ID can be used to later withdraw the notification. If the application reuses the same ID without withdrawing, the notification is replaced by the new one.

Arguments

• id - Application-provided ID for this notification.
• notification - The notification.

pub async fn remove_notification(&self, id: &str) -> Result<(), Error>

Withdraws a notification.

Arguments

• id - Application-provided ID for this notification.

Trait Implementations

impl<'a> Debug for NotificationProxy<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.