enaml.widgets.object_combo

Classes

ObjectCombo

A drop-down list from which one item can be selected at a time.

class enaml.widgets.object_combo.ObjectCombo(parent=None, **kwargs)[source]

Bases: Control

A drop-down list from which one item can be selected at a time.

Use a combo box to select a single item from a collection of items.

items

The list of items to display in the combo box.

selected

The selected item from the list of items. The default will be the first item in the list of items, or None.

to_string

The callable to use to convert the items into strings for display. The default is the builtin ‘str’.

to_icon

The callable to use to convert the items into icons for display. The default is a lambda which returns None.

editable

Whether the text in the combo box can be edited by the user.

hug_width

A combo box hugs its width weakly by default.

proxy

A reference to the ProxyObjectCombo object.

activated

An event fired when an object’s proxy is activated. It is triggered once during the object lifetime, at the end of the activate_proxy method.

background

The background color of the widget.

destroyed

An event fired when an object has been destroyed. It is triggered once during the object lifetime, just before the object is removed from the tree structure.

enabled

Whether or not the widget is enabled.

initialized

An event fired when an object is initialized. It is triggered once during the object lifetime, at the end of the initialize method.

name

Export the ‘name’ attribute as a declarative member.

style_class

The style class to which this item belongs. Multiple classes can be separated with whitespace. An empty string indicates the widget does not belong to any style class.