核心内容摘要
米奇的颜色之谜：第四声“黑”与77777的金色诱惑
日历1 概要
1 简介本篇设计文档主要讲述了计 52 班的吴启凌根据小学期第一周李国良老师所教的内容来实现的程序 Calendar 的设计思路架构以及一些设计细节。
2 实现的功能Calendar 实现了日历的基本功能以及一些附加功能主要有正确地按照公历显示日历。
能够添加、删除、修改事件序列某个事件在设置时能够按天按周按月重复发生删除事件时能删除可重复事件的单个或全部。
能够设置每一天的颜色。
能够与本地文件实现拖拽交互。
当用户把文件拖到某一天上时能够保存到 Calendar 所在的目录下并在当天格子内显示文件名。
双击某一天能够打开一个对话框其中显示了该天上的所有文件并且能够拖拽到本地保存。
此外还设计了一个按钮来打开和关闭拖拽交互。
能够使用配置文件包括 XML 和 ini 文件来保存信息。
其中XML 用于保存事件和每天的颜色ini 用于保存语言是否打开拖拽交互的信息。
信息能够通过 save 按钮保存也可在关闭程序时自动保存。
支持导入导出 XML 文件。
可以对日历进行整体拖拽并设置了一个按钮来固定、解锁界面锁定后日历不再响应鼠标动作并且能将鼠标事件传递到桌面。
国际化支持中文、英文两种模式。
2 系统架构
1 文件结构Calendar 的代码根据界面分组文件如下Mycalendar 构建了日历的样式及其交互模式Filesdialog 和 Listwidget 用于显示日期所储存的文件以及提供拖拽功能Scheduledialog 用于新建及编辑事件Schedule 类用于储存事件Schedulemanager 用于管理事件而 Mainwindow 则作为各组件沟通的纽带。
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。
3 用户界面
1 主界面界面如下图 1 所示左半边区域为日历部分中间为功能按钮右边为事件显示区域。
此外工具栏中为 lock 按钮菜单栏中 Calendar 可以弹出下拉菜单。
如图 2,3点击某天后右侧列表框中会显示当天事件用户可以点击 New 按钮来新建事件或者可以点击列表框中的条目再点击 Edit 或 Delete 按钮来编辑或删除事件删除时会出现确认对话框三个选项分别对应删除单个事件、全部事件、取消删除。
在 color 标签下方的下拉框中可以设置某天的颜色。
Language 下拉框可以设置语言设置后需要重启才能生效。
需要重新设置一下翻译文件加载的路径。
Enable drag 的复选框能够开启、关闭文件拖拽功能。
按 lock 按钮能够锁定日历由于锁定后鼠标穿透需要用快键键 Ctr L 来解锁。
在 Calendar 的下拉菜单栏中save 能够保存设置import XML 能导入事件、日期颜色设置export XML 能够导出事件、日期颜色设置。
♻️ 资源大小