gtk:search-entry-placeholder-text (object)

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

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

Note that since the placeholder text gets removed when the search entry received focus, using this feature is a bit problematic if the search 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.