IQRCode

Interface IQRCode

All Superinterfaces:: IBarcode

public interface IQRCode extends IBarcode

表示由 BC_QRCODE 公式创建的条形码对象。

此接口表示 BC_QRCODE 返回的二维码结果。它继承 IBarcode，并公开二维码特定的设置，例如 ErrorCorrectionLevel、模型、版本、掩码图案、结构化追加连接、字符代码和字符集。


 worksheet.getRange("A1").setValue("www.example.com");
 worksheet.getRange("B1").setFormula("=BC_QRCODE(A1,\"rgb(0, 0, 0)\",\"rgb(255, 255, 255)\",\"H\",1,\"auto\",\"auto\",FALSE,0,,\"UTF-8\",4,4,4,4)");
 IQRCode qrCode = (IQRCode) worksheet.getRange("B1").getValue();
 ErrorCorrectionLevel level = qrCode.getErrorCorrectionLevel();
 int model = qrCode.getModel();

Method Summary

Modifier and Type

Method

Description

String

getCharCode()

获取 BC_QRCODE 公式结果使用的字符代码信息。

String

getCharSet()

获取 BC_QRCODE 公式结果使用的字符集。

boolean

getConnection()

获取条形码是否使用连接。

int

getConnectionNo()

获取条形码的连接编号。

ErrorCorrectionLevel

getErrorCorrectionLevel()

获取 BC_QRCODE 公式结果使用的纠错级别。

int

getMask()

获取 BC_QRCODE 公式结果使用的掩码图案。

int

getModel()

获取 BC_QRCODE 公式结果使用的 QR Code 模型。

int

getVersion()

获取 BC_QRCODE 公式结果使用的 QR Code 版本。

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

Method Details

getErrorCorrectionLevel

ErrorCorrectionLevel getErrorCorrectionLevel()

获取 BC_QRCODE 公式结果使用的纠错级别。

此值指定 QR Code 损坏或部分被遮挡时可用的数据恢复级别。


 worksheet.getRange("A1").setValue("1234567890");
 worksheet.getRange("B1").setFormula("=BC_QRCODE(A1,\"rgb(0, 0, 0)\",\"rgb(255, 255, 255)\",\"H\",2,\"auto\",\"auto\",FALSE,0,,\"UTF-8\",4,4,4,4)");
 IQRCode qrCode = (IQRCode) worksheet.getRange("B1").getValue();
 ErrorCorrectionLevel errorCorrectionLevel = qrCode.getErrorCorrectionLevel();

Returns:: QR Code 使用的纠错级别。

getModel

int getModel()

获取 BC_QRCODE 公式结果使用的 QR Code 模型。

默认值为 2。

下面的示例将模型显式设置为 1。


 worksheet.getRange("A1").setValue("1234567890");
 worksheet.getRange("B1").setFormula("=BC_QRCODE(A1,\"rgb(0, 0, 0)\",\"rgb(255, 255, 255)\",\"L\",1,\"auto\",\"auto\",FALSE,0,,\"UTF-8\",4,4,4,4)");
 IQRCode qrCode = (IQRCode) worksheet.getRange("B1").getValue();
 int model = qrCode.getModel();

Returns:: QR Code 模型。

getVersion

int getVersion()
获取 BC_QRCODE 公式结果使用的 QR Code 版本。
对于 Model 1，版本范围为 1 到 14。对于 Model 2，版本范围为 1 到 40。此属性支持自动配置（以 -1 表示），也支持显式的数字版本值。
```
 worksheet.getRange("A1").setValue("1234567890");
 worksheet.getRange("B1").setFormula("=BC_QRCODE(A1,\"rgb(0, 0, 0)\",\"rgb(255, 255, 255)\",\"L\",2,\"auto\",\"auto\",FALSE,0,,\"UTF-8\",4,4,4,4)");
 IQRCode qrCode = (IQRCode) worksheet.getRange("B1").getValue();
 int version = qrCode.getVersion();
 
```
Returns:

QR Code 版本。如果版本配置为自动，则返回 -1。

getMask

int getMask()

获取 BC_QRCODE 公式结果使用的掩码图案。

指定 1 到 7 之间的任意值；自动配置为 -1。


 worksheet.getRange("A1").setValue("1234567890");
 worksheet.getRange("B1").setFormula("=BC_QRCODE(A1,\"rgb(0, 0, 0)\",\"rgb(255, 255, 255)\",\"L\",2,\"auto\",\"auto\",FALSE,0,,\"UTF-8\",4,4,4,4)");
 IQRCode qrCode = (IQRCode) worksheet.getRange("B1").getValue();
 int mask = qrCode.getMask();

Returns:: QR Code 的掩码图案。返回 1 到 7 之间的值；如果掩码配置为自动，则返回 -1。

getConnection

boolean getConnection()

获取条形码是否使用连接。

此属性指示 QR Code 是否使用结构化追加连接。


 worksheet.getRange("A1").setValue("1234567890");
 worksheet.getRange("B1").setFormula("=BC_QRCODE(A1,\"rgb(0, 0, 0)\",\"rgb(255, 255, 255)\",\"L\",2,\"auto\",\"auto\",TRUE,1,,\"UTF-8\",4,4,4,4)");
 IQRCode qrCode = (IQRCode) worksheet.getRange("B1").getValue();
 boolean connection = qrCode.getConnection();

Returns:: 如果条形码使用连接，则为 true；否则为 false。

getConnectionNo

int getConnectionNo()

获取条形码的连接编号。

此值标识 QR Code 使用的结构化追加连接编号。


 worksheet.getRange("A1").setValue("1234567890");
 worksheet.getRange("B1").setFormula("=BC_QRCODE(A1,\"rgb(0, 0, 0)\",\"rgb(255, 255, 255)\",\"L\",2,\"auto\",\"auto\",TRUE,1,,\"UTF-8\",4,4,4,4)");
 IQRCode qrCode = (IQRCode) worksheet.getRange("B1").getValue();
 int connectionNo = qrCode.getConnectionNo();

Returns:: 条形码的连接编号。

getCharCode

String getCharCode()

获取 BC_QRCODE 公式结果使用的字符代码信息。

此值对应 BC_QRCODE 公式的第十个参数，并且不同于存储在引用单元格中的 QR Code 内容。


 worksheet.getRange("A1").setValue("Example");
 worksheet.getRange("B1").setFormula("=BC_QRCODE(A1,\"rgb(0, 0, 0)\",\"rgb(255, 255, 255)\",\"L\",2,\"auto\",\"auto\",FALSE,0,\"1234567890\",\"UTF-8\",4,4,4,4)");
 IQRCode qrCode = (IQRCode) worksheet.getRange("B1").getValue();
 String qrContent = qrCode.getValue();
 String charCode = qrCode.getCharCode();

Returns:: QR Code 使用的字符代码信息。

getCharSet

String getCharSet()

获取 BC_QRCODE 公式结果使用的字符集。

此值指定用于编码 QR Code 的字符集。可选字符集包括 UTF-8、SHIFT-JIS 和 SHIFT_JIS。


 worksheet.getRange("A1").setValue("Example");
 worksheet.getRange("B1").setFormula("=BC_QRCODE(A1,\"rgb(0, 0, 0)\",\"rgb(255, 255, 255)\",\"L\",2,\"auto\",\"auto\",FALSE,0,,\"UTF-8\",4,4,4,4)");
 IQRCode qrCode = (IQRCode) worksheet.getRange("B1").getValue();
 String charSet = qrCode.getCharSet();

Returns:: 表示 QR Code 使用的字符集的字符串。