开发环境
操作系统: 银河麒麟V10SP1 qt版本 : 5.12.12
背景
测试同事提出,QLineEdit中设置的占位符(由setPlaceholderText函数设置)文本能完全显示时不要显示tips,不完全显示时要显示tips,这样显得简洁。
想了想逻辑上比较好实现,那就是占位符文本长度大于QLineEdit宽度就显示tips,小于等于就不显示,很清晰。
问题
实际操作,很快就把代码写出来了,如下
QString qstr = ui->lineEdit_set->text();
//获取字符串长度
QFontMetrics qFontMetrics(ui->lineEdit_show->font());
int fontSize = qFontMetrics.width(qstr);
//获得显示输入框宽度
int lineditWidth = ui->lineEdit_show->width();
//判断并设置tips
if(fontSize >= ui->lineEdit_show->width()){
ui->lineEdit_show->setToolTip(qstr);
}else{
ui->lineEdit_show->setToolTip("");
}
//设置占位符
ui->lineEdit_show->setPlaceholderText(qstr);
但是总有一点小问题,一个字符一个字符增加的去试,总会出现一个现象,占位符文本已经不完全显示了但鼠标放在QLineEdit上还是没有出现tips。打日志发现此时fontSize(占位符文本长度)小于lineditWidth(QLineEdit宽度),说明是fontSize或者lineditWidth的值有问题。
这是一个必现问题,可以一探究竟。
排查
排查过程还是比较长的,走了好多弯路就不赘述了。总之疑惑可以从qt源码里解决的。排查过程中以下面的函数为入口。
QString qstrshow = qFontMetrics.elidedText(qstr, Qt::ElideRight, ui->lineEdit_show->width());
qDebug() << "qstrshow = " << qstrshow;
通过传入文本内容、隐藏方式和输入框宽度,elidedText函数会返回文本的最终展示形态。这个函数返回值出现的问题和上面描述的一样。qstr长度比lineEdit_show宽度小,但返回的文本确是隐藏状态(形似 xxxx...)。这样直接跟踪源码即可。
void QLineEdit::paintEvent(QPaintEvent *)内部有如下代码
initStyleOption(&panel);
style()->drawPrimitive(QStyle::PE_PanelLineEdit, &panel, &p, this);
QRect r = style()->subElementRect(QStyle::SE_LineEditContents, &panel, this); //此函数执行完 QLineEdit控件 宽度就会小2个像素
其中>style()->subElementRect调用的是QCommonStyle::subElementRect,其内部执行至
case SE_LineEditContents:
if (const QStyleOptionFrame *f = qstyleoption_cast(opt)) {
//这里进行了调整,调整之后宽度小2个像素
r = f->rect.adjusted(f->lineWidth, f->lineWidth, -f->lineWidth, -f->lineWidth);
r = visualRect(opt->direction, opt->rect, r);
}
break;
f->lineWidth的值是1,此值是在上面的initStyleOption(&panel);中进行赋值。
initStyleOption(&panel)内部调用的是QFusionStyle::pixelMetric,其内部执行的代码如下
case PM_DefaultFrameWidth:
return 1; // Do not dpi-scale because the drawn frame is always exactly 1 pixel thick
接着回到void QLineEdit::paintEvent(QPaintEvent *)中,执行到
QRect lineRect(r.x() + d->horizontalMargin, d->vscroll, r.width() - 2*d->horizontalMargin, fm.height()); //在r的基础上生成lineRect
d->horizontalMargin的值是2,来自const int QLineEditPrivate::horizontalMargin(2);//这样lineRect比r又小了4像素
经过源码分析,发现实际用的QLineEdit宽度比传入的小了6像素,所以比较的时候需要把QLineEdit的宽度减6,更新代码如下
int offset = -6;
if(fontSize >= ui->lineEdit_show->width() + offset){
ui->lineEdit_show->setToolTip(qstr);
}else{
ui->lineEdit_show->setToolTip("");
}
ui->lineEdit_show->setPlaceholderText(qstr);
注意
如果没有任何样式影响,结果就如上面所示。如果有样式(例如内外边距)影响,则要再进行额外处理QLineEdit宽度。