[Contents]
[Index]
[Next]
[Previous]
Text
Description
A Text component should be used to display and enter text. A Text
component must be composed of an area for displaying and entering
text. The text can be either a single line or multiple lines. Text
must support the range selection model as described in Selection and can support the discontiguous
selection model.
Illustration
Navigation
The following text describes the navigation actions of this
component:
- In multiline Text components,
must
move the location cursor up one line. In single-line Text components,
must navigate upward to the previous
component if the Text component is designed to act like a basic
control.
- In multiline Text components,
must move the location cursor down one line. In single-line Text
components,
must navigate downward to
the next component if the Text component is designed to act like a
basic control.
- Must move the location cursor left one character.
- Must move the location cursor right one character.
- In multiline Text components,
must move the location cursor up one page.
- In multiline Text components,
must move the location cursor down one page.
- <PageLeft> or

- Must move the location cursor left one page.
- <PageRight> or

- Must move the location cursor right one page.
- In a Text component used generally to hold multiple words, must
move the location cursor to the right by a word. That is,
must place the
location cursor before the first character that is not a space, tab,
or newline character after the next space, tab, or newline character.
In short single-line Text controls,
can navigate rightward to the next component
if the Text is designed to act like a basic control.
- In a Text component used generally to hold multiple words, must
move the location cursor to the left by a word. That is,
must place the
location cursor after the first space, tab, or newline character
preceding the first previous character that is not a space, tab, or
newline. In short single-line Text controls,
can navigate
leftward to the next component if the Text is designed to act like a
basic control.
- In multiline Text components,
can optionally move the location cursor
to the beginning of the next paragraph.
- In multiline Text components,
can optionally move the location cursor to
the beginning of the previous paragraph.
- In a Text component used generally to hold multiple words, must
move the location cursor to the beginning of the line.
- In a Text component used generally to hold multiple words, must
move the location cursor to the end of the line.
- In multiline Text components,
must move the location cursor to the
beginning of the file.

- In multiline Text components,
must move the location cursor to the end
of the file.
Other Operations
The following text describes the operations of this component:
or
- Must insert a space. Modifying these with
must evoke its normal selection function.
- In multiline Text components,
must insert a carriage return.
and
<Enter>
- Must invoke the default action.
and
- In multiline Text,
must be used
for tabbing (either inserting a tab or moving to the next tab stop).
In single-line Text,
must be used either
for tabbing or to move to the next field. If
is used for tabbing and the location cursor is
at the end of the text,
can optionally
move to the next field.
must be
used to move to the previous field if
is
used to move to the next field. Otherwise,
should be used
for tabbing backward. If
is used for tabbing backward and the location
cursor is at the beginning of the text,
can optionally move to the previous
field.
Modifying
or
with
must evoke the same field navigation function
as
or
.
- <BackSpace>
- When the selection is empty or when the component is in add
mode with the cursor disjoint from the selection,
[BackSpace] must delete one character backward.
Otherwise, [BackSpace] must delete the selection.
- When the selection is empty or when the component is in add
mode with the cursor disjoint from the selection,
must delete one character forward.
Otherwise,
must delete the selection.
- When the selection is empty or when the component is in add
mode with the cursor disjoint from the selection,
can delete
the character following the location cursor to the end of the line.
Otherwise,
can delete the selection.
- If the Text component supports replace mode, must toggle
between insert mode and replace mode.
By default, Text components must start in insert mode, where the
location cursor is between two characters. In insert mode, typing a
character must insert the character at the position of the location
cursor. Text components can also implement replace mode, where the
location cursor is on a character. In replace mode, typing a
character must replace the current character with that newly entered
character and move the location cursor to the next character,
selecting it. Many of the requirements for a text-like collection in
this guide assume that the collection is in insert mode and do not
apply in replace mode.
- BSelect
Click
2+
- Selects text a block at a time. A double-click must select
text a word at a time. A triple-click can optionally select text a
line or sentence at a time. Larger numbers of clicks can optionally
select increasingly larger blocks of text.
- BSelect
Motion
2+
- Can drag out a new selection by blocks as described for BSelect
Click
2+.
BSelect
Click
2+
- Can extend the selection to a block boundary as described for
BSelect
Click
2+.
BSelect
Motion
2+
- Can extend the selection by blocks as described for BSelect Click
2+.
BSelect
Click
2+
- If the Text component supports discontiguous selection, this
can extend the discontiguous selection by blocks as described for BSelect
Click
2+.
BSelect
Motion
2+
- If the Text component supports discontiguous selection, this
can drag out the discontiguous selection by blocks as described for BSelect
Click
2+.
- Must provide any available help for the Text control.
Related Information
For more information on Text selection, see the description of the
selection models in Selection.