从零开始做3D地图编辑器（十二）(基于QT与OGRE)

六、实体管理（QTreeWidget、QFileDialog）

这一节的内容相对来说比较多，但是依然是很简单，只不过因为我们要求的操作比较多，制作起来比较麻烦一点而已。最后成品如下图：



在开始之前先把实体管理的XML表确定下来。暂时定了以下结构：

<GroupList>

<Group name=”Tree”/>

<Group name=”House”/>

</GroupList>

<EntityList>

<Entity name=”Test” filename=”test.mesh” Group=”Tree” />

</EntityList>

用名字字符串还是ID，这是个很纠结的问题，不过只是使用编辑器的话那倒无所谓，编辑器在乎的是其稳定性与实用性，效率只要不是太差，一般都能接受（有些商业引擎编译时间那是相当地长啊）。

根据XML表就可以确定树型结构的层次，这种简单的实体管理把层级设定超过两层，简直就是找抽行为。

完成XML表后，现在来分析更细的需求：
1、工具栏：实体管理还有一些常用操作，我把它们分为添加组，删除组，添加实体，删除实体，清空组，清空所有。
2、编辑修改：组这一层不支持从文件中提取，只能由工具栏添加，所以我们要支持双击修改保存文字，实体则是由文件对话框添加的，以后配合好属性栏，就能很方便的修改，所以不需要双击编辑修改。
3、右键菜单：组这一层对应的操作应该是添加实体，删除组，清空组，而实体这一层则只有删除实体这个选项。
4、图标：工具栏肯定需要图标，组和实体前面也需要一个图标，不然看一堆文字很不舒服。
5、拖放：实体可以拖到另一个组。
需求确定后，首先按照上一节的方法新建一个Dock Widget，命名为m_pEntityDock。并把它的可挂接的位置，设为左，右，下三个区域，默认区域设为左侧。
然后我们添加一个新类，类名叫EntityViewWidget，继承于QWidget，构造函数接受父类指针，并把它赋给Qwidget。
类申明如下：

class EntityViewWidget : public QWidget

{

Q_OBJECT;

public:

explicit EntityViewWidget(QWidget *parent = 0);

virtual ~EntityViewWidget();

public Q_SLOTS:

void                                       SSelectionChanged();

void                                       SRemoveGroup();

void                                       SAddGroup();

void                                       SClearGroup();

void                                       SClearAll();

void                                       SRemoveEntity();

void                                       SAddEntity();

protected:

static const int                                     MAX_GROUP_COUNT = 64;

EntityTreeWidget                       *m_pTreeWidget;

QToolBar                                      *m_pToolBar;

QAction                                                  *m_pAddGroup;

QAction                                                  *m_pRemoveGroup;

QAction                                                  *m_pClearGroup;

QAction                                                  *m_pClearAll;

QAction                                                  *m_pAddEntity;

QAction                                                  *m_pRemoveEntity;

QTreeWidgetItem                               *m_pRootItems[MAX_GROUP_COUNT];

QTreeWidgetItem                               *m_pCurrGroupItem;

QTreeWidgetItem                               *m_pCurrEntityItem;

bool                                                         RemoveGroup(int index);

int                                                            m_nGroupCount;

};

先按照第四节的方法在里面创建一个QToolBar，并添加6个基于图标的QAction，并按照上章QT基础里面介绍设定自定义Slot的方法，分别设定好公有Slot函数(SAddEntity、SRemoveEntity、SAddGroup、SRemoveGroup、SClearGroup、SClearAll)，因为QT的函数使用的是小写字母开头的驼峰式，所以我把自定义的SLOT用S前缀命名，以免混淆，而普通函数则是大写字母开头，注：这种命名方式并不一定是最好的命名方式。

Slots中有一个SSelectionChanged()，这是针对QTreeWidget的信号itemSelectionChanged的槽，因为添加删除操作和当前选中的item相关联，在这个Slot里面就添加了选中处理代码。
MAX_GROUP_COUNT指的是允许的最大组数。因为QTreeWidget只是指向指针，所以要申请空间给QTreeWidgetItem，这里使用了预分配机制，配合一个int型的m_nGroupCount来避免遍历的工作,这个具体在后面再说。
留了两个指针分别表示当前选中的组和实体，之所以把它们分开是因为有可能会同时用到两个。
EntityTreeWidget是自定义的QTreeWidget，类申明如下：

class EntityTreeWidget : public QTreeWidget

{

Q_OBJECT;

public:

EntityTreeWidget(QWidget *parent = 0);

virtual ~EntityTreeWidget() {};

public Q_SLOTS:

void                    SItemEditDone();

protected:

QTreeWidgetItem            *m_pCurrentItem;

void                                       mousePressEvent(QMouseEvent *evt);

void                                       dragEnterEvent(QDragEnterEvent *evt);

void                                       dragMoveEvent(QDragMoveEvent *evt);

void                                       dropEvent(QDropEvent *evt);

void                                       contextMenuEvent(QContextMenuEvent *evt);

void                                       keyPressEvent(QKeyEvent *evt);

void                                       mouseDoubleClickEvent( QMouseEvent *evt );

};

把这个类放在EntityViewWidget类的上面，因为需要在这个类中调用一些EntityViewWidget的方法。

因为需求，所以重载了一些QTreeWidget的事件，这也是使用自定义TreeWidget的主要原因，它们用来处理按键、拖动、上下文菜单，另外还自定义了一个Slot，用来解决编辑后的反馈。

再来看EntityTreeWidget的实现，代码如下：

EntityTreeWidget::EntityTreeWidget(QWidget *parent) :

QTreeWidget(parent),m_pCurrentItem(0)

{

setColumnCount(1); //设置栏目数

setHeaderHidden(true); //隐藏栏目名

setSelectionMode(QAbstractItemView:: SingleSelection);//我们只允许选中单行

setSelectionBehavior(QAbstractItemView::SelectItems);//设定几种蓝框选中方式

setDragDropOverwriteMode(false);//关闭拖动放下覆盖指定项模式

setDragDropMode(QAbstractItemView::DragDrop);//设定拖放方式，我们这里支持拖和放

connect(itemDelegate(),SIGNAL(closeEditor(QWidget*, QAbstractItemDelegate::EndEditHint)), this, SLOT(SItemEditDone()));//在编辑完成时去触发指定槽

}

//-------------------------编辑完成时的槽---------------------------------------------------------------

//-------用来修改item的文字，以及更改属性栏值

void EntityTreeWidget::SItemEditDone()

{

if(m_pCurrentItem)

{

int index = indexOfTopLevelItem(m_pCurrentItem);//取得当前的ID

m_pCurrentItem->text(0).toStdString();//修改名字

m_pCurrentItem = 0;

}

}

//-------------------刚开始拖放---------------------------------------------------------------------

void EntityTreeWidget::dragEnterEvent(QDragEnterEvent *evt)

{

if(evt->source() == this )

{

evt->acceptProposedAction();//开启拖放行为，你如果不接受的话，

//dragMoveEvent和dropEvent就不起作用

}

}

//--------------拖动移动要告诉用户是否可以被放下--------------------

void EntityTreeWidget::dragMoveEvent(QDragMoveEvent *evt)

{

bool allow = false;

QTreeWidgetItem *item = itemAt(evt->pos());//取得当时所在的Item

if(item)              //如果这时鼠标位置有item

{

if(item->parent() == 0)     //判断目标位置是否为组，实体不允许放在实体下面

{

QList<QTreeWidgetItem*> list = selectedItems(); //取得当前选中列表

if (list.count() == 1)  //因为只支持单个选中

{

if(list[0]->parent() != 0)//组也不能放在组下面

{

allow = true;

}

}

allow = true;

}

}

if(allow)

evt->accept();           //接受放置

else

evt->ignore();            //不接受放置

}

//------------------------放下处理----------------------------------------------------------------

void EntityTreeWidget::dropEvent(QDropEvent *evt)

{

bool allow = false;

QTreeWidgetItem *item = itemAt(evt->pos());

if(!item || !(item->parent() == 0) || !(evt->source() == this))//如果为空，或者是实体，

//或者是从别的地方拖过来的，就忽略

{

evt->ignore();

return;

}

int index = indexOfTopLevelItem(item);

QList<QTreeWidgetItem*> list = selectedItems();

if (list.count() == 1)

{

if(list[0]->parent() != 0)

{

list[0]->parent() -> removeChild(list[0]); //从原组中移除

item->addChild(list[0]);                      //添加进新组

}

}

}

//-------------------------处理上下文菜单---------------------------------------------------------

void EntityTreeWidget::contextMenuEvent(QContextMenuEvent *evt)

{

QTreeWidgetItem *item = itemAt(evt->x(), evt->y());//取得item和，evt->pos()一样效果

if(item)

{

if (item->parent() == 0)

{

QMenu* contextMenu = new QMenu(this);            //创建上下文菜单

int index = indexOfTopLevelItem(item);

contextMenu->addAction(tr("Add Entity"), parent(), SLOT(SAddEntity()));

contextMenu->addSeparator();

contextMenu->addAction(tr("Remove Group"), parent(), SLOT(SRemoveGroup()));                       contextMenu->addSeparator();

contextMenu->addAction(tr("Clear Group"), parent(), SLOT(SClearGroup()));

contextMenu->addSeparator();

contextMenu->exec(QCursor::pos());     //执行上下文菜单

delete contextMenu;                          //一定要记得Delete，不然会内存泄漏

return;

}

else

{

QMenu* contextMenu = new QMenu(this);

int index = indexOfTopLevelItem(item);

contextMenu->addAction(tr("Remove"), parent(), SLOT(SRemoveEntity()));

contextMenu->addSeparator();

contextMenu->exec(QCursor::pos());

delete contextMenu;

return;

}

}

evt->accept();

}

//------------------------------------按键处理-----------------------------------------

void EntityTreeWidget::keyPressEvent(QKeyEvent *evt)

{

QTreeWidget::keyPressEvent(evt);

}

//-------------------鼠标按下处理，修改属性栏值（现在无）-----------------------

void EntityTreeWidget::mousePressEvent(QMouseEvent *evt)

{

QTreeWidget::mousePressEvent(evt);

}

//---------------------------------双击事件-------------------------------------------------------

void EntityTreeWidget::mouseDoubleClickEvent(QMouseEvent *evt)

{

m_pCurrentItem = 0;

QTreeWidgetItem *item = itemAt(evt->pos());

if(item && item->parent() == 0)

{

m_pCurrentItem = item;

editItem(item, 0);//打开编辑功能

return;

}

}