InputFocus


Input focus is a function that makes it possible to influence components in the graph from
the keyboard instead using the mouse. Most functions executed with cursor and mouse can also
be performed with the keyboard.

A component is selected with the arrow and Tab keys (or by clicking on it), to receive input
focus.
This means that all input from the keyboard are directed to the component. A pushbutton is, for
example activated by pressing Return, an option menu by selecting the desired alternative with
the arrow keys and pressing Return, a ValueInput by entering desired value and pressing Return.

Only components with the action type InputFocus can receive input focus, the exception is
ValueInput that also can receive input focus by clicking on it.

You shift input focus between components with the arrow keys or the tab key. The order of the
components are configured by linking them in three lists, one horizontal, one vertical and one
Tab list. In the horizontal list you move with the ArrowLeft and ArrowRight keys, in the
vertical with the ArrowUp and ArrowDown, and in the Tab list with the Tab key. This is
configured with the attributes InitialFocus, NextHorizontal, NextVertical and NextTab. In
InitialFocus you can state that an object is first or last in a list. You can also state that
a component should receive input focus when the graph is opened. In NextHorizontal,
NextVertical and NextTab you specify the object name of the next component in the lists.

You use to divide the components in Tab groups. Between the objects within a Tab group you
navigate with the arrow keys, and between Tab groups you navigate with the Tab key. This is
achieved by setting NextTab for all the objects in one Tab group, to the first object in the
next Tab group.

Attribute                               Description
InputFocus.InitalFocus                       Bitmask with the following bits:
                                      - InitialFocus The component has input focus when
                                       the graph is opened.
                                      - FirstHorizontal The object is the first object in
                                       the horizontal list.
                                      - FirstVertical The object is the first object in
                                       the vertical list.
                                      - FirstTab The object is the first object in the
                                       Tab list.
                                      - LastHorizontal The component is the last object
                                       in the horizontal list.
                                      - LastVertical The component is the last object in
                                       the vertical list.
InputFocus.NextHorizontal                       Object name of the next component in the
                      horizontal list.
InputFocus.NextVertical                       Object name of the next component in the
                      vertical list.
InputFocus.NextTab                       Object name of the next component in the
                      Tab list.