PropertyChanged Method

Tells ConceptDraw engine that the value of the specified property has been changed and the formulas of the dependent properties must be re-calculated.

Applies to objects: Shape

Syntax

object.PropertyChanged( propTag [, num[, geom]] )

The PropertyChanged method syntax has these parts:

Part Description
object Required. An expression that returns an instance of the Shape object.
propTag Required. An expression that returns a Long value. A tag that identifies the property of the object.
num Optional. An expression that returns a Long value. An additional identifying argument. It's used for specifying properties from collections of the object.
geom Optional. An expression that returns a Long value. An additional identifying argument. It's used for specifying properties from geometry collections of the object.

Remarks

ConceptDraw shapes are described by sets of properties which can have so called table formulas. Properties can be viewed or edited in the shape parameter table, called from a menu or using the F3 key in ConceptDraw. Each property is described by its value and a table formula.

This method is one of the methods of the Shape object, which allow to access the properties from a ConceptDraw Basic script. Such methods use three arguments for choosing the needed property: propTag, num, geom. Here, propTag is the tag that corresponds to the name of the property, and num and geom indicate the numbers of the properties in the collections. ConceptDraw Basic has a set of constants that define all possible property tags.

If the PropertyChanged method has been called after the StartRebuild method, the properties will be re-calculated on calling the EndRebuild method. Otherwise, they will be re-calculated immediately.

If the PropertyChanged method has been called from a user procedure, which in its turn has been called during re-calculation of a property, containing the table formula with functions _CALLTHIS, _CALLTHIS_1ARG or _CALLTHIS_2ARGS, the properties, depending on the property specified in PropertyChanged will be re-calculated as soon as the calculation of the property that called the user procedure is over.

 

See Also

GetByteProperty method, GetBooleanProperty method, GetIntegerProperty method, GetLongProperty method, GetSingleProperty method, GetDoubleProperty method, GetStringProperty method, ColorProperty method,
SetByteProperty method, SetBooleanProperty method, SetIntegerProperty method, SetLongProperty method, SetSingleProperty method, SetDoubleProperty method, SetStringProperty method, IsDefaultFormula method, IsNullFormula method, GetPropertyFormula method, SetPropertyFormula method, SetDefaultFormula method, SetNullFormula method, RecalcProperty method, PropertyChanged method , EndRebuild method, StartRebuild method