on-mouse-out

Generic Function

Package: common-graphics

Arguments: dialog-item

Returns the value of the on-mouse-out event handler for the argument control. The value of the on-mouse-out property should be a function object or a function name (a symbol naming a function). This function is called when the mouse cursor is moved out of the control's rectangular area. on-mouse-out may be nil if no function need be run.

If an on-mouse-out function is supplied, it should take two arguments, which are (1) the control and (2) the mouse-button-state at the time the mouse moved into the control. The return value does not matter.

Many functions take a button-state argument. This argument is a single integer that tells what combination of mouse buttons and shift keys when the message that is being handled occurred. Each mouse button or shift key is represented by a constant that has a single bit flagged, and so bit tests on the button-state argument can be used to tell whether particular mouse buttons or shift keys were down. The particular constants are left-mouse-button, middle-mouse-button, right-mouse-button, shift-key, control-key, and alt-key.

See also on-mouse-in.

Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm. See also About event handling in the IDE in that document.

The documentation is described in introduction.htm and the index is in index.htm.

Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.

Created 2000.10.5.