ui_borcode
ui_borcode 模块提供条形码视图组件,用于在UI中渲染条形码图像。
Class Summary
OHOS::UIBarcode
提供条形码生成与显示功能,继承自 UIImageView。
- 构造:无
-
成员函数:
接口名称 功能简述 SetBarcodeInfo 设置条形码内容信息 GetViewType 获取视图类型 SetWidth 设置条形码宽度 SetHeight 设置条形码高度 EnableStretch 启用或禁用条形码拉伸填充 -
使用包含头文件:
#include "components/ui_barcode.h" - 声明头文件:
middleware/services/gui/uikit/proprietary/include/components/ui_barcode.h - 公有运算符:无
- 继承关系:UIImageView
- 嵌套类型:无
- 模板形参:无
Functions
OHOS::UIBarcode
SetBarcodeInfo
void SetBarcodeInfo(const char* srcVal)
功能说明
- 核心用途:设置用于生成条形码的内容字符串
- 设计目的:将传入的字符串编码为 Code128 格式条形码并刷新显示
- 使用场景:需要动态更新条形码显示内容时调用
入参
| 名称 | 参数类型 | 详细说明 | 约束取值范围 |
|---|---|---|---|
| srcVal | const char* | 入参指针,指向用于生成条形码的内容字符串 | 非 nullptr,长度大于 0 且不超过 QRCODE_VAL_MAX |
GetViewType
UIViewType GetViewType() const override
功能说明
- 核心用途:获取当前视图的类型标识
- 设计目的:为视图类型识别提供统一接口,支持运行时类型判定
- 使用场景:在视图容器中需要区分不同视图类型时调用
返回值
- 返回类型:
UIViewType
返回视图类型标识
| 返回值 | 触发场景 |
|---|---|
| UI_BARCODE | 当前对象为 UIBarcode 类型 |
SetWidth
void SetWidth(int16_t width) override
功能说明
- 核心用途:设置条形码的显示宽度
- 设计目的:宽度变更时触发条形码重新编码与刷新
- 使用场景:需要调整条形码控件尺寸时调用
入参
| 名称 | 参数类型 | 详细说明 | 约束取值范围 |
|---|---|---|---|
| width | int16_t | 条形码宽度值 | 大于 0 |
SetHeight
void SetHeight(int16_t height) override
功能说明
- 核心用途:设置条形码的显示高度
- 设计目的:高度变更时触发条形码重新编码与刷新
- 使用场景:需要调整条形码控件尺寸时调用
入参
| 名称 | 参数类型 | 详细说明 | 约束取值范围 |
|---|---|---|---|
| height | int16_t | 条形码高度值 | 大于 0 |
EnableStretch
void EnableStretch(bool enable)
功能说明
- 核心用途:控制条形码是否拉伸以填充整个控件区域
- 设计目的:启用拉伸时条形码以 FILL 模式显示,禁用时以 CENTER 模式显示
- 使用场景:需要条形码铺满控件区域或保持原始居中显示时调用
入参
| 名称 | 参数类型 | 详细说明 | 约束取值范围 |
|---|---|---|---|
| enable | bool | 是否启用拉伸填充 | true:启用拉伸;false:禁用拉伸 |