C++ Syntax

__int32

MKI_InputGetIdentData(

__int32 f_nPointIndex,

MKI_GEO_OBJECT_REF f_rGeoObject );

Retrieves a standard object resulting from object-independent identification.

Parameters

PointIndex

[__int32] Zero-based point index. This index states during which point's entry the identification was done. If, e.g., PointIndex is 1, the application will search for the object identified by entering the point with index 1, i.e. the second point. Valid range: 0 <= Value < MKI_INPUT_MAX.

GeoObject

[MKI_GEO_OBJECT_REF] Address of a buffer to receive the retrieved identified object. Point handles and outline indexes will be set as far as possible.

Return Value

Returns the retrieved object's type or -1 if no valid object is found. Only for the following object types, GeoObject will be initialized:

MKI_OBJ_LINE

Straight line.

MKI_OBJ_CIRCLE

Circle.

MKI_OBJ_ARC

Circular arc.

MKI_OBJ_ELLIPSE

Ellipse.

MKI_OBJ_EARC

Elliptical arc.

MKI_OBJ_GEOLINE

Construction Aid line (optionally printed object).

MKI_OBJ_GEOENDLESS

Construction Aid endless line (optionally printed object).

MKI_OBJ_GEOBEAM New in Version 2019.1

Construction Aid beam (optionally printed object).

MKI_OBJ_GEOCIRCLE

Construction Aid circle (optionally printed object).

MKI_OBJ_GEOARC

Construction Aid circular arc (optionally printed object).

MKI_OBJ_GEOELLIPSE

Construction Aid ellipse (optionally printed object).

MKI_OBJ_GEOEARC

Construction Aid elliptical arc (optionally printed object).

Comment

The possible types of the returned object are limited by the respective point definition. Complex objects like curves or dimensions are automatically split into simple objects before returning one of those simple objects.

Object-independent identification is forced by using point types whose names begin with MKI_POINT_P. For a complete list of point types, see MKI_POINT_*.