| 127 | '''Combo Box''' |
| 128 | || '''Selector''' || '''Type''' || '''Description''' || |
| 129 | || `readOnly` || Boolean || Specifies whether only list items can be selected or any text is allowed as input. || |
| 130 | |
| 131 | [[Image(combobox.png, nolink, title="(left) A read-only combobox expanded. (right) A writeable combobox expanded.")]] |
| 132 | |
| 133 | A combo box allows you to make a single list choose but hide the list for the rest of the time. UI space is saved. |
| 134 | |
| 135 | '''Text Edit''' |
| 136 | || '''Selector''' || '''Type''' || '''Description''' || |
| 137 | || `theText` || String or Text || the contents of this editable widget || |
| 138 | || `readOnly` || Boolean || editable or not; selections work always || |
| 139 | || `outerBorderWidth` || Integer || width of the additional rounded outer border || |
| 140 | || `autoConvert` || Boolean || convert the contents as you type specified by a ''validation block'' || |
| 141 | || `autoAccept` || Boolean || always signals the changed contents as you type - no focus switch or return keypress needed || |
| 142 | || `validator` || Block || specifiy the validator; block accepts one parameter (the contents/text) and needs to return a String or Text || |
| 143 | |
| 144 | [[Image(textedit.png, nolink, title="Text edit with contents larger than the widgets -> vertical scrollbar appreas.")]] |
| 145 | |
| 146 | This widget improves the classic `PluggableTextMorph` as it supports a read-only mode, input validation, and [wiki:signals]. |
| 147 | |
| 148 | '''Line Edit''' ''(specialized Text Edit)'' |
| 149 | || '''Selector''' || '''Type''' || '''Description''' || |
| 150 | || `helpText` || String || non-selectable text that appear if no regular text is set || |
| 151 | |
| 152 | [[Image(lineedit.png, nolink, title="A line edit with no contents but the help text visible.")]] |
| 153 | |
| 154 | This widget supports only one line of editable text that scrolls automatically on the horizontal axis. |
| 155 | |
| 156 | |