gtk:widget, gobject:initially-unowned, gtk:accessible, gtk:buildable, gtk:constraint-target, gobject:object, common-lisp:standard-object, common-lisp:t

None

The gtk:drop-down widget is a widget that allows the user to choose an item from a list of options. The gtk:drop-down widget displays the selected choice.

The options are given to the gtk:drop-down widget in the form of a g:list-model object, and how the individual options are represented is determined by a gtk:list-item-factory object. The default factory displays simple strings.

The gtk:drop-down widget knows how to obtain strings from the items in a gtk:string-list object. For other models, you have to provide an expression to find the strings via the gtk:drop-down-expression function.

The gtk:drop-down widget can optionally allow search in the popup, which is useful if the list of options is long. To enable the search entry, use the gtk:drop-down-enable-search function. The gtk:drop-down implementation has a single CSS node with name dropdown, with the button and popover nodes as children. The gtk:drop-down implementation uses the :combo-box role of the gtk:accessible-role enumeration.

The "activate" signal

lambda (dropdown)    :action      

The signal is an action signal and emitting it causes the drop down to pop up its dropdown. The default handler is called before the handlers. Since 4.6

dropdown

The gtk:drop-down widget.