Introduction

Menulists are the root elements of drop-downs (combo boxes). While you can declare the contents of a menulist in the XUL document, most often you'll want to bind a collection to the "elements" property to generate the menuitems.

Properties

Property	Fires Events	Notes
binding (String)	No	The property to extract a label value from each item bound to this control (i.e. a value of "name" would translate to a "getName()" call on each item in the bound collection
editable (bool)	No	Allows the editing of the property for the object bound to the menuitem
elements (Collection)	No	Setting a collection on the property will populate the menulist based on the collection. The label displayed will be extracted from the Objects based on the value set in the "binding" property
selectedIndex (int)	Yes	Sets the current value on the menulist. This property is also fired on user change.
selectedItem (Object)	Yes	Similar to selectedIndex only based on the objects bound to the menulist.
value (String)	No	Calling this will set the value for the currently selected item. Only meaningful when the menulist is editable
oncommand (String)	No	"controller.method()" format. Fired when the currently selected item is changed.

Methods

None.

Sample Usage

<menulist id="list" pen:binding="name">
    <menupopup>
        <menuitem label="Value 1" />
        <menuitem label="Value 2" />
    </menupopup>
</menulist>

Example binding, usually defined in a controller's init. This populates the menulist with the contents of the method getListItems() in the controller:

XulMenuList<String> list = (XulMenuList<String>) document.getElementById("list");
Binding b = bf.createBinding(this, "listItems", list, "elements");
b.fireSourceChanged();