non-refreshing-window

A class of window that has a frame and automatically adds a child pane. This is a subclass of frame-with-single-child, indicating that by default a non-refreshing-window has a title-bar and a border as a frame-window does, and also that it automatically adds a frame-child pane window, in this case a non-refreshing-pane, and is therefore suitable when a toolbar or status-bar is to be added to the window.

The name "non-refreshing" means that the window does not automatically know how to redraw itself when it is uncovered, and so an application must supply a redisplay-window method (on the child pane class) that will be called whenever the window needs to be redrawn. This is actually the case of every window class except for bitmap-window and bitmap-pane (and text-edit-pane, because it is actually a control internally). If backing-store is desired for automatic redisplay, use a bitmap-window instead. When adding controls, a dialog is recommended.

A diagram of window and widget classes is shown in Widget and window classes in cgide.htm.

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.