diff options
author | Simon Ser <contact@emersion.fr> | 2021-03-04 13:52:58 +0100 |
---|---|---|
committer | David Faure <faure@kde.org> | 2021-06-19 11:03:47 +0000 |
commit | b9a470004d5a91e4f1de85133a892130e714fc75 (patch) | |
tree | 66a89d06eddaf1a2f8e7e6e0e12312570ad57322 | |
parent | 9a32db070a486e40b45045a22e39b8ff8905b773 (diff) |
notification: add ActivationToken signal
This allows transferring an activation token to the application that
opened the notification.
References: https://gitlab.freedesktop.org/wayland/wayland-protocols/-/merge_requests/50
-rw-r--r-- | notification/notification-spec.xml | 59 |
1 files changed, 59 insertions, 0 deletions
diff --git a/notification/notification-spec.xml b/notification/notification-spec.xml index 5f66077..37a7552 100644 --- a/notification/notification-spec.xml +++ b/notification/notification-spec.xml @@ -1272,6 +1272,65 @@ </para> </note> </sect3> + + <sect3 id="signal-activation-token"> + <title><literal>org.freedesktop.Notifications.ActivationToken</literal></title> + <funcsynopsis> + <funcprototype> + <funcdef> + <function>org.freedesktop.Notifications.ActivationToken</function> + </funcdef> + <paramdef>UINT32 <parameter>id</parameter></paramdef> + <paramdef>STRING <parameter>activation_token</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + This signal can be emitted before a <literal>ActionInvoked</literal> + signal. It carries an activation token that can be used to activate a + toplevel. + </para> + <table> + <title>ActivationToken Parameters</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Name</entry> + <entry>Type</entry> + <entry>Description</entry> + </row> + </thead> + <tbody valign="top"> + <row> + <entry><parameter>id</parameter></entry> + <entry>UINT32</entry> + <entry> + The ID of the notification emitting the <literal>ActionInvoked</literal> + signal. + </entry> + </row> + <row> + <entry><parameter>activation_token</parameter></entry> + <entry>STRING</entry> + <entry> + An activation token. This can be either an X11-style startup ID (see + <ulink url="https://specifications.freedesktop.org/startup-notification-spec/startup-notification-latest.txt">Startup notification protocol</ulink>) + or a + <ulink url="https://gitlab.freedesktop.org/wayland/wayland-protocols/-/tree/main/staging/xdg-activation">Wayland xdg-activation</ulink> + token. + </entry> + </row> + </tbody> + </tgroup> + </table> + <note> + <para> + Clients should not assume the server will generate this signal. Some + servers may not support user interaction at all, or may not support + the concept of being able to generate an activation token for a + notification. + </para> + </note> + </sect3> </sect2> </sect1> </article> |