Qt股票组件之自选股列表拖拽、右键常用菜单功能的实现

时间：2022-09-21 11:53:52

一、开头嘴一嘴

本文带领大家来看看自选股列表的实现。

如果有需要的朋友可以加我好友，有偿提供源码、或者也可以进一步提供功能定制

封装的控件，或者demo都是没有样式的，所以看着会比较丑一些，不过加样式也是分分钟。。。这里咱可以先看功能，需要即可定制

本篇文章的自选股和大多数炒股软件一样，每一条自选都是支持拖拽的，拖拽时鼠标会跟随一个拖拽映像，并且鼠标移动时，会有拖拽提示，告知我们鼠标释放时拖拽项将会被插入到哪个位置。除过拖拽之外，自选股列表还支持右键菜单，都是一样常用的操作。

右键菜单包括置顶、置低、删除、下移一项、上移一项等

本篇文章中不包括的功能也可以提供定制，需求合理即可。

下面来具体说一说这个功能的实现思路，会公开大多数核心代码，有需要的同学可以根据思路自行完善整个代码。

二、效果展示

如下效果图所示，是自选股使用上的一个展示效果，具有如下功能

1.搜索编辑框，支持股票代码和股票名称搜索
2.搜索预览框支持鼠标hover，并且可以使用键盘上下键进行当前项切换，单机时支持切换自选股
3.自选股列表，支持拖拽，拖拽时会有拖拽项映像，并示意将要拖拽到哪个位置
4.支持右键菜单，可以对某一项进行移动，删除等操作

Qt股票组件之自选股列表拖拽、右键常用菜单功能的实现

如果觉着demo比较丑的话，可以看财联社-产品展示这篇文章中的效果图

三、自选股列表

接下来就是我们这篇文章的重头戏了，也是比较复杂的一个内容。

自选股列表我选择的是使用QListWidget来实现，然后每一个item上在放一个Widget即可，Widget就是我们定制窗体内容，这里我们主要讲解几个比较重要的核心内容

1、列表初始化

初始化StockList，实际上自选股列表应该从服务器拉取，我们这里作为demo测试，因此就自己模拟了5条数据进行插入。

  1. //已选个股列表
  2. d_ptr->m_pStockList = new StockList;
  3. connect(d_ptr->m_pStockList, &StockList::RowClicked, this, [this](const QString & symbol){
  4. emit RowClicked(symbol);
  5. });
  6.  
  7. //测试数据 正常情况下 应该是列表自己拉取
  8. OptionalMarketItem item;
  9. for (int i = 1; i <= 5; ++i)
  10. {
  11. item.wstrSymbol = QString("0h000%1").arg(i).toStdWString();
  12. item.wstrName = QString("%1%1%1").arg(i).toStdWString();
  13. item.wstrIndustryName = QString("pingyin%1").arg(i).toStdWString();
  14.  
  15. d_ptr->m_pStockList->AddItem(item);
  16. }

2、添加Item

往StockList中添加item项时，我们首先需要构造一个标准的QListWidgetItem结构，然后把我们自己定制的ListItem放到这个标准item结构上。

  1. QListWidgetItem * StockList::AddItem(const OptionalMarketItem & data)
  2. {
  3. ListItem * itemWidget = new ListItem;
  4. itemWidget->SetData(data);
  5. QListWidgetItem * item = new QListWidgetItem;
  6. addItem(item);
  7. item->setSizeHint(QSize(0, 50));
  8. setItemWidget(item, itemWidget);
  9. return item;
  10. }

ListItem就是一个普通的QWidget，上边排列了一些QLabel，用于显示我们的股票数据。

ListItem界面构造就不过多解释了，唯一需要说明的就是，我们股票数据发送变化时，界面上会有红绿色框的动画提示，这里需要调用两行代码来实现重新获取控件qss代码，并刷洗界面。

  1. this->style()->unpolish(this);
  2. this->style()->polish(this);

3、右键菜单

本篇文章和上一篇文章的右键菜单实现方式一样，都是参考我很早以前写的Qt之自定义QLineEdit右键菜单这篇文章，实现默认的contextMenuEvent函数即可。

右键菜单已经说的很多了，这里就一笔带过了，需要的同学可以自己快速的瞅一眼，应该比较容易理解。

  1. void StockList::contextMenuEvent(QContextMenuEvent * event)
  2. {
  3. if (d_ptr->m_AllowMenu == false)
  4. {
  5. return;
  6. }
  7. if (d_ptr->m_ContextMenu == nullptr)
  8. {
  9. d_ptr->m_ContextMenu = new QMenu(this);
  10. d_ptr->m_ContextMenu->setObjectName(QStringLiteral("StockListMenu"));
  11. d_ptr->m_ContextMenu->setFixedWidth(100);
  12. QAction * delAct = new QAction(QStringLiteral("删除自选股"), d_ptr->m_ContextMenu);
  13. QAction * topAct = new QAction(QStringLiteral("置顶"), d_ptr->m_ContextMenu);
  14. QAction * bottomAct = new QAction(QStringLiteral("置底"), d_ptr->m_ContextMenu);
  15. QAction * upAct = new QAction(QStringLiteral("上移一位"), d_ptr->m_ContextMenu);
  16. QAction * downAct = new QAction(QStringLiteral("下移一位"), d_ptr->m_ContextMenu);
  17. connect(delAct, &QAction::triggered, this, &StockList::DeleteSotck);
  18. connect(topAct, &QAction::triggered, this, &StockList::TopSotck);
  19. connect(bottomAct, &QAction::triggered, this, &StockList::BottomSotck);
  20. connect(upAct, &QAction::triggered, this, &StockList::UpSotck);
  21. connect(downAct, &QAction::triggered, this, &StockList::DownSotck);
  22. d_ptr->m_ContextMenu->addAction(delAct);
  23. d_ptr->m_ContextMenu->addAction(topAct);
  24. d_ptr->m_ContextMenu->addAction(bottomAct);
  25. d_ptr->m_ContextMenu->addAction(upAct);
  26. d_ptr->m_ContextMenu->addAction(downAct);
  27. }
  28. d_ptr->m_ContextMenu->exec(mapToGlobal(event->pos()));
  29. QListWidget::contextMenuEvent(event);
  30. }

以上5个菜单，虽然看起来功能相差很多，但是其实处理逻辑基本都是一样的，先是一个内容结构排序，然后进行刷新数据到界面上。

为了节省篇幅，我这里就只介绍置顶一只股票的操作

置顶的逻辑看起来是这样的

1.移除当前项
2.并且把当前项item插入到新位置
3.构造一个新的Widget，设置给item
4.把新位置的item设置为当前选中项
5.上传最新列表到数据中心，或者服务器

  1. void StockList::TopSotck()
  2. {
  3. QListWidgetItem * item = currentItem();
  4. if (item == nullptr)
  5. {
  6. return;
  7. }
  8. if (row(item) == 0)
  9. {
  10. return;
  11. }
  12. ListItem * itemWidget = ItemWidget(item);
  13. QListWidgetItem * newItem = takeItem(row(item));
  14. insertItem(0, newItem);
  15. ListItem * topWidget = new ListItem;
  16. topWidget->SetData(itemWidget->GetData());
  17. setItemWidget(newItem, topWidget);
  18. if (itemWidget)
  19. {
  20. itemWidget->close();
  21. itemWidget = nullptr;
  22. }
  23. setCurrentItem(newItem);
  24. StorageData();
  25. }

4、拖拽Item

拖拽Item应该算是一个比较难一点儿功能，好在Qt已经为我们实现了一套QDrag事件的回调方法，也比较好使，如下图所示，重写如下4个方法，基本的拖拽事件就能完成了。

但是这里我么有选择默认的这个回调函数来实现这个功能，其中最大的原因就是，他们的可定制性太局限了。

我这里采取的是自己模拟鼠标拖拽功能，同过重写如下几个函数来达到我的目的

  1. virtual void mousePressEvent(QMouseEvent * event) override;
  2. virtual void mouseMoveEvent(QMouseEvent * event) override;
  3. virtual void mouseReleaseEvent(QMouseEvent * event) override;
  4. virtual void enterEvent(QEvent * event) override;
  5. virtual void leaveEvent(QEvent * event) override;

1.鼠标按下时，主要是记录了一些内容状态，方便在鼠标移动时去做判断，并决定是否启用鼠标拖拽功能
2.鼠标移动就比较复杂了，进行了各种对比，还需要移动被拖拽项的映像位置，移动那一根水平线的位置
3.鼠标释放时，调整整个列表的内容
4.鼠标进入窗体时，显示水平标识线
5.鼠标离开窗体时，隐藏水平标识线

上边只是粗略的描述了这几个函数的功能， 因为函数实现体都比较长，因此这里我也是选择几个关键点来做以说明。

a、move函数

产生拖拽时，移动鼠标，我们需要处理很多事件，比如

1、初始化水平表示线和拖拽项映像

  1. if (d_ptr->m_ShotLine == nullptr)
  2. {
  3. InitShotLine();
  4. }
  5. if (d_ptr->m_ShotPicture == nullptr)
  6. {
  7. InitShotLabel();
  8. }

2、拖拽时修改鼠标状态

根据拖拽启动后，鼠标是否还在当前拖拽项上，设置鼠标的状态。

  1. if (ListItem * newWidget = ItemWidget(d_ptr->dragItem))
  2. {
  3. d_ptr->m_ShotPicture->move(QCursor::pos() - d_ptr->dragItemPos);
  4. d_ptr->m_DragRect = visualItemRect(d_ptr->dragItem);
  5. if (d_ptr->m_DragRect.contains(event->pos()) || event->pos().isNull())
  6. {
  7. if ((event->pos() - d_ptr->startPos).manhattanLength() > 5)
  8. {
  9. setCursor(Qt::ForbiddenCursor);
  10. }
  11. }
  12. else
  13. {
  14. setCursor(Qt::ArrowCursor);
  15. }
  16. if (d_ptr->m_ShotPicture->isHidden())
  17. {
  18. d_ptr->m_ShotPicture->show();
  19. }
  20. }

b、release函数

鼠标释放时，把拖拽项移动到新的位置

  1. if (ListItem * oldWidget = ItemWidget(d_ptr->dragItem))
  2. {
  3. QListWidgetItem * newItem = new QListWidgetItem;
  4. ListItem * itemWidget = new ListItem;
  5. itemWidget->SetData(oldWidget->GetData());
  6.  
  7. insertItem(insertPos, newItem);
  8. newItem->setSizeHint(QSize(0, 50));
  9. setItemWidget(newItem, itemWidget);
  10.  
  11. setCurrentItem(newItem);
  12.  
  13. oldWidget->deleteLater();
  14. }

5、刷新数据

全量刷新数据。在原来的列表上刷新数据

当原始列表行数不够时，构造新的行

当原始列表函数多时，移除末尾多的行

  1. void StockList::Update_p(OptionalMarketItemVector data)
  2. {
  3. d_ptr->m_bOnceLoad = true;
  4. disconnect(this, &QListWidget::currentItemChanged, this, &StockList::CurrentItemChanged);
  5. int i = 0;
  6. for (auto iter = data.begin(); iter != data.end(); ++iter, ++i)
  7. {
  8. bool success = false;
  9. if (QListWidgetItem * item = this->item(i))
  10. {
  11. if (ListItem * itemWidget = ItemWidget(item))
  12. {
  13. itemWidget->SetData(*iter);
  14. success = true;
  15. }
  16. }
  17. if (!success)
  18. {
  19. AddItem(*iter);
  20. }
  21. }
  22. if (i < this->count())
  23. {
  24. QListWidgetItem * item = nullptr;
  25. while (item = this->item(i))
  26. {
  27. if (ListItem * itemWidget = ItemWidget(item))
  28. {
  29. itemWidget->close();
  30. itemWidget = nullptr;
  31. }
  32. item = takeItem(i);
  33. delete item;
  34. }
  35. }
  36. if (d_ptr->m_LeftPress == false)
  37. {
  38. RecoveryCurrentItem();
  39. }
  40. connect(this, &QListWidget::currentItemChanged, this, &StockList::CurrentItemChanged);
  41. }

总结

以上所述是小编给大家介绍的Qt股票组件之自选股列表拖拽、右键常用菜单功能的实现 ,希望对大家有所帮助，如果大家有任何疑问请给我留言，小编会及时回复大家的。在此也非常感谢大家对我们网站的支持！
如果你觉得本文对你有帮助，欢迎转载，烦请注明出处，谢谢！

标签：

相关文章