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

The accessor for the placeholder-text slot gets or sets the text that will be displayed when the search entry is empty and unfocused. 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.