IDataMatrix

Interface IDataMatrix

All Superinterfaces:: IBarcode

public interface IDataMatrix extends IBarcode

DataMatrix 条形码是一种高密度二维条形码，具有通常按正方形或矩形矩阵图案排列的方形模块。

此接口表示从工作表单元格返回的 DataMatrix 条形码值。除了 IBarcode 定义的通用条形码属性外，它还提供对 DataMatrix 特定设置的访问，例如 ECC 模式、符号大小、编码模式和结构化追加信息。


 worksheet.getRange("A1").setValue("Test");
 worksheet.getRange("B1").setFormula("=BC_DATAMATRIX(A1,\"rgb(0, 0, 0)\",\"rgb(255, 255, 255)\",\"" + EccMode.ECC200.name() + "\",\"squareAuto\",\"auto\",\"auto\",FALSE,0,0,4,4,4,4)");
 IDataMatrix dataMatrix = (IDataMatrix) worksheet.getRange("B1").getValue();
 EccMode eccMode = dataMatrix.getEccMode();

Method Summary

Modifier and Type

Method

Description

String

getEcc00140SymboleSize()

获取 ECC000-140 符号的大小。

String

getEcc200EndcodingMode()

获取 ECC200 编码模式。

String

getEcc200SymbolSize()

获取 ECC200 符号的大小。

EccMode

getEccMode()

获取纠错模式。

int

getFileIdentifier()

获取一组相关结构化追加符号的文件标识符。

boolean

getStructureAppend()

获取一个值，该值指示当前符号是否属于结构化追加符号。

int

getStructureNumber()

获取当前符号在结构化追加符号中的结构编号。

Methods inherited from interface com.grapecity.documents.excel.IBarcode
getBackgroundColor, getCodeType, getColor, getQuietZoneBottom, getQuietZoneLeft, getQuietZoneRight, getQuietZoneTop, getValue

Method Details

getEccMode

EccMode getEccMode()

获取纠错模式。

此方法返回当前 DataMatrix 条形码使用的纠错模式，例如 EccMode.ECC000 或 EccMode.ECC200。


 worksheet.getRange("A1").setValue("Test");
 worksheet.getRange("B1").setFormula("=BC_DATAMATRIX(A1,\"rgb(0, 0, 0)\",\"rgb(255, 255, 255)\",\"" + EccMode.ECC200.name() + "\",\"squareAuto\",\"auto\",\"auto\",FALSE,0,0,4,4,4,4)");
 IDataMatrix dataMatrix = (IDataMatrix) worksheet.getRange("B1").getValue();
 EccMode eccMode = dataMatrix.getEccMode();

Returns:: 当前 DataMatrix 条形码的纠错模式。

getEcc200SymbolSize

String getEcc200SymbolSize()

获取 ECC200 符号的大小。

当 ECC 模式为 ECC200 时，此方法返回 DataMatrix 条形码使用的符号大小字符串。


 worksheet.getRange("A1").setValue("Test");
 worksheet.getRange("B1").setFormula("=BC_DATAMATRIX(A1,\"rgb(0, 0, 0)\",\"rgb(255, 255, 255)\",\"" + EccMode.ECC200.name() + "\",\"squareAuto\",\"auto\",\"auto\",FALSE,0,0,4,4,4,4)");
 IDataMatrix dataMatrix = (IDataMatrix) worksheet.getRange("B1").getValue();
 String symbolSize = dataMatrix.getEcc200SymbolSize();

Returns:: ECC200 符号大小字符串。

getEcc200EndcodingMode

String getEcc200EndcodingMode()

获取 ECC200 编码模式。

当 ECC 模式为 ECC200 时，此方法返回 DataMatrix 条形码使用的编码模式字符串。


 worksheet.getRange("A1").setValue("Test");
 worksheet.getRange("B1").setFormula("=BC_DATAMATRIX(A1,\"rgb(0, 0, 0)\",\"rgb(255, 255, 255)\",\"" + EccMode.ECC200.name() + "\",\"squareAuto\",\"auto\",\"auto\",FALSE,0,0,4,4,4,4)");
 IDataMatrix dataMatrix = (IDataMatrix) worksheet.getRange("B1").getValue();
 String encodingMode = dataMatrix.getEcc200EndcodingMode();

Returns:: ECC200 编码模式字符串。

getEcc00140SymboleSize

String getEcc00140SymboleSize()

获取 ECC000-140 符号的大小。

此值对应于为 DataMatrix 条形码指定的 ECC000-140 符号大小。


 worksheet.getRange("A1").setValue("Test");
 worksheet.getRange("B1").setFormula("=BC_DATAMATRIX(A1,\"rgb(0, 0, 0)\",\"rgb(255, 255, 255)\",\"ECC000\",\"squareAuto\",\"auto\",\"auto\",FALSE,0,0,4,4,4,4)");
 IDataMatrix dataMatrix = (IDataMatrix) worksheet.getRange("B1").getValue();
 String symbolSize = dataMatrix.getEcc00140SymboleSize();

Returns:: ECC000-140 符号大小。自动大小由 "auto" 表示。

getStructureAppend

boolean getStructureAppend()

获取一个值，该值指示当前符号是否属于结构化追加符号。

结构化追加仅受 ECC200 支持。


 worksheet.getRange("A1").setValue("Test");
 worksheet.getRange("B1").setFormula("=BC_DATAMATRIX(A1,\"rgb(0, 0, 0)\",\"rgb(255, 255, 255)\",\"" + EccMode.ECC200.name() + "\",\"squareAuto\",\"auto\",\"auto\",TRUE,1,10,4,4,4,4)");
 IDataMatrix dataMatrix = (IDataMatrix) worksheet.getRange("B1").getValue();
 boolean structureAppend = dataMatrix.getStructureAppend();

Returns:: 如果当前符号属于结构化追加符号，则返回 true；否则返回 false。

getStructureNumber

int getStructureNumber()

获取当前符号在结构化追加符号中的结构编号。

此属性仅在 ECC 模式为 EccMode.ECC200 时使用。


 worksheet.getRange("A1").setValue("Test");
 worksheet.getRange("B1").setFormula("=BC_DATAMATRIX(A1,\"rgb(0, 0, 0)\",\"rgb(255, 255, 255)\",\"" + EccMode.ECC200.name() + "\",\"squareAuto\",\"auto\",\"auto\",TRUE,1,10,4,4,4,4)");
 IDataMatrix dataMatrix = (IDataMatrix) worksheet.getRange("B1").getValue();
 int structureNumber = dataMatrix.getStructureNumber();

Returns:: 当前符号在结构化追加符号组中的结构编号。

getFileIdentifier

int getFileIdentifier()

获取一组相关结构化追加符号的文件标识符。

此属性适用于 ECC200 结构化追加符号。有效的文件标识符值在 [1, 254] 范围内。值为 0 表示自动计算文件标识符。


 worksheet.getRange("A1").setValue("Test");
 worksheet.getRange("B1").setFormula("=BC_DATAMATRIX(A1,\"rgb(0, 0, 0)\",\"rgb(255, 255, 255)\",\"" + EccMode.ECC200.name() + "\",\"squareAuto\",\"auto\",\"auto\",TRUE,1,10,4,4,4,4)");
 IDataMatrix dataMatrix = (IDataMatrix) worksheet.getRange("B1").getValue();
 int fileIdentifier = dataMatrix.getFileIdentifier();

Returns:: 相关结构化追加符号组的文件标识符。如果文件标识符是自动计算的，则返回0。