CimGraphControl.AutoUpdate (property)

Indicates whether the control automatically updates its region.
Syntax: Boolean = object.AutoUpdate
object.AutoUpdate = Boolean
Description: CimGraphControl.AutoUpdate indicates if the chart automatically invalidates its region when properties are changed. The control redraws graphically when its region is invalidated.

When the property value is set to False, the control does not invalidate its region when properties are changed. This means that if you change, for example, a title's font, changes will not be redrawn until the control is invalidated by either invoking Update or by moving another window over the control's region.

When the property value is set to True, the control automatically invalidates its region when properties are changed.

This property is particularly useful when making several changes to properties through scripting. This is because it prevents the control from redrawing every single property change. The control redraws after all changes are made.

The value of this property defaults to True.

Example

The following CimView script excerpt disables automatic updates, changes properties and then enables automatic updates:
cimOleObj.AutoUpdate = False
cimOleObj.Title ="XY Plot"
Dim YAxis As CimAxis
Set YAxis = cimOleObj.Y.Add("Y Axis")
YAxis.Title = "Y Axis"
cimOleObj.AutoUpdate = True