| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |
Arguments: dialog-item
Returns the value of the on-kill-focus event property of
dialog-item. The value of the on-kill-focus property should be a
function object or a function name (a symbol naming a function). This
function is called by the default kill-focus-event method when
keyboard focus leaves dialog-item. This function
should accept one argument, the dialog-item. The value may be nil
if no function need be run.
See also on-set-focus.
In general, do not move the keyboard focus from the parent dialog in an on-kill-focus handler, such as by calling select-window or pop-up-modal-dialog. The reason is that the on-kill-focus handler may be getting called due to the user clicking down on another widget, where the operating system may be waiting on the mouse button to be released, but the parent dialog will not receive the message for the mouse button release if the keyboard focus has been moved elsewhere.
See cg-events.htm for information about event handling in Common Graphics.
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 |