Function Entry: SSSETFIRST

← Prev | ↑ Chapter | Next → | Index | Symbols

Function Entry: SSSETFIRST

Name

sssetfirst

Class

Function

Syntax

(sssetfirst gripset [pickset])

Arguments and Values

  • gripset: ignored. Pass nil. With no pickset and gripset = nil, sssetfirst clears any previous grip and selection state set by an earlier call.
  • pickset (optional): a selection set; objects to be selected and gripped.

Description

Programmatically selects objects and shows their grip handles. The grip-set parameter is no longer honoured because AutoCAD discontinued grips on unselected objects. Do not call this function while AutoCAD is in the middle of a command — the call is for use between commands.

Return Values

A list naming the selection-set arguments.

Side Effects

Replaces the current selection set and grip state with pickset.

Examples

Given pickset1 and pickset2 from prior entmake / ssadd calls:

  • (sssetfirst nil pickset1) returns (nil <Selection set: a5>).
  • (sssetfirst nil pickset2) returns (nil <Selection set: ab>).

Availability

  • AutoCAD 2026: documented.
  • BricsCAD V26: presumed compatible.
  • Status: AutoCAD documented; BricsCAD presumed-both pending Phase 4 verification.

Source Notes