Prima::ComboBox - standard combo box widget Provides a combo box widget which consists of an input line, list box of possible selections and eventual drop-down button. The combo box can be either in form with a drop-down selection list, that is shown by the command of the user, or in form when the selection list is always visible. The combo box is a grouping widget, and contains neither painting nor user-input code. All such functionality is delegated into the children widgets: input line, list box and button. Prima::ComboBox exports a fixed list of methods and properties from namespaces of the Prima::InputLine manpage and the Prima::ListBox manpage. Since, however, it is possible to tweak the Prima::ComboBox ( using its the editClass manpage and the listClass manpage create-only properties ) so the input line and list box would be other classes, it is not necessarily that all default functionality would work. The list of exported names is stored in package variables %listProps, %editProps and %listDynas. These also described in the section on Exported names section. The module defines cs:: package for the constants used by the style manpage property. use Prima::ComboBox; my $combo = Prima::ComboBox-> create( style => cs::DropDown, items => [ 1 .. 10 ]); $combo-> style( cs::DropDownList ); print $combo-> text;

Properties
Assigns a drop-down button class. Create-only property. Default value: Prima::Widget Assigns a drop-down button list of delegated notifications. Create-only property. Assigns hash of properties, passed to the drop-down button during the creation. Create-only property. Selects whether the user input is case-sensitive or not, when a value is picked from the selection list. Default value: 0 Assigns an input line class. Create-only property. Default value: Prima::InputLine Assigns hash of properties, passed to the input line during the creation. Create-only property. Assigns an input line list of delegated notifications. Create-only property. Selects height of an input line. Mapped onto the list widget's items property. See the Prima::Lists manpage for details. Assigns a listbox class. Create-only property. Default value: Prima::ListBox Selects height of the listbox widget. Default value: 100 Sets whether the listbox is visible or not. Not writable when the style manpage is cs::Simple. Assigns hash of properties, passed to the listbox during the creation. Create-only property. Assigns a selection listbox list of delegated notifications. Create-only property. Selects whether the combo box user input routine assume that the listbox contains literal strings, that can be fetched via get_item_text ( see the Prima::Lists manpage ). As an example when this property is set to 0 is Prima::ColorComboBox from the Prima::ComboBox manpage package. Default value: 1 Selected one of three styles: The listbox is always visible, and the drop-down button is not. The listbox is not visible, but the drop-down button is. When the use presses the drop-down button, the listbox is shown; when the list-box is defocused, it gets hidden. Same as cs::DropDown, but the user is restricted in the selection: the input line can only accept user input that is contained in listbox. If the literal manpage set to 1, the auto completion feature is provided. Mapped onto the edit widget's text property.

Exported names
alignment autoScroll text text charOffset maxLen insertMode firstChar selection selStart selEnd writeOnly copy cut delete paste wordDelimiters readOnly passwordChar focus select_all autoHeight focusedItem hScroll integralHeight items itemHeight topItem vScroll gridColor multiColumn offset onDrawItem onSelectItem Dmitry Karasik, <dmitry@karasik.eu.org>. the Prima manpage, the Prima::InputLine manpage, the Prima::Lists manpage, the Prima::ColorDialog manpage, the Prima::FileDialog manpage, examples/listbox.pl.