dev_update_vardev_update_varDevUpdateVarDevUpdateVar (Operator)

Name

dev_update_vardev_update_varDevUpdateVarDevUpdateVar — Switches the update of the variable window during program execution on or off.

Signature

dev_update_var( : : DisplayMode : )

Description

dev_update_vardev_update_varDevUpdateVarDevUpdateVarDevUpdateVar specifies the behaviour of the variable window during program execution. If DisplayModeDisplayModeDisplayModeDisplayModedisplayMode is set to 'on'"on""on""on""on", which is the default, the contents of the variable window (iconic and control variables) is updated each time a variable is modified by the program.

If the mode is 'off'"off""off""off""off" the values of the control variables and the icons of the iconic variables are not updated before the execution stops.

For measuring the execution time of a sequence of operators all update options should be switched off in order to reduce the influence of the runtime of GUI updates in HDevelop. For this the operators dev_update_pcdev_update_pcDevUpdatePcDevUpdatePcDevUpdatePc, dev_update_timedev_update_timeDevUpdateTimeDevUpdateTimeDevUpdateTime, dev_update_vardev_update_varDevUpdateVarDevUpdateVarDevUpdateVar, and dev_update_windowdev_update_windowDevUpdateWindowDevUpdateWindowDevUpdateWindow or the procedures dev_update_on and dev_update_off can be used.

This option can also be controlled via the Preferences dialog: Edit -> Preferences -> Runtime Settings -> Update Variables.

Attention

This operator is not supported for code export.

Parameters

DisplayModeDisplayModeDisplayModeDisplayModedisplayMode (input_control) string → (string)

Mode for graphic output.

Default value: 'off' "off" "off" "off" "off"

List of values: 'off'"off""off""off""off", 'on'"on""on""on""on"

Result

If the values of the specified parameters are correct, dev_update_vardev_update_varDevUpdateVarDevUpdateVarDevUpdateVar returns 2 (H_MSG_TRUE). Otherwise, an exception is raised and an error code returned.

Module

Foundation