Dialog

The Dialog class is the base class of dialog windows. A dialog window is a top-level window mostly used for short-term tasks and brief communications with the user. Dialogs may be modal or modeless.
  • caption : String; This property holds the window caption (title). The default is the application's name.

  • cancelButtonText : String; This property holds the text shown on the cancel button. The default is "Cancel".

  • okButtonText: String; This property holds the text shown on the ok button. The default is "Ok".

  • width : Number; This property holds the width of the widget excluding any window frame. The default is set by the layout.

  • tooltip : String; This property holds the tool tip (balloon help) for the widget.

  • whatsThis : String; This property holds a simple description of the widget.

  • add( widget : QSWidget ); Adds a widget to the dialog. Widgets are placed vertically, from top to bottom.

  • addSpace( space : Number ); Adds vertical space, measured in pixels between, the previous and next added widget.

  • exec() : Boolean; Executes the dialog. This opens the dialog as a modal dialog, blocking the application until the user presses the OK button or the Cancel button to close the dialog. The function returns true of the user pressed OK; otherwise it returns false.

  • newColumn(); Creates a new column in the dialog. All widgets subsequently added to the dialog will be placed (vertically, from top to bottom), in the new column.

  • newTab( label : String ); Creates a new tab in the dialog with the given label. All widgets subsequently added to the dialog will be placed in the newly created tab, (vertically, from top to bottom).