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.