Retrieves the handle for an object—used with pipObjectFileGoTo.
Syntax
intl pipObjectGetHandle ( pipObjectFile obj_h );
Arguments
obj_h The handle of the opened object file. Input.
Return Value
Handle of the current object, or -1 if no current object.
Prerequisites
pipObjectFindFirstContaining, pipObjectFindFirstName, pipObjectFindFirstNearest, pipObjectFindFirstPolygon, or pipObjectFindFirstRect.
Alternates
None.
Notes
This function returns the handle of the current object in the object file. The handle can then be used with pipObjectFileGoto to make the object associated with this handle the current object at any time during processing.