C++ Syntax

MKI_EditIdentEnumModify(

bool f_fDuplicate,

void* f_pUserData );

Enumerates all identified entities allowing the plug-in to modify them. This will only work if the current command forced a multi-entity identification.

Multi-entity identification is forced by using point types whose names begin with MKI_POINT_ID_MULTI (but not with MKI_POINT_ID_MULTIPOINT). For a complete list of point types, see MKI_POINT_*.

During this type of modification, the memory structure of the entities may not be altered, only the entity's header and the data areas of its data blocks may be modified!

This procedure may only be called inside a MKI_UndoInitProcess and MKI_UndoFinishProcess bracket.

Parameters

CallBack

[MKI_ENUMOBJECT_PROC] Callback procedure for an object enumeration. This procedure will be called for every enumeration step. For a detailed description of object enumeration, see also the description of the MKI_EnumObjectProc procedure. The enumeration will always be done using the MKI_ENUM_NATIVE mode, i.e. only the addresses of the identified entities are passed to the callback procedure.

Duplicate

[bool] Determines whether the entities themselves shall be modified or a copy of them. This is equivalent to the "Duplicate" function in the serving application.

UserData

[void*] This pointer will be passed to all callback procedures that are called during the enumeration. You can use this parameter to pass "local" data to the enumeration, preferably by passing a pointer to a local data structure containing all information the callback procedure requires.

Return Value Changed in Version 2022.1

Transformation result as a bitwise-or combination of flags (see MKI_RESULT_*). Some results indicate minor problems and do NOT mean that the enumeration was stopped or unsuccessful!