1C:Enterprise | 1C:Enterprise Developer's Community

Form.AttachDataChangeHandler

Syntax:

AttachDataChangeHandler(<DataName>, <ProcedureName>, <TrackSubordinateData>)

Parameters:

<DataName> (required)

Type: String.
Name of data (data path), to which any modifications must be tracked. This can show data connected with form attributes, table section, and subordinate data, i.e. attributes of these objects. For example, "Attribute1.Description".
The setting can contain only one data path, i.e. the method is used for one attribute.

<ProcedureName> (required)

Type: String.
Name of procedure enabled as data modification handler. Procedure should have one parameter so that, when enabled, the procedure will transmit the string, i.e. path to the modified data, using a structure similar to the <DataName> setting.

<TrackSubordinateData> (optional)

Type: Boolean.
Defines whether or not the handler procedure must be enabled when modifying data subordinate to that assigned in the <DataName> setting, e.g. when modifying the data attributes.
Default value: False.

Description:

Turns on the handler procedure that was activated previously when modifying the specified data in the form or subordinate forms.

Availability:

Thick client.

Example:

AttachDataChangeHandler("TextBox1", "OnChange");