2024 December Release

COOSYSTEM@1.1:attruichangeexpr Permanent link for this heading

Expression for Handling Changes of Values

This expression is evaluated for a property on an application view for displaying values.
It can be defined in order to trigger the re-evaluation of filter constraints or to set or clear the values of other properties.
It gets evaluated when the value of the property gets changed i.e. when the focus leaves the control.
If an error occurs during evaluation, the error is displayed in UI.
The expression is ignored, if the valuetype of the application view is query mode,
instead the attruisearchchangeexpr expression is evaluated for the property if exists.
A return value is not required


Explanation:
Defines an app.ducx expression that handles the change of a value of the property in the user interface (see also attruichangeexpr).

string[] COOSYSTEM@1.1:attruichangeexpr readonly(inst)(
  object ::root,
  AttributeDefinition ::attribute,
  any ::parent,
  any ::value,
  boolean ::isvalue,
  boolean ::isedit,
  boolean ::iseditcommon,
  boolean ::isdashboard,
  boolean ::iscalccelledit,
  boolean ::issingleattribute,
  Action ::context)

Local Scope: dictionary
Global Scope: dictionary

Name

Description

::root

contains the object the expression is evaluated for. ::root is identical to cooobj.

::attribute

contains the property the expression is evaluated for.

::parent

the parent of cooobj.

::value

the current value of the property.

::isvalue

contains true if the form is used for displaying values (edit mode or read-only mode) opposed to query mode (see valuetype in ApplicationView).

::isedit

contains true if the form is in edit mode opposed to read-only mode (see edittype in ApplicationView). ::isedit is only valid if ::isvalue is true.

::iseditcommon

contains true if the form is used to edit common properties of multiple objects. ::iseditcommon is only valid if ::isvalue is true. In this case ::root/cooobj refer to the first object of the selection.

::isdashboard

contains true if the property is displayed in a dashboard.

::iscalccelledit

contains true if the property is displayed while editing in a cell (F2).

::issingleattribute

contains true if the property is displayed in single attribute mode, i. e. when all other properties of a form page are hidden.

::context