on-kill-focus

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.

Warning

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.