Package: gtk

Accessor gtk:numerable-icon-label

Lambda List

gtk:numerable-icon-label (object)

Syntax

(gtk:numerable-icon-label object) => label
(setf (gtk:numerable-icon-label object) label)

Arguments

object -- a gtk:numerable-icon object
label -- a string with a short label, or nil

Details

Accessor of the label slot of the gtk:numerable-icon class. The gtk:numerable-icon-label function returns the currently displayed label of the numerable icon, or nil. The (setf gtk:numerable-icon-label) function sets the currently displayed label. Setting an empty label removes the emblem.

Note that this is meant for displaying short labels, such as roman numbers, or single letters. For roman numbers, consider using the Unicode characters U+2160 - U+217F. Strings longer than two characters will likely not be rendered very well.

If this method is called, and a number was already set on the icon, it will automatically be reset to zero before rendering the label, i.e. the last method called between the gtk:numerable-icon-label and gtk:numerable-icon-count functions has always priority.

Warning

The gtk:numerable-icon-label function has been deprecated since version 3.14 and should not be used in newly written code.
 

See also

2024-12-31