gtk-progress-bar-text (object)

object -- a gtk-progress-bar widget
text -- a UTF-8 string, or nil

Accessor of the text slot of the gtk-progress-bar class.

The gtk-progress-bar-text slot access function retrieves the text displayed superimposed on the progress bar, if any, otherwise nil. The return value is a reference to the text, not a copy of it, so will become invalid if you change the text in the progress bar. The (setf gtk-progress-bar-text) slot access function causes the given text to appear superimposed on the progress bar.

If the text argument is nil and the show-text property is true, the current value of the fraction property will be displayed as a percentage.

If the text argument is non-nil and the show-text property is true, the text will be displayed. In this case, it will not display the progress percentage. If text is the empty string, the progress bar will still be styled and sized suitably for containing text, as long as the show-text property is true.