Please enable JavaScript to view this site.

A-Shell Consolidated Reference

Updated August 2015; see History

A "modeless" dialog is like a Modal Dialog Box Control except that it does not command the focus and does suspend the operation of the main program or other dialogs). To create, use MBF_DIALOG+MBF_MODELESS. The ending row and column of a modeless dialog may be beyond the limits of the screen or window. These dialogs are mainly useful for displaying information that is not critical to the main window, allowing the user to push it out of the way if desired.

Unlike a modal dialog, a modeless dialog can be minimized, in which case it sits just above the Task Bar rather than within it.

See the sample program DLGMODLES in EXLIB:[908,20] for an example of creating and managing a modeless dialog.

History

2015 May, A-Shell 6.1.1408: AUI refinement: when a modeless dialog is created in an initial minimized or maximized state (see cstate), the min/max buttons MBF2_MINBUTTON and MBF_MAXBUTTON are now automatically added. This is a follow-up revision to 1402.7 which removed the buttons when the corresponding flags were not specified, but it doesn't make sense to create a minimized or maximized dialog without buttons to normalize it.