| esf1edittext | ||
|---|---|---|
 | Chapter 16. The EPOC Simple Forms Type 1 Support |  |
This is an implementation of an editable text control. Currently multiline text is not supported and pressing the Enter key will result in the current line rolling up out of sight.
| Property | Type | Access | Description |
|---|---|---|---|
enabled | boolean | read-only | This is a boolean value that shows whether the control is enabled or not (a disabled control cannot hold focus or be clicked). |
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 .true.
|
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. |
ongotfocus | esf1event | read/write |
Contains a reference to the embedded esf1event that is raised when focus
is moved to the control.
|
onlostfocus | esf1event | read/write |
Contains a reference to the embedded esf1event that is raised when focus
is moved away from 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 esf1edittext type object. |
width | integer | read-only | The current width of the control. |
esf1edittextvar.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.
| |  | |
| esf1cbabutton |  | esf1event |
