TrainCamp_lipengpeng_Modbus/communicationhistory.h

/*******************************
 * Copyright (C) 2025-.
 *
 * File Name: communicationhistory.h
 * Description: 通信历史记录模块头文件，提供通信数据的保存和读取功能
 * Others:
 * Version: 1.0.0
 * Author: lipengpeng
 * Date: 2025-7-25
 *******************************/

#ifndef COMMUNICATIONHISTORY_H
#define COMMUNICATIONHISTORY_H

#pragma once
#include <QString>
#include <QFileDialog>
#include <QMessageBox>
#include <QFile>
#include <QTextStream>
#include <QDir>
#include <QTextEdit>

/**
 * @brief 保存通信数据到文件
 * @param parent 父窗口指针，用于对话框的模态显示
 * @param edit 包含待保存通信数据的文本编辑框指针
 * @return bool 保存成功返回true，失败返回false
 * @note 此函数将：
 *       1. 弹出文件保存对话框让用户选择保存路径
 *       2. 将文本编辑框内容写入选定文件
 *       3. 支持UTF-8编码格式保存
 *       4. 操作失败时会显示错误提示
 */
bool saveDate(QWidget *parent, QTextEdit *edit);

/**
 * @brief 从文件读取通信数据
 * @param parent 父窗口指针，用于对话框的模态显示
 * @param edit 用于显示读取内容的文本编辑框指针
 * @return bool 读取成功返回true，失败返回false
 * @note 此函数将：
 *       1. 弹出文件选择对话框让用户选择文件
 *       2. 读取选定文件内容到文本编辑框
 *       3. 支持UTF-8编码格式读取
 *       4. 操作失败时会显示错误提示
 */
bool readDate(QWidget *parent, QTextEdit *edit);

#endif // COMMUNICATIONHISTORY_H