Function: system-taskbar--badge

system-taskbar--badge is a byte-compiled function defined in system-taskbar.el.gz.

Signature

(system-taskbar--badge &optional COUNT)

Documentation

Display COUNT as an overlay on the system taskbar Emacs icon.

If COUNT is an integer, display that. If COUNT is a string on back ends that support strings, display that. The string should be short. On back ends which do not support strings, convert COUNT to an integer using string-to-number and testing integerp, or nil if that fails. If COUNT is nil or an empty string, remove the counter.

Implementations

(system-taskbar--badge (&OPTIONAL ((&context . system-taskbar--back-end) eql 'w32)) COUNT) in `system-taskbar.el'.

Display a COUNT overlay on the system taskbar icon. The taskbar icon target is associated with the selected frame.

If COUNT is an integer or a non-empty string, display that. If COUNT is nil or an empty string, clear the badge.

Due to MS-Windows icon overlay size limitations, if COUNT is an integer and is outside the range -99 to 99, display "-99" and "99+", respectively, if COUNT is a string longer than 2 characters truncate it using `truncate-string-to-width'.

Consult `system-taskbar-w32-badge-background' and `system-taskbar-w32-badge-foreground' for the background and foreground colors for the painted overlay.

(system-taskbar--badge (&OPTIONAL ((&context . system-taskbar--back-end) eql 'ns)) COUNT) in `system-taskbar.el'.

Display COUNT as an overlay on the Dock badge. If COUNT is an integer or a non-empty string, display that. If COUNT is nil or an empty string, clear the badge overlay. Note: NS will abbreviate long strings to fit the badge's allocated space.

(system-taskbar--badge (&OPTIONAL ((&context . system-taskbar--back-end) eql 'dbus)) COUNT) in `system-taskbar.el'.

Display COUNT as an overlay on the system taskbar Emacs icon. If COUNT is an integer, display that. If COUNT is a string, convert it to an integer, or nil if that fails. If COUNT is any other type, use nil. If COUNT is nil or an empty string, remove the badge. Note: The Unity D-Bus protocol supports only integer badges.

Source Code

;; Defined in /usr/src/emacs/lisp/system-taskbar.el.gz
(cl-defgeneric system-taskbar--badge (&optional count)
  "Display COUNT as an overlay on the system taskbar Emacs icon.
If COUNT is an integer, display that.
If COUNT is a string on back ends that support strings, display that.
The string should be short.
On back ends which do not support strings, convert COUNT to an integer
using `string-to-number' and testing `integerp', or nil if that fails.
If COUNT is nil or an empty string, remove the counter.")