使用Qt开发中国象棋（三）：走棋着法列表

在一个完整的中国象棋游戏中，一般界面上都显示了中文着法，为了简单起见，我开发的这个用了两个着法列表，红方一个，黑方一个，其实用一个就够了，只是感觉那样稍微会麻烦些。着法列表显示了每一步的走棋。下图是着法列表的截图：





着法列表用的是一个叫StepList的类来实现的，因为有两个着法列表，所以用了两个StepList对象。实例化的时候，指定一个特殊的参数用来标示是左边的还是右边的。像下面那样。

leftStepList = new StepList(this, true);
rightStepList = new StepList(this, false);

StepList类包括以下数据成员：

一个QPixmap对象：用来标示是哪一方。

一个QTableView指针对象：用于显示中文着法。

一个QStandardItemModel指针对象：用于向tableView赋值。

四个QPushButton指针对象：用于实现翻页和翻行功能。

一个QLabel指针对象：用于显示当前页面信息。

一个int类型成员：用于标示当前是第几步。在翻页和翻行中用到。

一个QVector容器：用于保存所有的着法历史。

有哪些成员函数，我就不介绍了，大家可以去看代码。

关于tableView，下面是创建的代码：

void StepList::initTableView()
{
tableView = new QTableView(this);
tableView->move(0, 60);

model = new QStandardItemModel(15, 3);
model->setHeaderData(0, Qt::Horizontal, tr("序号"));
model->setHeaderData(1, Qt::Horizontal, tr("走法"));
model->setHeaderData(2, Qt::Horizontal, tr("时间"));

tableView->setSelectionBehavior(QAbstractItemView::SelectRows);
tableView->setModel(model);
tableView->setColumnWidth(0, 30);
tableView->setColumnWidth(1, 70);
tableView->setColumnWidth(2, 75);
tableView->setFixedSize(200, 480);
}

我们指定了tableView是3列15行，显示哪些内容。每列的大小。

翻页和翻行是整个类中最主要的内容，用一个currentOrderNumber的成员变量记录当前走法的序号，根据这个我们可以确定当前页是第几页以及当前页的序号范围，这样我们就可以从vector中取数据，然后显示到界面上，比如说当我们点击“>”按钮后，当前选中的记录就是下一条记录，序号就会加一。下面是下一行和下一页所做的事情：

void StepList::nextRecord()
{
currentOrderNumber++;
updateHistoryDisplay();
}

void StepList::nextPage()
{
currentOrderNumber = std::min(currentOrderNumber + MOVE_STEP_PER_PAGE, vecMoveHistory.size());
updateHistoryDisplay();
}

void StepList::updateHistoryDisplay()
{
QModelIndex modelIndex;
for (int i = 0; i < MOVE_STEP_PER_PAGE; ++i)
{
for (int j = 0; j < COLUMN_PER_STEP; ++j)
{
modelIndex = model->index(i, j, QModelIndex());
model->setData(modelIndex, tr(""));
}
}

int currentPage = getPageNumber(currentOrderNumber);
int totalPage = getPageNumber(vecMoveHistory.size());
int currentRecordIndex = getRecordIndex(currentOrderNumber);

if (vecMoveHistory.size() == 0)
{
btnPrevPage->setEnabled(false);
btnPrevRecord->setEnabled(false);
btnNextRecord->setEnabled(false);
btnNextPage->setEnabled(false);
tableView->clearSelection();
}
else
{
int startIndex = (currentPage - 1) * MOVE_STEP_PER_PAGE;
int endIndex = std::min(currentPage * MOVE_STEP_PER_PAGE, vecMoveHistory.size()) - 1;

for (int i = startIndex; i <= endIndex; i++)
{
modelIndex = model->index(i % MOVE_STEP_PER_PAGE, 0, QModelIndex());
model->setData(modelIndex, vecMoveHistory.at(i).orderNumber);

modelIndex = model->index(i % MOVE_STEP_PER_PAGE, 1, QModelIndex());
model->setData(modelIndex, vecMoveHistory.at(i).moveStepInfo);

modelIndex = model->index(i % MOVE_STEP_PER_PAGE, 2, QModelIndex());
model->setData(modelIndex, vecMoveHistory.at(i).moveStepTime);
}

modelIndex = model->index(currentRecordIndex - 1, 0, QModelIndex());
tableView->setCurrentIndex(modelIndex);

btnPrevRecord->setEnabled(currentRecordIndex > 1);
btnPrevPage->setEnabled(currentPage > 1);
btnNextRecord->setEnabled(currentOrderNumber < vecMoveHistory.size());
btnNextPage->setEnabled(currentPage < totalPage);
}

QString pageInfo;
pageInfo.sprintf("当前页：%d/%d", currentPage, totalPage);
lblPageInfo->setText(pageInfo);
}

翻行和翻页，都是先设置currentOrderNumber的值，让后调用updateHistoryDisplay更新列表显示。我们每走一步完整的棋，记录就会下移一行，就相当于调用nextRecord。