SelectArea

Description:              This function selects active graphics statements within a rectangular area in a window.

Returns:                    Numeric

Usage:                       Script or Steady State

Format:                      SelectArea(Object, Left, Bottom, Right, Top, MustContain)

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

                                      Any expression for the object value that identifies the window.

                                    Left     { numeric }  { required }  { no default }

                                      Any numeric expression for the left side coordinate of the area.

                                    Bottom     { numeric }  { required }  { no default }

                                      Any numeric expression for the bottom side coordinate of the area.

                                    Right     { numeric }  { required }  { no default }

                                      Any numeric expression for the right side coordinate of the area.

                                    Top     { numeric }  { required }  { no default }

                                      Any numeric expression for the top side coordinate of the area.

                                    MustContain     { Boolean }  { required }  { no default }

                                      Any logical expression. If true, an object will be selected only if it is completely enclosed by the area; otherwise, an object will be selected if any part of that object falls within the area.

Comments:               SelectArea is a function that returns the number of objects that have been found and selected within the defined area.