Package: gtk

Function gtk:search-bar-handle-event

Lambda List

gtk:search-bar-handle-event (searchbar event)

Arguments

searchbar -- a gtk:search-bar widget
event -- a gdk:event instance containing key press events

Return Value

The gdk:+event-stop+ value if the key press event resulted in text being entered in the search entry, and revealing the search bar if necessary, gdk:+event-propagate+ otherwise.

Details

This function should be called when the toplevel window which contains the search bar received a key event. If the key event is handled by the search bar, the bar will be shown, the entry populated with the entered text and the gdk:+event-stop+ value will be returned. The caller should ensure that events are not propagated further.

If no entry has been connected to the search bar, using the gtk:search-bar-connect-entry function, this function will return immediately with a warning.
 

See also

#2025-07-21