Function: notifications-get-capabilities

notifications-get-capabilities is a byte-compiled function defined in notifications.el.gz.

Signature

(notifications-get-capabilities &optional BUS)

Documentation

Return the capabilities of the notification server, a list of symbols.

BUS can be a string denoting a D-Bus connection, the default is :session. The following capabilities can be expected:

  :actions The server will provide the specified actions
                   to the user.
  :action-icons Supports using icons instead of text for
                   displaying actions.
  :body Supports body text.
  :body-hyperlinks The server supports hyperlinks in the notifications.
  :body-images The server supports images in the notifications.
  :body-markup Supports markup in the body text.
  :icon-multi The server will render an animation of all the
                   frames in a given image array.
  :icon-static Supports display of exactly 1 frame of any
                   given image array. This value is mutually exclusive
                   with :icon-multi.
  :persistence The server supports persistence of notifications.
  :sound The server supports sounds on notifications.

Further vendor-specific caps start with :x-vendor, like :x-gnome-foo-cap.

View in manual

Probably introduced at or before Emacs version 24.3.

Source Code

;; Defined in /usr/src/emacs/lisp/notifications.el.gz
(defvar dbus-debug) ; used in the macroexpansion of dbus-ignore-errors

(defun notifications-get-capabilities (&optional bus)
  "Return the capabilities of the notification server, a list of symbols.
BUS can be a string denoting a D-Bus connection, the default is `:session'.
The following capabilities can be expected:

  :actions         The server will provide the specified actions
                   to the user.
  :action-icons    Supports using icons instead of text for
                   displaying actions.
  :body            Supports body text.
  :body-hyperlinks The server supports hyperlinks in the notifications.
  :body-images     The server supports images in the notifications.
  :body-markup     Supports markup in the body text.
  :icon-multi      The server will render an animation of all the
                   frames in a given image array.
  :icon-static     Supports display of exactly 1 frame of any
                   given image array.  This value is mutually exclusive
                   with `:icon-multi'.
  :persistence     The server supports persistence of notifications.
  :sound           The server supports sounds on notifications.

Further vendor-specific caps start with `:x-vendor', like `:x-gnome-foo-cap'."
  (dbus-ignore-errors
    (mapcar
     (lambda (x) (intern (concat ":" x)))
     (dbus-call-method (or bus :session)
		       notifications-service
		       notifications-path
		       notifications-interface
		       notifications-get-capabilities-method))))