自定义日历(四)-区间选择控件
原文链接：
一、概述
很早很早以前，写过几篇关于日历的文章，不同于qt原生的控件，这些控件都是博主使用自绘的方式进行完成，因此可定制性更强一些，感兴趣的可以参考、和。
本篇文章还是继续来写我们的日历控件，仍然采用自绘的方式，带来更加炫酷的效果。看本文的标题就应该就能明白，这次实现的是一个可以区间选择的日历控件。
二、效果展示
效果图如下，一个简单的效果展示。
日历控件与qt原生的qdateedit一样，是由一个按钮进行触发，弹出如期选择面板。不同的是这个日历选择面板由2个小的日期面板组成，分别是开始和结束日期，规则如下：
- 开始日期必须小于结束日期
- 顶部有快速返回按钮
- 选中的日期段上有高亮背景色
- 选中的日期点上有蓝色圆形标识
- 点击确定按钮以后日期选择面板关闭
三、整体结构
开始讲解具体内容之前，先来看下整体的结构划分，实现这个日期段选择控件，总共需要以下4个类，下图是工程结构
以下是4个类的说明
- qdatecontent：单个日历窗口
- qdatewidget：包含了年月选择的单个日历窗口
- qdatepanel：日期段选择面板
- qpickdate：日期选择按钮，用于呼出日期选择面板
其中qpickdate类就是对外使用的类，使用也很简单，可能像下面这样
qpickdate * pickdate = new qpickdate; pickdate->setquickvalue(qdatepanel::day_one);
意思是构造一个日期段选择空间，然后初始时为选择当天。有了一个大致的了解后，下面开始详细的讲解每个类的实现过程
四、分析实现
1、qpickdate
qpickdate类是对外导出类，也是我们使用的时候需要了解的类，他的头文件实现如下
class qpickdate : public qpushbutton
{
q_object
public:
qpickdate(qwidget * parent = nullptr);
~qpickdate();
signals:
void picksuccess();//选择日期成功时调用
public:
void setquickvalue(qdatepanel::quickpick pick);
void getstartdate(unsigned short year, unsigned short month, unsigned short day);
void getenddate(unsigned short year, unsigned short month, unsigned short day);
private slots:
void onclicked();
private:
void initializeui();
private:
qdatepanel::quickpick m_epick = qdatepanel::day_custom;
qdatepanel * m_ppanel = nullptr;
};
接口看起来也比较简单，setquickvalue接口上一小节使用过，主要是用来初始化日期控件状态。getstartdate和getenddate接口主要就是获取日期段的开始时间和结束时间。其中的实现具体的日期数据是从成员变量qdatepanel中获取。
2、qdatepanel
如下是qdatepanel的头文件声明，由于代码量的问题，其中精简了一部分，qdatepanel这个类就是日期选择面板，垂直方向由三部分组成，分别是快速选择、日期选择和操作按钮
class qdatepanel : public qframe
{
...
public:
enum quickpick
{
day_one,//今天
day_week,//近一周
day_month,//近一月
day_year,//近一年
day_custom,//自定义
};
signals:
void picksuccess(quickpick, const qstring &);
...
public:
qstring getquickname(quickpick pick);
void setquickvalue(quickpick pick);
void getstartdate(unsigned short year, unsigned short month, unsigned short day);
void getenddate(unsigned short year, unsigned short month, unsigned short day);
private:
...
};
快速选择：可以快速选择一日、一周、一月和一年时间段
日期选择：分为左右结构，左侧时其实日期，右侧时结束日期
操作按钮：选择好日期后，可以通过点击确定或者取消来关闭面板
3、qdatewidget、qdatecontent
上边说了qdatepanel是日期选择面板，其中日期选择部分就是由左右两部分组成，其实分别就是一个qdatewidget，如下图所示
qdatecontent类是主要的日期计算和绘制类，被qdatewidget包裹了一层，并添加上了年和月的操作按钮。
下面主要介绍下qdatecontent类的实现，首先来看下声明文件
由于篇幅原因还是注释了一大部分代码
class qdatecontent : public qwidget
{
...
signals:
void dateclicked(unsigned short year, unsigned short month, unsigned short day);
public:
void setselectdate(unsigned short year, unsigned short month, unsigned short day);
void getselectdate(unsigned short & year, unsigned short & month, unsigned short & day);
void setdate(unsigned short year, unsigned short month, unsigned short day);
void getdate(unsigned short & year, unsigned short & month, unsigned short & day);
//设置关联日期
void setrelationdate(qdatecontent * content);
public slots :
void previousmonth();//上一月
void nextmonth();//下一月
void previousyear();//上一年
void nextyear();//下一年
...
private:
struct qdatecontentprivate;
qdatecontentprivate * d_ptr;
};
切换月份和年份的接口代码中已经包含了注释，其他set和get接口看名称基本也能明白，qdatecontent类的代码量还是比较大的，下面我们主要来看绘制部分，其中有3个比较重要的点绘制头、绘制数字和绘制选中。
绘制头
该绘制模块主要是绘制表头，也就是周日、周一这样的字段，绘制的位置时通过私有函数getcolumnleft和getcolumnright获取。
void qdatecontent::drawweek(qpainter & painter)
{
// qstring atext[7] = { str("周日"), str("周一"), str("周二"), str("周三"), str("周四"), str("周五"), str("周六") };
qstring atext[7] = { str("日"), str("一"), str("二"), str("三"), str("四"), str("五"), str("六") };
painter.save();
painter.setfont(d_ptr->weekfont);
qfontmetrics fm(d_ptr->weekfont);
int height = fm.height();
//painter.fillrect(d_ptr->getcolumnleft(0), d_ptr->topborder, d_ptr->getcolumnright(6) - 3, d_ptr->topborder + height, qcolor(20, 22, 23));
for (int i = 0; i < 7; ++i)
{
int left = d_ptr->getcolumnleft(i);
int right = d_ptr->getcolumnright(i);
qrect rect(left, d_ptr->topborder, right - left, height);
painter.setpen(qcolor("#838d9e"));
painter.drawtext(rect, qt::aligncenter, atext[i]);
}
painter.restore();
}
绘制数字
绘制数字和绘制标题原理基本一致，位置信息都是使用getcolumnleft和getcolumnright获取，不同的是，绘制数字时还需要绘制额外的选中状态、悬浮状态
由于是绘制函数，因此有一些数据计算是通过整理好的，比如说需要绘制的数字，当前行数和当月第一天周几等等
由于绘制篇幅原因，还是只保留主要逻辑
void qdatecontent::drawday(qpainter & painter)
{
painter.save();
for (int column = 0; column < d_ptr->m_column_count; ++column)
{
int column_left = d_ptr->getcolumnleft(column);
int column_right = d_ptr->getcolumnright(column);
for (int row = 0; row < d_ptr->m_row_count; ++row)
{
int index = row * d_ptr->m_column_count + column;
qrect & rctmp = d_ptr->m_arect[index];
tdayflag & flag = d_ptr->m_adayflag[index];
flag.m_chenable = (column != 0 && column != 6) ? true : false;
bool selected = d_ptr->matchrealdate(flag);
if (selected)
{
qpainterpath path;
path.addellipse(qrectf(rctmp).center(), 12, 12);
painter.fillpath(path, qcolor("#218cf2"));
}
painter.drawtext(rctmp, qt::aligncenter, qstring::number(flag.m_chflagd));
painter.restore();
}
}
painter.restore();
}
绘制选中
以下代码是绘制选中时的水平背景色，绘制代码比较简单，复杂的地方主要有2个：
- 计算当前日期是否在选择日期段当中，返回status
- 修正第一步返回的status
由于绘制篇幅原因，还是只保留主要逻辑
以下代码是精简过后的绘制选中背景色，看起来还是很长，不过大体上是分下面这几步
- 根据当前年月日返回status，表示当前day是否在选择的开始和选择的结束日期之间
- 根据所处列和day修改第一步返回的status
- 根据status调整要绘制的形状
- 绘制背景色
下面是主要的绘制流程，代码就不细讲了，大家可以自行阅读
void qdatecontent::drawselectedbackground(qpainter & painter)
{
painter.save();
for (int column = 0; column < d_ptr->m_column_count; ++column)
{
for (int row = 0; row < d_ptr->m_row_count; ++row)
{
tdayflag & flag = d_ptr->m_adayflag[index];
if (little)
{
status = d_ptr->getselectedstatus(d_ptr->m_wyear, d_ptr->m_wmonth, d_ptr->m_wday, d_ptr->m_syear
, d_ptr->m_smonth, flag.m_chflagd, year, month, day);
}
else
{
status = d_ptr->getselectedstatus(year, month, day, d_ptr->m_syear
, d_ptr->m_smonth, flag.m_chflagd, d_ptr->m_wyear, d_ptr->m_wmonth, d_ptr->m_wday);
}
//修正数据
correntstatus(status, column, flag.m_chflagd);
if (status == 0)
{
continue;
}
qrect rect = rctmp.adjusted(0, 3, 0, -3);
if (rect.height() < 15)
{
rect.setheight(15);
rect.movecenter(rctmp.center());
}
if (status == 2)
{
rect.adjust(-4, 0, 4, 0);
painter.drawrect(rect);
}
else if (status == 1)//只有左半边
{
rect.adjust(-4, 0, -4, 0);
painter.drawroundedrect(rect, rect.height() / 2, rect.height() / 2);
painter.drawrect(rect.adjusted(0, 0, -rect.height() / 2, 0));
}
else if (status == 3)
{
rect.adjust(4, 0, 4, 0);
painter.drawroundedrect(rect, rect.height() / 2, rect.height() / 2);
painter.drawrect(rect.adjusted(rect.height() / 2, 0, 0, 0));
}
else if (status == 5)
{
rect.adjust(4, 0, -4, 0);
painter.drawroundedrect(rect, rect.height() / 2, rect.height() / 2);
}
}
}
painter.restore();
}
4、 调度绘制
最后就是绘制的顺序，这里一定要注意，一定得线绘制背景色，如果是最后绘制的话会挡住当前绘制的文字和选中状态。
void qdatecontent::paintevent(qpaintevent * event)
{
qdate date = qdate::currentdate();
d_ptr->m_tyear = date.year();
d_ptr->m_tmonth = date.month();
d_ptr->m_tday = date.day();
qpainter painter(this);
painter.setrenderhint(qpainter::antialiasing, true);
//painter.drawrect(rect());
d_ptr->resetdayflag();
drawselectedbackground(painter);
drawweek(painter);
drawday(painter);
}
五、相关文章
值得一看的优秀文章：
如果您觉得文章不错，不妨给个打赏，写作不易，感谢各位的支持。您的支持是我最大的动力，谢谢！！！
很重要--转载声明
本站文章无特别说明，皆为原创，版权所有，转载时请用链接的方式，给出原文出处。同时写上原作者： or twowords
如要转载，请原文转载，如在转载时修改本文，请事先告知，谢绝在转载时通过修改本文达到有利于转载者的目的。