基于 QT（C++）实现的（图形界面）日历-智慧文博士

日历

1 概要

1.1 简介

本篇设计文档主要讲述了计 52 班的吴启凌根据小学期第一周李国良老师所教的内容，来实现的程序 Calendar 的设计思路，架构，以及一些设计细节。

1.2 实现的功能

Calendar 实现了日历的基本功能以及一些附加功能，主要有

正确地按照公历显示日历。

能够添加、删除、修改事件序列，某个事件在设置时，能够按天，按周，按月重复发生；删除事件时，能删除可重复事件的单个或全部。

能够设置每一天的颜色。

能够与本地文件实现拖拽交互。当用户把文件拖到某一天上时，能够保存到 Calendar 所在的目录下，并在当天格子内显示文件名。双击某一天能够打开一个对话框，其中显示了该天上的所有文件，并且能够拖拽到本地保存。此外，还设计了一个按钮来打开和关闭拖拽交互。

能够使用配置文件，包括 XML 和 ini 文件来保存信息。其中，XML 用于保存事件和每天的颜色，ini 用于保存语言，是否打开拖拽交互的信息。信息能够通过 save 按钮保存，也可在关闭程序时自动保存。支持导入，导出 XML 文件。

可以对日历进行整体拖拽，并设置了一个按钮来固定、解锁界面，锁定后，日历不再响应鼠标动作，并且能将鼠标事件传递到桌面。

国际化：支持中文、英文两种模式。

2 系统架构

2.1 文件结构

Calendar 的代码根据界面分组，文件如下

Mycalendar 构建了日历的样式及其交互模式，Filesdialog 和 Listwidget 用于显示日期所储存的文件，以及提供拖拽功能，Scheduledialog 用于新建及编辑事件，Schedule 类用于储存事件，Schedulemanager 用于管理事件，而 Mainwindow 则作为各组件沟通的纽带。

2.2 组件分析

Schedule 类用于储存事件的描述，开始、结束日期、重复模式等信息。Schedulemanager 提供了对 Schedule 管理的接口，包括添加、编辑、删除事件，获取某天的事件列表或单个事件，以及获取全部事件。

Scheduledialog 用于向用户显示事件的描述、重复模式信息，同时接受用户的编辑。

Listwidget 重写了 QListWidget 的 mousePressEvent 事件处理函数，在用户对列表中的文件按下鼠标时，传递文件路径的信息。

Mycalendar 则是工程中较为重要的一个类，重写了父类的 dragEnterEvent 和 dropEvent 来处理鼠标拖入事件，并在鼠标拖入文件时，将文件复制到 Calendar 所在目录下，并显示在日期格子中。重写了 paintCell 来获取每个日期的外框的位置信息，以此来判断鼠标将文件拖到了哪一天内；以及在日期中显示文件名，设置日期颜色。重写了 resizeEvent 来重置 datepos 中储存的矩形信息，以免造成拖拽的误差。

Mainwindow 则是工程中的核心类，用于收集、处理、传递几乎所有的信息。三个 public slots 用于在三个事件按钮按下时，弹出窗口并收集事件信息；on_calendar_clicked 用于在鼠标点击 calendar 时，在列表框中刷新事件信息，以及在 colorbox，即颜色选择框内显示该天的颜色信息；on_actionLock_triggered 在 lock 按钮按下时，固定窗口并设置鼠标穿透；on_checkBox_toggled 用于读取是否开启文件拖拽按钮的信息；on_languageBox_currentTextChanged 用于设置语言；最后三个槽用于保存配置信息、导入 XML、导出 XML。