3.3.2.56 Selection

Selection-cmd

Object selection management. This command is used in the Object Edit toolbar.

Syntax:

select [option] value

Options:

-a; Align objects according to the specified parameter

Syntax: select -a param

Align objects according to the specified param(eter). parameter values: t = top, b = bottom, l = left, r = right, c = center horizontally, v = center vertically, w = same width, h = same height, and s = same style.

select -a w; //Set the same width for the selected object.

-c; Set the index line and fill colors

Syntax: select -c param

Index line and fill colors. Cycle the param colors: l = line and f = fill.

/Change the Fill Color to the next according to the index order.
select -c f; /

-f s; Increase or decrease the font size of all selected text labels

Syntax: select -f s value

Increase (value) or decrease (-value) the font size of all selected text labels. For example, if value = 4, increase the font size of all selected text labels by a value of four. Thus, if the original font size was 18, the font size will increase to 22.

select -f s 18; //Set the font size of specified text label as 18.

-g;Get the selected object name into the %char string variable

Syntax: select -g char

Get the selected object name into the %char string variable.

select -g F; 
%F=;  //Get the selected object name.

-h; Adjust a arrow head angle or length

Syntax: select -h param val

Adjust an arrow head. param = angle or param = length. val is the amount to adjust the arrow head angle or length. Positive values increase the angle or length. Negative values decrease the angle or length. The default step value used by the Object Edit tool is 5.

select -h angle 30; //Set the angle of the arrow head to 30.

-o; Set object drawing order

Syntax: select -o order

Set object drawing order. Possible values for order are: front, back, data 0 (in front of data plots), and data 1 (behind data plots). This option determines which objects are drawn on top of others. For RTM objects, this also determines the processing order for the objects.

See the Example 1.

-rg; Group the selected objects

Syntax: select -rg

Group the selected objects.

-ru; Ungroup the selected object

Syntax: select -ru

Ungroup the selected object. The selected object must be a grouped object.

-t; Set the orientation of a line or arrow to the horizontal or vertical

Syntax: select -t direction

Snap the orientation of a line or arrow to the horizontal or vertical.

direction = vertical

direction = horizontal

See the Example 4.

Examples:

Example 1

The following script draws the object(s) in front of the data.

select -o data 0;

Example 2

The next script aligns the center of the objects in a horizontal line.

select -a center;

Example 3

The next script gets the selected object's name into %A.

select -g A;

Example 4

The next script snaps the selected line(s) to a vertical orientation.

select -t v;

Example 5

The last script decreases the angle of the selected arrowhead by 10 units.

select -h angle -10;