draw-focus

Arguments: widget

The functionality of this operator was changed when the plot-widget functionality was released in an update in Fall, 2008. The change is this generic function has methods on chart-or-plot rather than on chart-widget so that it also applies to plot-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.

Draw-focus for a multi-picture-button

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.

Draw-focus for a scrolling-static-text

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-2009, Franz Inc. Oakland, CA., USA. All rights reserved.
This page has had moderate revisions compared to the 8.0 page.
Created 2007.4.30.