QLineEdit文本长度和框宽度的比较问题

开发环境

            操作系统: 银河麒麟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宽度。