SelectStates

Description:              This statement selects states in a state diagram within an area.

Returns:                    Pointer

Usage:                       Script

Format:                      SelectStates(StateDiagram, Left, Bottom, Right, Top, MustContain)

Parameters:             StateDiagram    { StateDiagram }  { required }  { no default: }

                                      Any expression for the state diagram value.

                                    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, a state will be selected only if it is completely enclosed by the area; otherwise, a state will be selected if any part of that state falls within the area.

Comments:               This function may only appear in a script.