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