现在的位置: 首页 > 自动控制 > 工业·编程 > 正文

QPushButton 之 default、autoDefault 分析

2014-05-10 23:09 工业·编程 ⁄ 共 4864字 ⁄ 字号 暂无评论

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);

作者:dbzhang800

给我留言

留言无头像?