Freeze

Description:              This statement freezes all or selected animated graphics in a window.

Returns:                    Nothing

Usage:                       Script or Steady State

Format:                      Freeze(Object, Scope, Mode)

Parameters:             Object    { object }  { required }  { no default: }

                                      Any expression for the object in the window that indicates the selected list to use.

                                    Scope    { Boolean }  { required }  { no default: }

                                      Any logical expression. If true, all graphics in the window are frozen. If false, only selected graphics in the window are frozen.

                                    Mode    { numeric }  { required }  { no default: }

                                      Any numerical expression that controls the freeze, as shown in the following table:

Mode

Control Action

0

Stop animation

1

Start animation

2

Toggle animation

 

Comments:               A graphical object that is frozen is no longer updated; it cannot be selected.

Example:

Freeze(Self() { Act upon graphics drawn by current module },

       1 { Freeze everything drawn by this module }, 

       0 { Stop the animation on the frozen objects }); 

See Also:

SelectArea | SelectGraphic | UnselectGraphics