frame-window

A class of window that by default has a border, scrollbars, and a title-bar with the standard small buttons for iconizing, maximizing, and closing the window. Otherwise a frame-window is a general window similar to a basic-pane. Despite the name, which might suggest that the window is useful only for adding a frame around other windows, a frame-window can be drawn on directly.

This class is suitable to use as the superclass of custom application window classes that have borders and titlebars. frame-windows are also resizable by default, though this can be overridden, for example, by explicitly passing the resizable keyword argument to make-window as nil, or by specifying the :resizable :default-initarg of a subclass as nil. Any other window attributes that a particular window class provides by default may be turned off similarly, or additional attributes added.

For windows that are also to have a toolbar or status-bar, the non-refreshing-window class is recommended instead due to its frame-with-single-child properties that accomodate toolbars and status-bars. If backing-store is desired, instead use a bitmap-pane or bitmap-window. 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.