Class XbpSLE() Foundation
Class function of the XbpSLE class.
The XbpSLE class provides objects that manage individual text entry fields (single-line edit fields). These are rectangular screen areas for keyboard input that allow character strings stored in the edit buffer of the XbpSLE object to be created or edited. The cursor marks the location within the character string where characters are inserted or overwritten.
An XbpSLE object can edit only character strings. It includes an edit buffer that is limited to 32 characters by default. When the character string being edited might contain more than 32 characters, the edit buffer must be dimensioned using the :bufferLength instance variable. The buffer can have a maximum size of 64kB characters (this limit is imposed by OS/2).
The XbpSLE object independently processes keyboard entries. The keys that are used to input ASCII characters are copied into the edit buffer while some other specific keys are automatically processed (such as the Insert and Delete keys). The following table lists the keys that receive special processing by the XbpSLE object along with action caused by each key:
Key | Description |
---|---|
Left Arrow | Move cursor one character to the left |
Right Arrow | Move cursor one character to the right |
Shift+Left Arrow | Select one character to the left |
Shift+Right Arrow | Select one character to the right |
Up Arrow | Ignored |
Down Arrow | Ignored |
Home | Go to the start of the edit buffer |
End | Go to the end of the edit buffer |
Backspace | Delete the character to the left of the cursor |
Shift+Insert | Delete selected characters and replace them with the characters stored in the clipboard |
Ctrl+Insert | Copy marked characters to the clipboard |
Delete | Delete the character to the right of cursor or delete selected characters without copying them to the clipboard |
Shift+Delete | Delete selected characters and copy them to the clipboard |
Ctrl+Delete | Delete characters marked in the edit buffer without copying them to the clipboard |
Return | Ignored |
Esc | Ignored |
Page Up | Ignored |
Page Down | Ignored |
Shift+Tab | Transfer input focus to the previous Xbase Part |
Tab | Transfer the input focus to the next Xbase Part |
Others | Other keys containing ASCII characters are copied to the edit buffer as characters |
An XbpSLE object can only edit character strings. Blank spaces at the end of character strings are not automatically deleted but are treated like any other character. If the edit buffer of an XbpSLE object is filled with blank spaces (Chr(32)), no additional characters can be added. In this case, characters must be deleted from the edit buffer before new characters can be added.
The instance variables in this group configure system resources. If changes are made to these values, they must either be made before the :create() method is executed or the :configure() method must be used to activate the changes.
If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.