目录
1、问题现象
1.1 描述
使用QLineEdit
控件时,常常将它的returnPressed
信号与槽函数链接,用于实现对QLineEdit
控件回车时的处理。但是,有时会出现以下情况:对QLineEdit
控件回车触发链接QLineEdit
的returnPressed
信号的槽函数后,还触发了链接某QPushButton
的clicked
信号的槽函数。如下面这个设计案例:
使用QLineEdit搭配QPushButton实现检索功能,在设计QT界面程序的时候经常会用到,往往都要求能通过两种方式触发检索功能:方式一,点击QPushButton触发;方式二,对QLineEdit回车触发。使用方式二进行触发时,会出现检索两次的问题,即检索功能槽函数被触发两次。
只有一组QLineEdit和QPushButton的情况还是正常。如果有两组QLineEdit和QPushButton,它们分别实现不同的检索功能,使用方式二触发检索,就会有出现以下问题:第二组的QLineEdit被回车时,先调用第二组的检索函数,然后又调用了第一组的检索函数。
1.2 示例程序
main.cpp
#include "dialog.h"
#include <QApplication>
int main(int argc, char *argv[])
{
QApplication a(argc, argv);
Dialog w;
w.show();
return a.exec();
}
dialog.h
#ifndef DIALOG_H
#define DIALOG_H
#include <QDialog>
QT_BEGIN_NAMESPACE
namespace Ui { class Dialog; }
QT_END_NAMESPACE
class Dialog : public QDialog
{
Q_OBJECT
public:
Dialog(QWidget *parent = nullptr);
~Dialog();
private slots:
void searchSheetSlot();
void searchStationSlot();
private:
Ui::Dialog* m_ui;
};
#endif // DIALOG_H
dialog.cpp
#include <QDebug>
#include <QEvent>
#include <QKeyEvent>
#include "dialog.h"
#include "ui_dialog.h"
Dialog::Dialog(QWidget *parent)
: QDialog(parent)
, m_ui(new Ui::Dialog)
{
m_ui->setupUi(this);
connect(m_ui->m_searchSheetLineEdit, SIGNAL(returnPressed()), this, SLOT(searchSheetSlot()));
connect(m_ui->m_searchSheetPushButton, SIGNAL(clicked()), this, SLOT(searchSheetSlot()));
connect(m_ui->m_searchStationLineEdit, SIGNAL(returnPressed()), this, SLOT(searchStationSlot()));
connect(m_ui->m_searchStationPushButton, SIGNAL(clicked()), this, SLOT(searchStationSlot()));
}
Dialog::~Dialog()
{
delete m_ui;
}
void Dialog::searchSheetSlot()
{
qDebug()<<"sheet";
}
void Dialog::searchStationSlot()
{
qDebug()<<"station";
}
1.3 运行结果
程序运行后,对检索sheet的QLineEdit
进行回车,终端打印如下:
程序运行后,对检索station的QLineEdit
进行回车,终端打印如下:
2、理论基础
要理解上述现象,需要了解QPushButton
的两个属性:autoDefault
和 default
。在QT文档里对这两个的解释如下:
2.1 QPushButton的autoDefault属性
autoDefault
:bool
此属性决定按钮是否是自动默认按钮。如果此属性为true
,则按钮是自动默认按钮,否则不是。
在某些GUI样式中,默认按钮周围会额外绘制一个3像素或更多像素的边框。QT会自动在自动默认按钮周围预留这个空间,因为自动默认按钮有成为默认按钮的可能。
对于有QDialog
父对象的按钮,此属性的默认值是true
,否则默认false
。
有关default
和autoDefault
属性如何交互的详细信息,请参阅default
属性。
访问函数:
bool autoDefault() const
void setAutoDefault(bool)
2.2 QPushButton的default属性
default
:bool
此属性决定按钮是否是默认按钮。如果此属性为true
,则按钮是默认按钮,否则不是。
默认和自动默认按钮决定了当用户在对话框(QDialog
)中按下enter
键时发生什么。
当用户按下回车键时,默认按钮将会自动被按下,但有一个例外:如果有一个自动默认按钮当前有焦点,则按下该自动默认按钮。
当对话框有自动默认按钮但没有默认按钮时,按下回车键:如果有自动默认按钮有焦点,则按下该自动默认按钮;如果没有按钮有焦点,则按下焦点链中的下一个自动默认按钮。
在对话框中,一次只能有一个按钮是默认按钮。这个默认按钮会显示一个额外的框(取决于GUI样式)。
默认按钮行为仅在对话框中提供。当按钮有焦点时,可以通过按下键盘空格键点击该按钮。
若在可见对话框的当前默认按钮的default
属性被设为false
,对话框下次收到聚焦时,将自动赋值新的默认按钮。
此属性默认值时false
。
访问函数:
bool isDefault() const
void setDefault(bool)
3、原因总结
在对话框QDialog
中的QPushButton
的autoDefault
属性默认为true
。在对话框中按下回车键,就容易导致按钮也被按下。最终导致QPushButton
的槽函数被某名调用。
4、解决方法
在ui文件编辑器中,将QPushButton的autoDefault属性设置为false。如下所示: