Name

OpenDialog — Opens a Dialog with options

Synopsis

boolean OpenDialog ( term options ,
  term widget );
 

Parameters

term options

term widget

Return

boolean

true if success, false if error

Description

Same as the OpenDialog with one argument, but you can specify options with a term of the form `opt.

The `mainDialog option creates a "main window" dialog: The dialog will get a large "default size". In the Qt UI, this typically means 800x600 pixels large (or using a -geometry command line argument if present) or full screen. In the NCurses UI, this is always full screen.

`defaultsize is an alias for `mainDialog.

`wizardDialog is a main dialog that will contain a wizard widget. For UIs that don't support this kind of specialized dialog, this is equivalent to `mainDialog -- see also the HasWizardDialogSupport entry of the map returned by UI::GetDisplayInfo().

The `warncolor option displays the entire dialog in a bright warning color.

The `infocolor option displays the dialog in a color scheme that is distinct from the normal colors, but not as bright as warncolor.

The `decorated option is now obsolete, but still accepted to keep old code working.

The `centered option is now obsolete, but still accepted to keep old code working.

Usage

  OpenDialog( `opt( `defaultsize ), `Label( "Hello, World!" ) )