acedSSGetFirst

C++

int acedSSGetFirst(
    struct resbuf** gset, 
    struct resbuf** pset
);

File

acedads.h

Description

Determines which objects are selected and gripped.

The addCommand() optional flags ACRX_CMD_USEPICKSET and ACRX_CMD_REDRAWmust be used in order for acedSSGetFirst() to work.

Note Only entities from the current drawing's model space and paper space, not nongraphical objects or entities in other block definitions, can be analyzed by this function.

acedSSGetFirst() returns RTNORM or RTREJ.

Warning To avoid a memory leak in the program, be sure that the contents of gset and pset do not point to resbufs before calling acedSSGetFirst().

Call acedSSFree() to deallocate memory allocated for the returned selection sets. Call acutRelRb() to deallocate memory allocated for the resbufs. You must release the allocated selection set after you are finished with processing the selection. If you fail to do this the selection set will be kept on the stack until AutoCAD terminates. Since AutoCAD can only hold 128 application-based selection sets per session, the unreleased selection sets can result in failed object selections through ObjectARX.

Parameters