Non-XUL extension. It is used to replace XUL menulist. This class is more flexible than menulist, such as {@link #setAutocomplete}{@link #setAutodrop}.
Default {@link #getZclass}: z-combobox.(since 3.5.0)
Events: onOpen, onSelect, onAfterRender
Developers can listen to the onOpen event and initializes it when {@link org.zkoss.zk.ui.event.OpenEvent#isOpen} is true, and/orclean up if false.
onAfterRender is sent when the model's data has been rendered.(since 5.0.4)
Besides assign a list model, you could assign a renderer (a {@link ComboitemRenderer} instance) to a combobox, such thatthe combobox will use this renderer to render the data returned by {@link ListModel#getElementAt}. If not assigned, the default renderer, which assumes a label per combo item, is used. In other words, the default renderer adds a label to a row by calling toString against the object returned by {@link ListModel#getElementAt}. (since 3.0.2)
Note: to have better performance, onOpen is sent only if a non-deferrable event listener is registered (see {@link org.zkoss.zk.ui.event.Deferrable}).
Like {@link Datebox}, the value of a read-only comobobox ( {@link #isReadonly}) can be changed by dropping down the list and selecting an combo item (though users cannot type anything in the input box). @author tomyeh @see Comboitem
| |