acedSSName Function

C++

int acedSSName(
    const ads_name ss, 
    int i, 
    ads_name entres
);

File

acedads.h

Description

Returns the name of an entity, specified by its position in a selection set.

Warning Because of the potential size of selection sets, i must be a long integer. Declaring an index value as short (or as int on short-integer platforms) leads to disaster. A common error is coding the i argument as 0 to retrieve the set's first element. If you pass i as a constant, it must be followed by an L (as in 0L) to specify a long value.

Entity names in selection sets obtained with acedSSGet() are always the names of main entities. The acedSSName() function cannot obtain the names of subentities (such as block attributes and polyline vertices). The acdbEntNext() function obtains subentity names.

Note Only entities from the current drawing's model space and paper space, not nongraphical objects or entities in other block definitions, can be identified by acedSSName().

The acedSSName() function returns RTNORM if successful; otherwise, it returns an error code.

Parameters

Previous Declaration

int acedSSName(

const ads_name ss,

AdInt32 i,

ads_name entres

);