QPushButton 之 default、autoDefault 分析

QPushButton，很常见很简单的一个东西。可以今天还是被它的一个default属性弄晕了。QDialog中添加一个QDialogButtonBox，然后其中始终有一个button始终处于default状态，死活去不掉... 到底怎么了... 从头理理了，于是便有了本文

focus 与 default

QPushButton 的这两个属性都影响其外观，如下图所示，在vista系统下：

 

外观

特性

focus

按钮有虚框

按下“空格”触发按钮点击(与是否QDialog无关)

default

按钮有蓝色的边界

“回车”触发按钮的点击(在QDialog下)

default属性只有在按钮在QDialog中时才会发挥作用。在QDialog中，只能有一个QPushButton按钮处于default状态。

注意： 当其在非QDialog的窗口中时，尽管外观看起来和其在QDialog中是一样，但是不能通过“回车”进行触发该按钮。这时我们也可以设置多个按钮的default的属性，当然，除了影响下外观外也没什么用。

因为default属性只与QDialog中的QPushButton有关，故下面的讨论均基于QDialog。

default 与 autoDefault

QPushButton的Manual中说：当我们按下回车键的时候，

• 如果QDialog中有default的按钮，该按钮的click将被触发，除非是其他autoDefault的按钮正拥有焦点。
• 如果QDialog中没有default的按钮，
  • 其他的autoDefault拥有焦点，那么该autoDefault按钮被触发
  • 其他的autoDefault没有焦点，QDialog会自动选择一个autoDefault进行触发

似乎很难理解？对不，我试试换种表达方式：

• QDialog 在显示之前(调用show、setVisible等函数)，它会遍历自己的按钮，如果没有default按钮，它会将某个autoDefault的按钮设为default。
• 如果有个按钮正拥有焦点，那么它肯定将先于QDialog获得“回车键”。
  • 此时，如果自己default或autoDefault属性为真，则触发自己的click
  • 反之，“回车”事件转发到了QDialog。
• QDialog 获得“回车键”后，触发其default按钮的点击。

呵呵，看完代码后，觉得Manual中说得还是蛮到位的，只是，不看源码，Manual中提到的东西，太...难理解了

没代码，没真相

没代码，没真相，用代码来证明我前面提到的内容 ^_^

显示之前

在Qt 之 show,hide,setVisible,setHidden,close 等小结一文中，我们知道：show、hide、setHidden等都是setVisible的马甲，而setVisible是个虚函数。我们就看看它的QDialog的版本吧：

void QDialog::setVisible(bool visible){    Q_D(QDialog);    if (visible) {        QWidget *fw = window()->focusWidget();        if (!fw)            fw = this;        if (!d->mainDef && isWindow()) {            QWidget *w = fw;            while ((w = w->nextInFocusChain()) != fw) {                QPushButton *pb = qobject_cast<QPushButton *>(w);                if (pb && pb->autoDefault() && pb->focusPolicy() != Qt::NoFocus) {                    pb->setDefault(true);                    break;                }            }        }...

这段代码：如果没有 主default 按钮，则按照focus链搜索第一个拥有autoDefault属性，且可以接受焦点的按钮，设置其 default 属性为真！

拥有焦点的按钮

接受键盘事件，首先要拥有焦点。那么我们看看，拥有焦点的按钮如何响应回车的：

void QPushButton::keyPressEvent(QKeyEvent *e){    Q_D(QPushButton);    switch (e->key()) {    case Qt::Key_Enter:    case Qt::Key_Return:        if (autoDefault() || d->defaultButton) {            click();            break;        }        // fall through    default:        QAbstractButton::keyPressEvent(e);    }}

很简单直接，不用多说。

QDialog响应回车

void QDialog::keyPressEvent(QKeyEvent *e){    if (!e->modifiers() || (e->modifiers() & Qt::KeypadModifier && e->key() == Qt::Key_Enter)) {        switch (e->key()) {        case Qt::Key_Enter:        case Qt::Key_Return: {            QList<QPushButton*> list = qFindChildren<QPushButton*>(this);            for (int i=0; i<list.size(); ++i) {                QPushButton *pb = list.at(i);                if (pb->isDefault() && pb->isVisible()) {                    if (pb->isEnabled())                        pb->click();                    return;                }            }        }        break;        case Qt::Key_Escape:            reject();            break;

接到回车键时，搜索自己的按钮，找到default属性的按钮，则调用其click。

再看default与autoDefault

如果我们没有设置 autoDefault属性，那么该属性的返回值在QDialog下为真，其他下为假。原因如下：

bool QPushButton::autoDefault() const{    Q_D(const QPushButton);    if(d->autoDefault == QPushButtonPrivate::Auto)        return ( d->dialogParent() != 0 );    return d->autoDefault;}

当我们设置某个按钮的default属性时，如果在QDialog下，它会将自己设置为该对话框的主default按钮

void QPushButton::setDefault(bool enable){    Q_D(QPushButton);    if (d->defaultButton == enable)        return;    d->defaultButton = enable;    if (d->defaultButton) {        if (QDialog *dlg = d->dialogParent())            dlg->d_func()->setMainDefault(this);    }

如果按钮拥有autoDefault属性，焦点进入时，设置自己为default，焦点离开，则取消设置

void QPushButton::focusInEvent(QFocusEvent *e){    Q_D(QPushButton);    if (e->reason() != Qt::PopupFocusReason && autoDefault() && !d->defaultButton) {        d->defaultButton = true;        QDialog *dlg = qobject_cast<QDialog*>(window());        if (dlg)            dlg->d_func()->setDefault(this);    }    QAbstractButton::focusInEvent(e);}void QPushButton::focusOutEvent(QFocusEvent *e){    Q_D(QPushButton);    if (e->reason() != Qt::PopupFocusReason && autoDefault() && d->defaultButton) {        QDialog *dlg = qobject_cast<QDialog*>(window());        if (dlg)            dlg->d_func()->setDefault(0);        else            d->defaultButton = false;    }

QDialogButtonBox

它的Manual中说：

• 你可以设置其中的某个按钮的default属性

• 如果没有设置，在显示之前，它会将第一个拥有AcceptRole角色的按钮设置为default

代码如下：

bool QDialogButtonBox::event(QEvent *event){    Q_D(QDialogButtonBox);    if (event->type() == QEvent::Show) {        QList<QAbstractButton *> acceptRoleList = d->buttonLists[AcceptRole];        QPushButton *firstAcceptButton = acceptRoleList.isEmpty() ? 0 : qobject_cast<QPushButton *>(acceptRoleList.at(0));        bool hasDefault = false;        QWidget *dialog = 0;        QWidget *p = this;        while (p && !p->isWindow()) {            p = p->parentWidget();            if ((dialog = qobject_cast<QDialog *>(p)))                break;        }        foreach (QPushButton *pb, qFindChildren<QPushButton *>(dialog ? dialog : this)) {            if (pb->isDefault() && pb != firstAcceptButton) {                hasDefault = true;                break;            }        }        if (!hasDefault && firstAcceptButton)            firstAcceptButton->setDefault(true);

参考

• http://doc.qt.nokia.com/4.7/qdialog.html

• http://doc.qt.nokia.com/4.7/qpushbutton.html

• http://doc.qt.nokia.com/4.7/qdialogbuttonbox.html

 

转自：http://blog.csdn.net/dbzhang800/article/details/6308308