[Contents] [Index] [Next] [Previous]

List


Description

A List should be used to present a list of elements for selection. The List elements can be selected using either the single selection model, the browse selection model, the multiple selection model, or the discontiguous selection model. This component must be composed of an area for presenting a list of text or graphics elements. It can optionally have vertical and horizontal ScrollBars, which show different views of the List elements.

The location cursor in a List should differentiate between normal mode and add mode. The location cursor should be a solid box in normal mode and a dashed box in add mode.

Illustration

Navigation

The following text describes the navigation actions of this component:

Must move the location cursor to the first item in the List.
Must move the location cursor to the last item in the List.
Must move the location cursor to the previous item in the List.
Must move the location cursor to the next item in the List.
In a scrollable List, must move the location cursor to the item one page down in the List.
In a scrollable List, must move the location cursor to the item one page up in the List.

Other Operations

The following text describes the operations of this component:

BSelect Click 2
Must select the current List item and cause any default action for the window to occur.
In a scrollable List, must move the horizontal scroll region so that the leftmost edge of the List is visible.
In a scrollable List, must move the horizontal scroll region so that the rightmost edge of the List is visible.
In a scrollable List, must scroll the List one character to the left.
<PageLeft> or
In a scrollable List, must scroll the List one page to the left.
In a scrollable List, must scroll the List one character to the right.
<PageRight> or
In a scrollable List, must scroll the List one page to the right.
Must provide any available help for the List.

Related Information

For more information on List element selection, see the description of the selection models in Selection. For more information about the ScrollBars, see the reference page for ScrollBar.