1.2

Determines the next selected entity and makes it current.

extern "C" vbool WINAPI VCNextSelected(short* iError, short* bKind);

function VCNextSelected(var iError: Smallint; var bKind: Smallint):Wordbool;

Function NextSelected() As Integer

bKind - set by the function to what type of entity is now current.

0 if not successful and 1 otherwise.
ActiveX/COM returns the entity kind (UNKNOWN if not successful)

0 - Success
1 - Invalid world

Whenever querying entities for their particular properties, it is necessary to have a method to step through the drawing database and select which entity a given query will focus on. The API offer several utility parsing methods for flexibility in locating entities in the database. Each offers advantages in certain situations. VCFirst/NextEntity move through each entity in the drawing database. VCFirst/NextEntityExpand parses the database as if the drawing file had been exploded. Every entity, including those in symbol definition and hatch patterns are included in the search. VCFirst/NextOnScreen clip the drawing and allow for quick entity access to only those entities found in the current zoom. VCFirst/NextSelected parse only through the selection set. This method combined with a selection filter allow access to specific entities meeting a set of criteria quickly in the drawing database. If no entities exist for the method, the return value will be a 0 and the code can handle this case accordingly.

The VCFirst/Next functions operate relative to the current entity.  If code which uses VCFirst/Next in a loop changes the current entity, it is important that the current entity be reset to the entity returned by the previous VCFirst/Next call.

VCGetCurrentEntityHandle, VCNextEntity, VCLastEntity, VCFirstEntityExpand, VCNextEntityExpand, VCFirstEntity, VCNextOnScreen, VCFirstSelected, VCFirstEntity, VCSetCurrentEntity