handle-cg-timer

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 is 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 cg-timers.htm for more information on timers.

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.