Skip to content

ComboBox#

ComboBox widget

Available in backends: qt, ipynb

Signals#

  • changed(object) - Emitted when the widget value changes.
  • label_changed(str) - Emitted when the widget label changes.
  • native_parent_changed(object) - Emitted with the backend widget when the widget parent changes.

ComboBox #

Bases: CategoricalWidget

A dropdown menu, allowing selection between multiple choices.

Parameters:

  • value (Any, default: Undefined ) –

    The initially selected choice.

  • choices (Enum, Iterable, or Callable, default: () ) –

    Available choices displayed in the combo box.

  • bind (Callable[[ValueWidget], Any] | Any, default: Undefined ) –

    A value or callback to bind this widget. If provided, whenever widget.value is accessed, the value provided here will be returned instead. bind may be a callable, in which case bind(self) will be returned (i.e. your bound callback must accept a single parameter, which is this widget instance).

  • nullable (bool, default: False ) –

    If True, the widget will accepts None as a valid value, by default False.

  • **base_widget_kwargs (Any, default: {} ) –

    All additional keyword arguments are passed to the base magicgui.widgets.Widget constructor.