C++ Syntax

__int32

MKI_DatabaseColumnMerge(

__int32 f_nTargetDatabaseIndex,

__int32 f_nTargetOriginalRowCount,

__int32 f_nReferenceDatabaseIndex,

__int32 f_nReferenceColumnIndex );

Merges the reference column into the target database. The first cell of the reference column is copied to the row with index TargetOriginalRowCount in the target database. If an equally named column already exists in the target database the cells from the reference database are appended to it otherwise a new column is added to the target database.

Parameters

TargetDatabaseIndex

[__int32] Index of the target database. A value between MKI_BLOCK_INDEX and MKI_BLOCK_INDEX + MKI_DATABASE_INTERNAL_MAX - 1 indicates an internal database: MKI_BLOCK_INDEX refers to the drawing's default internal database (with empty name), MKI_BLOCK_INDEX + 1 through MKI_BLOCK_INDEX + MKI_DATABASE_INTERNAL_MAX - 1 refer to the other named internal database (with non-empty names). To access an external database, use value between 0 and MKI_DATABASE_MAX - 1.

TargetOriginalRowCount

[__int32] Original row count of the target database.

ReferenceDatabaseIndex

[__int32] Index of the reference database. A value between MKI_BLOCK_INDEX and MKI_BLOCK_INDEX + MKI_DATABASE_INTERNAL_MAX - 1 indicates an internal database.

ReferenceColumnIndex

[__int32] Index of the column in the reference database.

Return Value

Returns the zero-based index of the merged column in target database, or a negative value in case of an error. An error is returned if there is a conflict with auto-columns, i.e. if there are two equally named auto-columns with different AutoAssign types or if there are two auto-columns with identical AutoAssign types but different names.