This widget lets the end user enter text in a box to modify the content of a string object.
Remark: you can change the text properties of this widget just like for any other cell. (Note that in v1.4 only it does not inherit the current cell properties and uses the default system font instead)
See Attributes Common to Widgets.
Name | Value Type | Default Value | Description | Comment | V. | Exp. |
---|---|---|---|---|---|---|
string_id |
string id |
empty |
id of the string object to display and edit. |
|
1.4 |
No |
change_on_type |
false |
modification transmission behavior of the widget. |
when true changes are applied to the string while typing, else changes are applied only when the user hits return or when the widget loses focus. |
1.4 |
No | |
text_color |
system default |
color of the text displayed by the widget. |
|
1.4 |
No | |
background_color |
system default |
background color of the widget. |
|
1.4 |
No | |
background_edit_color |
background_color |
background color of the widget when editing the text. |
This feature is only available on Windows Vista. On other versions it is the same as the background color. |
1.4 |
No | |
show_edges |
true |
show/hide 3D edges of the system control. |
When using custom colors you will want to remove the edges as their colors cannot be customized - windows only (deprecated). |
1.4 |
No |