在 QT 中使用箭头在小部件之间导航

Question

我正在使用 QT 开发 UI。用户界面很简单，它是基于 iPhone 或 Android 的应用程序。假设有 9 个项目（3 行 x 3 列）。

我想做的是使用箭头键在小部件之间导航。 如果焦点在 [row 1,col 1] 并且我按下箭头，我希望它转到 [row 2, col 1] 另一个例子。 如果焦点在 [row 2,col 3] 并且我按向上箭头，我希望它转到 [row 1, col 3]

但当前的行为是向上和向右总是转到下一个小部件，向下和向左总是转到上一个小部件。

有没有办法在 qt 中做到这一点？或者我需要创建一些算法来做到这一点？

谢谢

Answer 1

更新：见最后的惊人示例。

基本的 Widget 焦点导航是这样开始的：

http://qt-project.org/doc/qt-4.8/focus.html

使用QTableView 可以轻松使用箭头导航：

http://qt-project.org/doc/qt-4.8/qtableview.html#navigation

如果您可以让您的小部件在 QTableView 的结构中工作，那么您不需要实现它，它是包装器/视图小部件的一部分。

http://qt-project.org/doc/qt-4.8/qtablewidget.html#details

http://qt-project.org/doc/qt-4.8/model-view-programming.html

模型视图编程确实有学习曲线，但值得学习和使用。

但这绝不是实现这一目标的唯一方法。

无需使用QTableView 或QTableWidget，就可以利用事件过滤器、关键事件、焦点事件来完成这一壮举。但是找出最好的方法而不让它看起来很乱可能需要一些时间。

http://qt-project.org/doc/qt-4.8/qcoreapplication.html#notify

http://doc.qt.digia.com/qq/qq11-events.html

http://qt-project.org/doc/qt-4.8/eventsandfilters.html

http://qt-project.org/doc/qt-4.8/qkeyevent.html#details

http://qt-project.org/doc/qt-4.8/qfocusevent.html

键事件被设置为具有焦点的项目，如果它们忽略该事件，它会传播到其父项。因此，只要您的表格/网格中的项目忽略与箭头键有关的键事件，那么您就可以让您的父小部件侦听键事件并适当地处理它们。

http://qt-project.org/doc/qt-4.8/qt.html#Key-enum

http://qt-project.org/doc/qt-4.8/qt.html#FocusReason-enum

http://qt-project.org/doc/qt-4.8/qwidget.html#setFocus

http://qt-project.org/doc/qt-4.8/qapplication.html#focusWidget

希望对您有所帮助。

编辑：QGraphicsView 中您想要做什么的完整工作示例：

Qt Creator > Welcome tab > Examples > Pad Navigator Example

http://qt-project.org/doc/qt-4.8/graphicsview-padnavigator.html

以下是示例中的相关代码：

// Enable key navigation using state transitions
for (int y = 0; y < rows; ++y) {
    for (int x = 0; x < columns; ++x) {
        QState *state = stateGrid[y][x];
        QKeyEventTransition *rightTransition = new QKeyEventTransition(this, QEvent::KeyPress,
                                                                       Qt::Key_Right, state);
        QKeyEventTransition *leftTransition = new QKeyEventTransition(this, QEvent::KeyPress,
                                                                      Qt::Key_Left, state);
        QKeyEventTransition *downTransition = new QKeyEventTransition(this, QEvent::KeyPress,
                                                                      Qt::Key_Down, state);
        QKeyEventTransition *upTransition = new QKeyEventTransition(this, QEvent::KeyPress,
                                                                    Qt::Key_Up, state);
        rightTransition->setTargetState(stateGrid[y][(x + 1) % columns]);
        leftTransition->setTargetState(stateGrid[y][((x - 1) + columns) % columns]);
        downTransition->setTargetState(stateGrid[(y + 1) % rows][x]);
        upTransition->setTargetState(stateGrid[((y - 1) + rows) % rows][x]);

编辑： 使用QShortcuts 和QGridLayout 以及一堆QPushButtons 的惊人示例：

widget.cpp

#include "widget.h"
#include <QPushButton>
#include <QApplication>
#include <QShortcut>

Widget::Widget(QWidget *parent)
    : QWidget(parent)
{
    m_grid = new QGridLayout;
    for(int r = 0; r < 10; r++)
    {
        for(int c = 0; c < 10; c++)
        {
            m_grid->addWidget(new QPushButton("Row " + QString::number(r)
                                              + ", Col " + QString::number(c)),
                              r, c);
        }
    }
    this->setLayout(m_grid);

    m_grid->itemAtPosition(1, 1)->widget()->setFocus();

    this->setStyleSheet("QPushButton::focus{ background: black; color: white;}");

    // only works for in Qt for Embedded Linux, Symbian and Windows CE only.
    //    QApplication::setNavigationMode(Qt::NavigationModeKeypadDirectional);

    QShortcut * shortcut;
    shortcut = new QShortcut(QKeySequence(Qt::Key_Up),this,
                             SLOT(on_up()));
    shortcut = new QShortcut(QKeySequence(Qt::Key_Down),this,
                             SLOT(on_down()));
    shortcut = new QShortcut(QKeySequence(Qt::Key_Left),this,
                             SLOT(on_left()));
    shortcut = new QShortcut(QKeySequence(Qt::Key_Right),this,
                             SLOT(on_right()));
}

void Widget::on_up()
{
    moveFocus(0, -1);
}

void Widget::on_down()
{
    moveFocus(0, 1);
}

void Widget::on_left()
{
    moveFocus(-1, 0);
}

void Widget::on_right()
{
    moveFocus(1, 0);
}

void Widget::moveFocus(int dx, int dy)
{
    if(qApp->focusWidget() == 0)
        return;
    int idx = m_grid->indexOf(qApp->focusWidget());
    if(idx == -1)
        return;
    int r, c, rowSpan, colSpan;
    m_grid->getItemPosition(idx, &r, &c, &rowSpan, &colSpan);
    QLayoutItem* layoutItem = m_grid->itemAtPosition(r + dy, c + dx);
    if(layoutItem == 0)
        return;
    layoutItem->widget()->setFocus();
}

Widget::~Widget()
{

}

小部件.h

#ifndef WIDGET_H
#define WIDGET_H

#include <QWidget>
#include <QGridLayout>

class Widget : public QWidget
{
    Q_OBJECT

public:
    Widget(QWidget *parent = 0);
    ~Widget();
    QGridLayout * m_grid;
public slots:
    void on_up();
    void on_down();
    void on_left();
    void on_right();
    void moveFocus(int dx, int dy);
};

#endif // WIDGET_H

main.cpp

#include "widget.h"
#include <QApplication>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    Widget w;
    w.show();

    return a.exec();
}

Answer 2

要启用键盘导航，构建 Qt 并定义 QT_KEYPAD_NAVIGATION。 https://het.as.utexas.edu/HET/Software/html/qapplication.html#keypadNavigationEnabled