C++ Syntax

__int32

MKI_DialogSelectEntity(

MKI_CONST_ENTITY_PTR *f_pEntityList,

const __int32 *f_PointTypeList,

__int32 f_nListSize,

MKI_CONST_MATRIX_PTR f_pMatrix );

Prompts the user to select one entity or definition point from a list of entities or definition points. The entities or definition points will be presented in the order given by the lists.

Parameters

EntityList

[MKI_CONST_ENTITY_PTR*] Address of a list of entity pointers. These entities must be part of the current drawing's entity list (on top level, inside a group, hatching, or clipping, or in an extended object's display list). In case of point selection, the same entity may be listed multiple times for different point types.

PointTypeList

[const __int32*] Address of a list of point types corresponding to the entity list, see MKI_POINT*. If nullptr, whole entities shall be presented.

ListSize

[__int32] Size of both lists.

Matrix

[MKI_CONST_MATRIX_PTR] Address of a matrix to be applied to all objects of the list when showing them. If nullptr, no matrix is applied.

Return Value

Returns a non-negative index of the selected entry if successful (0 <= X < ListSize). Otherwise, a negative value is returned.