TBarCode Library 11  TBarCode Library 11
ERRCODE BCSet_DM_Append ( t_BarCode pBarCode,
LONG  nSum,
LONG  nIndex,
LONG  nFileID 
)

Activates Data Matrix "Structured Append" mode.

Data Matrix allows user data to be spread across several symbols. This might be done if the data is too large to fit into a single symbol or for reasons of appearance and geometry. The so called "Structured Append" mode encodes additional control information to enable the reading device to reconstruct the data of all symbols in the correct order. This function sets the total number of symbols and the index of the actual Data Matrix symbol within the symbol chain. Depending on this index, the data will be reconstructed by the scanner during the reading process. The scanner returns the data of all symbols in the correct order at once. Default: Standard Structured Append is used.

Note:
All symbols within a symbol chain must be identified by a unique File-ID.
See also:
BCGet_DM_AppendSum(), BCGet_DM_AppendIndex(), BCGet_DM_AppendFileID()
Parameters:
[in]pBarCodePointer to barcode structure.
[in]nSumNumber of symbols [2..16] (reset to default/disable = -1).
[in]nIndexIndex of symbol [1..16].
[in]nFileIDFile ID (must be the same in all symbols).
Return values:
ERRCODEErrOk (0) in case of success. Non-zero if error occurred.