gtk:entry-placeholder-text (object)

object -- a gtk:entry widget
text -- a string to be displayed when the text entry is empty and unfocused, or nil

Accessor of the placeholder-text slot of the gtk:entry class. The gtk:entry-placeholder-text function retrieves the text that will be displayed when the text entry is empty and unfocused. The (setf gtk:entry-placeholder-text) function sets the text. This can be used to give a visual hint of the expected contents of the text entry.

Note that since the placeholder text gets removed when the text entry received focus, using this feature is a bit problematic if the text entry is given the initial focus in a window. Sometimes this can be worked around by delaying the initial focus setting until the first key event arrives.