sssetfirst

(sssetfirst pseudo_argument [sname])

The sssetfirst function hightlights and grips the entities of the selection set specified by sname in the graphics area.

The pseudo_argument argument is a legacy argument which lost its meaning.

The entities of sname are

• highlighted with dashed lines and gripped in the graphics area,
• preselected for the next modification command.

EntityGrips (EGrips) are selectable handles (displayed as small squares) at the end points, center, vertices, insertion points, and other geometric points of entities. The location of EntityGrips depends on the entity.

Arguments

pseudo_argument

Legacy argument which is always evaluated as nil. Can be of any type.

sname

Selection set or nil. The entities of this selection set are gripped, highlighted, and preselected.

Return Value

If the function succeeds, it returns a list containing nil as first item and the name of the selection set as second item; otherwise, it returns nil.

 Note: Use ssgetfirst function to retrieve the selection set with the entities that are highlighted and gripped.

Examples

: (setq selset (ssget))

Specify entities: <do so>

: (sssetfirst nil selset)

<Selection set: nnn>

: copy

Specify from point» <p1>

Specify second point» <p2>

Specify second point» <Enter>

Related Functions

ssgetfirst, ssget, ssadd, ssdel, ssname