acedSSSetFirst

C++

int acedSSSetFirst(
    const ads_name pset, 
    const ads_name unused
);

File

acedads.h

Description

This function sets which objects are selected and gripped.

The parameters have the following data type definition:

typedef long ads_name[2];

The selection set of objects specified by the gset argument are gripped, and the selection set of objects specified by pset are both gripped and selected. If any objects are common to both selection sets, acedSSSetFirst() grips and selects the selection set specified by pset only (it does not grip the gset set).

If gset is NULL and pset is specified, acedSSSetFirst() grips and selects pset. If gset and pset are NULL, acedSSSetFirst() turns off any existing grips and selections.

You are responsible for creating a valid selection set. For example, you may need to verify that a background paper space viewport (DXF group code 69) is not included in the selection set. You may also need to ensure that selected objects belong to the current layout.

Note The addCommand() optional flags ACRX_CMD_USEPICKSET and ACRX_CMD_REDRAW must be used in order for acedSSSetFirst() to work.

Do not call acedSSSetFirst() when AutoCAD is in the middle of executing a command.

Parameters