| esf1text | ||
|---|---|---|
 | Chapter 16. The EPOC Simple Forms Type 1 Support |  |
This is an implementation of an non-editable text control. Currently multiline text is not supported.
| Property | Type | Access | Description |
|---|---|---|---|
enabled | boolean | read-only | This is a boolean value that shows whether the control is enabled or not (a disabled esf1text control displays in grey, no other effect occurs since they can't receive focus anyway). |
focusable | boolean | read-only |
This is a boolean value that shows whether this type of control can have focus. For
this object type it is always set to .false.
|
form | esf1 | read-only | Contains a reference to the form (if any) to which the control is attached. |
height | integer | read-only | The current height of the control. |
left | integer | read-only | The current horizontal position of the upper left corner of the control. |
next | esf1control | read-only | Contains a reference to the next control in the ring of controls on the form. |
text | string | read-only | The current text in the control. |
top | integer | read-only | The current vertical position of the upper left corner of the control. |
type | type | read-only | Contains a reference to the esf1text type object. |
width | integer | read-only | The current width of the control. |
esf1textvar.move (
integer lefttopwidthheighterror
Moves the control. For each of left, top, width and height the default
value is the current value. An error object can be provided to catch
errors. The new position must be within the bounds of the form or an
error is raised (or output in the error object). Returns .nul.
By using the position name, such as foo.move(top=5) only
the top position will be changed, all others remain the same because they
default to their current value.
| Name | Default | Type | Description |
|---|---|---|---|
left | Current left position | integer | The new horizontal position of the upper left corner of the control. |
top | Current top position | integer | The new vertical position of the upper left corner of the control. |
width | Current control width | integer | The new width of the control. |
height | Current control height | integer | The new height of the control. |
error | none | integer | This parameter must be an object, not an integer value. If an error (other than a syntax or parameter passing error) occurs because the new object position is not completely within the form, then the error number will be output to the specified object. If no error object is provided and an error occurs then the program will exit with an unhandled exception. |
Removes the control from the ring of controls. A removed control cannot hold focus and is not displayed.
Moves or inserts this control into the ring of controls in a position so that its 'next' will be the specified control. This also determines the tab order.
| |  | |
| esf1event |  | Appendix A. Error Codes |
