dialog

A class of window that is suitable for displaying controls (also called widgets and dialog-items). Controls may actually be added to any window, but dialogs are the only windows that have special behavior for moving the keyboard focus among the controls. This behavior includes pressing the TAB key to move to the next widget, or pressing a letter key while holding down the ALT key to move to the widget whose label underlines that character. (To be precise, this behavior is defined on the non-instantiable dialog-mixin class, and dialog is the only built-in instantiable class that inherits this behavior.)

dialogs are often shown modally by calling pop-up-modal-dialog. When this is the purpose of a dialog, it is typically useful to specify the pop-up property of the dialog as true. This property coerces various other properties to their conventional values for modal dialogs. dialogs are created by calling make-window just as other windows are.

An application can draw on a dialog just as it would on other windows. Drawing that would intersect controls (or other child windows) will not cover the controls, and instead will appear to be covered by the controls.

See About how to get sample code for creating controls in cgide.htm, which explains how to use the IDE to create such code.

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.