handle-cg-timer

Generic Function

Package: common-graphics

Arguments: window

A generic function that is called whenever the built-in timer returned by (cg-timer) fires. Normally, this timer is always active (but see use-cg-timer), and it calls this generic function to direct its timer messages to the currently selected window. Specifically, handle-cg-timer is first called on the selected-window of the screen. The default handle-cg-timer method then calls handle-cg-timer on that window's selected window, and this is done recursively over successive child windows until either a more specific handle-cg-timer method is called, or there is no further selected-window.

Common Graphics internally uses various handle-cg-timer methods on particular types of windows. Applications may also add handle-cg-timer methods for any of its window classes if it useful for such a window to receive timer messages only when it is the selected window (which is normally the window that has the keyboard focus). A set-focus method for the window class could set the interval of the (cg-timer) as appropriate for that window, since Common Graphics always sets the interval back as needed when using it internally.

See About the Common Graphics timer facility in cgide.htm.

Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.

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.