Syntax of the START DIALOG instruction

Starts the instance of a declarative dialog.

Syntax

START DIALOG dialog-name

dialog-name is the identifier of a declarative DIALOG block.

Usage

The START DIALOG instruction starts the declarative dialog block identified by the name passed.

The current window/form will be used to attach form fields and action views to the variables and action handlers implemented in the referenced declarative dialog.

The START DIALOG does in fact register the specified dialog to be activated when the parallel dialog event loop executes.

The started dialog can be terminated with TERMINATE DIALOG.

Example

This example shows a START DIALOG instruction in a function that initializes a parallel dialog in a split view context:

FUNCTION params()
  IF ui.Window.forName("w_params") IS NULL THEN
     OPEN WINDOW w_params WITH FORM "parameters" ATTRIBUTES(TYPE=LEFT)
     LET params.user_name="Tom"
     LET params.auto_sync="Y"
     DISPLAY BY NAME params.*
     START DIALOG d_params_menu
  END IF 
  CURRENT WINDOW IS w_params
END FUNCTION