| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |
Arguments: widget
draw-focus returns whether a
focus rectangle is drawn in a multi-picture-button
, picture-button
, static-picture
, scrolling-static-text
, or chart-or-plot
. The value may
be set at creation time by passing the draw-focus
initarg, or any time later by calling (setf draw-focus).
The value may be true or nil
. The default is
t
except for multi-picture-button
, where it is nil
.
If true, then when the widget has the keyboard focus it draws a focus rectangle around the particular button that has the focus within the widget. Pressing the spacebar will then press or unpress that button. The arrow keys will move the focus to other buttons, scrolling as needed, and clicking on a button will move the focus to that button.
If nil
, then no focus rectangle is drawn, and
pressing the spacebar will not press a button because no particular
button has the keyboard focus. Clicking the mouse on buttons will
still press and unpress them.
When the draw-focus property
of a scrolling-static-text
is true and the widget has the keyboard focus, then a focus rectangle
is drawn that overrides the rectangle that would be drawn by the
border-color property, if any.
This focus rectangle will use the system-edge-shadow-color unless the usual
border-color is that same
color, in which case the focus rectangle will be black
.
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 |