下面是一个完整的示例,长 71 行,呈现在文学编程风格 http://www.wikiwand.com/en/Literate_programming。它也可以在github https://github.com/KubaO/stackoverflown/tree/master/questions/sm-cards-37656060。该示例由 qmake 组成.pro
文件,未显示,以及main.cpp
,如下所示。该示例具有以下结构:
- Header
- 卡牌项目
- 状态机行为
- Main
- Footer
Main
首先,让我们设置场景:
int main(int argc, char ** argv) {
QApplication app{argc, argv};
QGraphicsScene scene;
QGraphicsView view{&scene};
scene.addItem(new CardItem(0, 0, "A"));
scene.addItem(new CardItem(20, 0, "B"));
状态机具有三种状态:
QStateMachine machine;
QState s_idle{&machine}; // idle - no card selected
QState s_selected{&machine}; // card selected, waiting 1/2 second
QState s_ready{&machine}; // ready with card selected
machine.setInitialState(&s_idle);
我们将使用辅助函数以声明方式向机器添加行为。这不是唯一可能的模式,但它有效并且相当容易应用。首先,当选择任何项目时,状态会从s_idle
to s_selected
:
on_selected(&s_idle, &scene, true, &s_selected);
然后,超时后,状态变为s_ready
:
on_delay(&s_selected, 500, &s_ready);
如果取消选择项目,我们将返回s_idle
:
on_selected(&s_selected, &scene, false, &s_idle);
on_selected(&s_ready, &scene, false, &s_idle);
由于我们没有更好的事情可做,因此我们可以简单地取消选择所有项目s_ready
已进入状态。这清楚地表明已进入该状态。当然,由于选择被清除,它会立即离开,我们在上面指出了这一点s_idle
是没有选择任何项目时的状态。
QObject::connect(&s_ready, &QState::entered, &scene, &QGraphicsScene::clearSelection);
我们现在可以启动机器并运行我们的应用程序:
machine.start();
view.show();
return app.exec();
}
请注意,显式动态内存分配的使用最少,并且没有任何手动内存管理。
卡牌项目
The CardItem
class 是一个简单的卡片图形项目。该项目是可选择的。它也可以是可移动的。交互由图形视图框架自动处理:您不必手动处理解释鼠标按下/拖动/释放 - 至少现在还不需要。
class CardItem : public QGraphicsObject {
Q_OBJECT
const QRect cardRect { 0, 0, 80, 120 };
QString m_text;
QRectF boundingRect() const Q_DECL_OVERRIDE { return cardRect; }
void paint(QPainter * p, const QStyleOptionGraphicsItem*, QWidget*) {
p->setRenderHint(QPainter::Antialiasing);
p->setPen(Qt::black);
p->setBrush(isSelected() ? Qt::gray : Qt::white);
p->drawRoundRect(cardRect.adjusted(0, 0, -1, -1), 10, 10);
p->setFont(QFont("Helvetica", 20));
p->drawText(cardRect.adjusted(3,3,-3,-3), m_text);
}
public:
CardItem(qreal x, qreal y, const QString & text) : m_text(text) {
moveBy(x, y);
setFlags(QGraphicsItem::ItemIsSelectable);
}
};
状态机行为
将状态机行为分解为可用于声明给定状态下的行为的函数会很有帮助。
首先,延迟——一旦src
进入状态,并经过给定的毫秒数,机器转换到目标状态:
void on_delay(QState * src, int ms, QAbstractState * dst) {
auto timer = new QTimer(src);
timer->setSingleShot(true);
timer->setInterval(ms);
QObject::connect(src, &QState::entered, timer, static_cast<void (QTimer::*)()>(&QTimer::start));
QObject::connect(src, &QState::exited, timer, &QTimer::stop);
src->addTransition(timer, SIGNAL(timeout()), dst);
}
为了拦截选择信号,我们需要一个发出通用信号的辅助类:
class SignalSource : public QObject {
Q_OBJECT
public:
Q_SIGNAL void sig();
SignalSource(QObject * parent = Q_NULLPTR) : QObject(parent) {}
};
然后,我们利用这种通用信号源来描述当给定场景有选择时转换到目标状态的行为 iffselected
为 true,或者没有选择 iffselected
是假的:
void on_selected(QState * src, QGraphicsScene * scene, bool selected, QAbstractState * dst) {
auto signalSource = new SignalSource(src);
QObject::connect(scene, &QGraphicsScene::selectionChanged, signalSource, [=] {
if (scene->selectedItems().isEmpty() == !selected) emit signalSource->sig();
});
src->addTransition(signalSource, SIGNAL(sig()), dst);
}
页眉和页脚
该示例以以下标头开始:
// https://github.com/KubaO/stackoverflown/tree/master/questions/sm-cards-37656060
#include <QtWidgets>
它以以下页脚结尾,包含 moc 生成的信号实现和对象元数据SignalSource
class.
#include "main.moc"