| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |
Arguments: grid-widget row-section column-section row column &optional (row-number 0) (column-number 0)
Changes which cell in grid-widget has the
keyboard focus when the grid-widget itself has
the keyboard focus. The focus is indicated by a rectangle that's drawn
around the cell, unless the grid-widget's show-focus property has
been turned off. grid-widget should be an
instance of the grid-widget
control/class.
An application can call this function to change the focus cell
programmatically. Methods can also be added to catch whenever the
focus cell changes, because this generic function is always called
internally to change the focus cell when the user does so
interactively, typically by pressing the arrow keys or clicking a
cell. The built-in methods should not be overridden. An
:around
method avoids calling other methods if the
specified cell is already the current focus cell.
The four remaining required and two optional arguments should be specified as follows:
grid-row-section
instance that
contains the new focus-cell, and should be one of the row sections
that are returned if row-sections is called on
grid-widget. Row sections may alternately be
found by calling functions such as row-section or next-section.
grid-column-section
instance that
contains the new focus-cell, and should be one of the column sections
that are returned if column-sections is called on
grid-widget. Column sections may alternately be
found by calling functions such as column-section or next-section.
grid-row
instance that contains the
new focus-cell, and should be one of the rows that are returned if
subsections is
called on row-section. Rows may alternately be
found by calling functions such as subsection or next-subsection.
grid-column
instance that contains
the new focus-cell, and should be one of the columns that are returned
if subsections is
called on column-section. Columns may alternately
be found by calling functions such as subsection or next-subsection.
To find the cell that currently has the focus within a grid-widget
, call focus-cell.
See the description of the grid-widget
control/class.
Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.
| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |