Plot.DrawEnableAutoUpdate

Prototypes

void DrawEnableAutoUpdate( <boolean bAutoUpdate> )

Parameters

boolean bAutoUpdate
If bAutoUpdate is true, the plot will automatically mark itself as needing to be redrawn each time it receives a new drawing command. If bAutoUpdate is false, the plot will not mark itself as needing to be redrawn when it receives a new drawing command. Calling this method without specifying the bAutoUpdate parameter is equivalent to calling it with bAutoUpdate equal to true.

Remarks

By default, when a plot receives a new drawing command, it marks itself as needing to be redrawn. The actual timing of screen redrawing is controlled by Windows. If you have a program that contains hundreds of drawing commands, repeated screen redrawing can become time-consuming and annoying. To solve this problem, call DrawEnableAutoUpdate( false ) before making the drawing calls and then call DrawEnableAutoUpdate() afterwards. The plot will only redraw once.

Example

x = { 1 2 3 4 5 6 7 8 };
y = { 2 1 4 5 6 5 6 9 };
declare ScatterPlot plot;
plot = ScatterPlot.Create( "Sample Data", x, y );
plot.DrawEnableAutoUpdate( false );
plot.DrawUseDataCoordinates();
do i = 1 to ncol(x);
    do r = 0 to 1 by 0.05;
        plot.DrawArc( x[i], y[i], r, 0, 360 );
    end;
end;
plot.DrawEnableAutoUpdate();