77 lines
3.3 KiB
C++
77 lines
3.3 KiB
C++
#ifndef _ITEM_COMMON_H_
|
||
#define _ITEM_COMMON_H_
|
||
|
||
#include "ViewModels.h"
|
||
#include <QDateTime>
|
||
#include <QString>
|
||
#include <QVector>
|
||
#include "BarcodeEditor.h"
|
||
#include <array>
|
||
#include <QImage>
|
||
|
||
/**
|
||
* @brief 根据日期视图模型和时间生成字符串
|
||
* @param model 包含日期格式模版和相关配置的视图模型
|
||
* @param time 用于生成字符串的时间
|
||
* @return QString 生成的字符串
|
||
* @remark
|
||
* 该函数根据 model.datetimePattern 中的格式模版生成字符串，支持以下格式：
|
||
* - yyyy: 四位数年份，支持替换为自定义字符串（通过 model.yearsMap）
|
||
* - YY: 两位数年份
|
||
* - MM: 两位数月份，支持替换为自定义字符串（通过 model.monthsMap）
|
||
* - dd: 两位数日期，支持替换为自定义字符串（通过 model.daysMap）
|
||
* - HH: 两位数小时，支持替换为自定义字符串（通过 model.hoursMap）
|
||
* - mm: 两位数分钟
|
||
* - ss: 两位数秒钟
|
||
* - w: 星期几，支持替换为自定义字符串（通过 model.weeksMap）
|
||
* - c: 年中周数
|
||
*/
|
||
QString generateTxtFromDateItemModel(const DateItemModel& model, const QDateTime& time);
|
||
|
||
/**
|
||
* @brief 根据条形码视图模型的内容模版生成字符串，
|
||
* 生成的字符串可用于创建条形码或二维码
|
||
*
|
||
* @example
|
||
* input: "ABC_{c}_{t}"
|
||
* output: "ABC_1230_2026/04/30"
|
||
*
|
||
* @remark
|
||
* 函数根据vm中的 contentPattern 是否存在变量模版，如果存在计数器变量，则使用 counterViewModel 格式化，同理也处理时间变量。
|
||
*
|
||
* @param vm 包含格式化所需的内容模版及相关配置
|
||
* @param counterValues 所有计数器的当前值，counterValues[0] 为计数器1的当前值，counterValues[1]为计数器2的当前值......
|
||
* @param time 要用于格式化的时间，通常是当前时间
|
||
* @return QString 格式化后的字符串
|
||
*
|
||
*/
|
||
QString generateTxtFromBarcodeViewModel(const BarcodeViewModel& vm, const std::array<int, 2> counterValues, const QDateTime& time);
|
||
|
||
/**
|
||
* @brief 根据条形码类型和内容生成条形码或二维码图像
|
||
* @param content 已格式化的文本内容
|
||
* @param type 条码类型
|
||
* @param format 配置参数
|
||
* @return QImage 生成的图像；如果失败返回空图像
|
||
* @note
|
||
* format 参数类型：
|
||
* - BARCODE_TYPE_QRCODE: DlgQrcodeFormatVM 或 int
|
||
* - BARCODE_TYPE_BARCODE: DlgBarcodeFormatVM 或 int
|
||
* 如果 format 是 int 类型, 对于 QR Code，0 表示 Data Matrix，1 表示 QR Code；对于条形码，int 值对应 DlgBarcodeFormatVM 中 type 的索引。
|
||
* 如果 format 是 int 类型，则使用默认配置并根据 int 值选择二维码或条形码的子类型；如果 format 是对应的 VM 类型，则使用其中的详细配置。
|
||
*/
|
||
QImage generateBarcodeImage(const QString& content, BarcodeType type, const QVariant& format);
|
||
|
||
/**
|
||
* @brief 将文本转换为图像
|
||
* @param txt 要转换的文本
|
||
* @param font 文本使用的字体
|
||
* @param fgColor 文本颜色，默认为黑色
|
||
* @param bgColor 背景颜色，默认为白色
|
||
* @return QImage 转换后的图像
|
||
* @note 返回的字符串图像会裁剪至最小边界以节省空间。例如字符串"aaa"的高度会比"bbbjjj"小，因为前者没有上下行部分。
|
||
*/
|
||
QImage txtToImage(const QString& txt, const QFont& font, const QColor& fgColor = Qt::black, const QColor& bgColor = Qt::white);
|
||
|
||
#endif // _ITEM_COMMON_H_
|