grid-shift-focus

Function

Package: common-graphics

Arguments: grid-widget across-p forward-p section-p

Move the keyboard focus within grid-widget by one cell or one section.

The remaining arguments are booleans.

If across-p is true, then the focus is moved horizontally from one grid-column or column-section to another. If it is nil, the focus is moved vertically from one grid-row or row-section to another.

If forward-p is true, then the focus is moved either rightward (when across-p is true) or downward. When it is nil, the focus is moved either leftward or upward.

If section-p is true, then the focus is moved to the next grid-section. When it is nil, the focus is moved to the next cell within the current section. When moving into another grid-section, the focus is placed wherever it was most recently in that section, or else in the upper left cell if that section has not yet had the focus.

If there is no next cell or section in the requested direction, then the focus is not moved at all.

The arrow keys perform this functionality when a grid-widget has the keyboard focus, moving by sections rather than cells if the control key is being held down.

Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.

The documentation is described in introduction.htm and the index is in index.htm.

Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.

Created 2000.10.5.