跳转至

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:禁用拉伸