[置顶] duilib中控件拖拽功能的实现方法（附源码）
转载请说明原出处，谢谢~~：http://blog.csdn.net/zhuhongshu/article/details/41144283
duilib库中原本没有显示的对控件增加拖拽的功能，而实际使用过程中拖拽功能也是有用武之地的。看群里有人问题duilib怎么支持拖拽，我也就写这篇文章说明一下duilib实现控件拖拽的方法。
当我刚接触duilib不就的时候，考虑过duilib拖拽这个功能，当时的想法是，在xml布局中设置一个浮动的控件，正常状态下他是隐藏的，当出发了拖拽条件后将他显示并且跟随鼠标移动。这个方法显然并不优雅，编写代码后，由于还要借助其他的控件，所以耦合度太高，还要受到很多条件限制，并不容易把拖拽功能封装到一个单独控件里。
后来读完duilib的源码并且慢慢熟悉他后发现，实际上，duilib虽然没有显示的支持控件拖拽，但他自身已经必备了控件拖拽的条件和机制，并且在一些控件中已经运用！例如横纵向布局的sepwidth属性和sepimm属性来支持布局手动拖动边框改变大小，ListHeader支持拖动改变自身的宽度。
分析机制：
这里我先分析一下横向布局CHorizontalLayoutUI的拖拽机制，两个关键属性的介绍如下：
<Attribute name="sepwidth" default="0" type="INT" comment="分隔符宽,正负表示分隔符在左边还是右边,如(-4)"/> <Attribute name="sepimm" default="false" type="BOOL" comment="拖动分隔符是否立即改变大小,如(false)"/>
sepwidth属性很简单，我就不说了。sepimm属性表示拖动布局的分隔符时是否立即改变大小，下面两幅图分别是不立即改变大小的和立即改变大小的：
![[置顶] duilib中控件拖拽功能的实现方法（附源码）_第1张图片](http://img.e-com-net.com/image/info5/ff9d3b10cb9c40abac010c4d289229e9.jpg)
![[置顶] duilib中控件拖拽功能的实现方法（附源码）_第2张图片](http://img.e-com-net.com/image/info5/1f06dd653ffb4ef292aa400afdbc871e.jpg)
可以看到不立即改变大小的拖拽，会有一个半透明黑色阴影来表示当前拖动的位置，立即拖动就是立马改变了容器的大小。拖拽功能的实现代码主要在DoEvent函数和DoPostPaint函数中完成的，DoEvent函数代码如下：
void CHorizontalLayoutUI::DoEvent(TEventUI& event)
{
if( m_iSepWidth != 0 ) {
if( event.Type == UIEVENT_BUTTONDOWN && IsEnabled() )
{
RECT rcSeparator = GetThumbRect(false);
if( ::PtInRect(&rcSeparator, event.ptMouse) ) {
m_uButtonState |= UISTATE_CAPTURED;
ptLastMouse = event.ptMouse;
m_rcNewPos = m_rcItem;
if( !m_bImmMode && m_pManager ) m_pManager->AddPostPaint(this);
return;
}
}
if( event.Type == UIEVENT_BUTTONUP )
{
if( (m_uButtonState & UISTATE_CAPTURED) != 0 ) {
m_uButtonState &= ~UISTATE_CAPTURED;
m_rcItem = m_rcNewPos;
if( !m_bImmMode && m_pManager ) m_pManager->RemovePostPaint(this);
NeedParentUpdate();
return;
}
}
if( event.Type == UIEVENT_MOUSEMOVE )
{
if( (m_uButtonState & UISTATE_CAPTURED) != 0 ) {
LONG cx = event.ptMouse.x - ptLastMouse.x;
ptLastMouse = event.ptMouse;
RECT rc = m_rcNewPos;
if( m_iSepWidth >= 0 ) {
if( cx > 0 && event.ptMouse.x < m_rcNewPos.right - m_iSepWidth ) return;
if( cx < 0 && event.ptMouse.x > m_rcNewPos.right ) return;
rc.right += cx;
if( rc.right - rc.left <= GetMinWidth() ) {
if( m_rcNewPos.right - m_rcNewPos.left <= GetMinWidth() ) return;
rc.right = rc.left + GetMinWidth();
}
if( rc.right - rc.left >= GetMaxWidth() ) {
if( m_rcNewPos.right - m_rcNewPos.left >= GetMaxWidth() ) return;
rc.right = rc.left + GetMaxWidth();
}
}
else {
if( cx > 0 && event.ptMouse.x < m_rcNewPos.left ) return;
if( cx < 0 && event.ptMouse.x > m_rcNewPos.left - m_iSepWidth ) return;
rc.left += cx;
if( rc.right - rc.left <= GetMinWidth() ) {
if( m_rcNewPos.right - m_rcNewPos.left <= GetMinWidth() ) return;
rc.left = rc.right - GetMinWidth();
}
if( rc.right - rc.left >= GetMaxWidth() ) {
if( m_rcNewPos.right - m_rcNewPos.left >= GetMaxWidth() ) return;
rc.left = rc.right - GetMaxWidth();
}
}
CDuiRect rcInvalidate = GetThumbRect(true);
m_rcNewPos = rc;
m_cxyFixed.cx = m_rcNewPos.right - m_rcNewPos.left;
if( m_bImmMode ) {
m_rcItem = m_rcNewPos;
NeedParentUpdate();
}
else {
rcInvalidate.Join(GetThumbRect(true));
rcInvalidate.Join(GetThumbRect(false));
if( m_pManager ) m_pManager->Invalidate(rcInvalidate);
}
return;
}
}
if( event.Type == UIEVENT_SETCURSOR )
{
RECT rcSeparator = GetThumbRect(false);
if( IsEnabled() && ::PtInRect(&rcSeparator, event.ptMouse) ) {
::SetCursor(::LoadCursor(NULL, MAKEINTRESOURCE(IDC_SIZEWE)));
return;
}
}
}
CContainerUI::DoEvent(event);
}
在DoEvent函数里主要用UIEVENT_BUTTONDOWN、UIEVENT_BUTTONUP、UIEVENT_MOUSEMOVE三个事件完成了这个功能。
1、在UIEVENT_BUTTONDOWN事件里将m_uButtonState变量赋值为UISTATE_CAPTURED，这个标志用来表示这个容器当前是否处在拖拽状态下；ptLastMouse变量赋值为当前鼠标的坐标；m_rcNewPos赋值为当前容器所在的位置，从名字上可以看出来他表示控件的新的位置的区域。然后根据m_bImmMode变量的状态（表示是否立即改变大小）来决定是否调用AddPostPaint函数（这个函数很关键，后面讲）
2、在UIEVENT_MOUSEMOVE事件里，LONG cx = event.ptMouse.x - ptLastMouse.x;计算出鼠标移动过程的偏移量，用来计算出控件移动的新位置，在事件处理的尾部的代码
if( m_bImmMode ) {
m_rcItem = m_rcNewPos;
NeedParentUpdate();
}
else {
rcInvalidate.Join(GetThumbRect(true));
rcInvalidate.Join(GetThumbRect(false));
if( m_pManager ) m_pManager->Invalidate(rcInvalidate);
}
根据 m_bImmMode来选择两种绘图的方式。一个是直接指定容器为新的区域大小，另一个是指定了无效区域，然后由DoPostPaint函数来完成绘制工作。
3、在UIEVENT_BUTTONUP事件里，将m_uButtonState变量取消为UISTATE_CAPTURED状态，并且强制刷新了界面。
分析完毕：
在上面说到的内容里，立即改变容器大小很容易理解，我就不再说明了。我说一下非立即改变大小和位置，而是出现一个阴影效果的实现方式。这个效果更常用，比如我们在IM软件时，拖拽一个好友到另一个分组内，常常是有一个代表好友的阴影框跟着鼠标移动，可以通过这里的代码实现。
要实现非立即改变大小和位置，必须用到让自己的控件重写DoPostPaint函数，并且在适当的是否调用PaintManager的AddPostPaint函数来注册自己，例如上面的例子在UIEVENT_BUTTONDOWN事件里调用AddPostPaint，在UIEVENT_BUTTONUP里调用RemovePostPaint。
调用AddPostPaint后PaintManager就会在WM_PAINT消息里绘制完一次完整界面后，去调用我们的控件的DoPostPaint函数，让我们自己来完成绘制完之后的绘制！这时我们在DoPostPaint函数里完成阴影的绘制就可以了。如果不使用DuiLib的这个机制而直接在DoPaint函数里绘制阴影，就无法达到我们需要的效果，因为在DoPaint函数调用的时候软件的界面还可能没有完全绘制完，我们绘制的阴影可能会被其他控制的DoPaint函数覆盖！
需要说明的是，在DoPosiPaint函数中，绘制的范围不仅仅是本控件的范围，而是整个程序的客户区，所以这个拖拽的阴影可以画到窗体的任意位置，当然我们也可以通过代码判断来控制绘制的范围，这也就是我之前说的duilib本身已经有支持拖拽的机制和条件了。
看一下DoPostPaint的函数代码：
void CHorizontalLayoutUI::DoPostPaint(HDC hDC, const RECT& rcPaint)
{
if( (m_uButtonState & UISTATE_CAPTURED) != 0 && !m_bImmMode ) {
RECT rcSeparator = GetThumbRect(true);
CRenderEngine::DrawColor(hDC, rcSeparator, 0xAA000000);
}
}
函数里通过GetThumbRect函数获取了当前的分割条的位置，然后绘制了一个半透明的黑色阴影。讲到这里就已经完全说明了duilib中控件拖拽功能的实现方法了。
自己实现拖拽：
我们同样可以有两种拖拽方案：
一、立即拖拽模式：
继承需要的控件并重写DoEvent函数，在UIEVENT_BUTTONDOWN、UIEVENT_BUTTONUP、UIEVENT_MOUSEMOVE三个事件里直接根据鼠标的位置来改变控件的坐标和大小，显然这就要求我们设置float属性为真，这种方式实现起来也简单，我就不写代码了。
二、非立即拖拽模式：
1、 继承需要的控件并重写DoEvent函数，在UIEVENT_BUTTONDOWN、UIEVENT_BUTTONUP、UIEVENT_MOUSEMOVE三个事件，重写DoPostPaint函数完成阴影的绘制
2、在UIEVENT_BUTTONDOWN事件里调用AddPostPaint函数注册本控件
3、在UIEVENT_MOUSEMOVE事件里计算新的控件位置，并且将新旧位置组合起来调用Invalidate函数刷新位置（否则会有残影）
4、在UIEVENT_BUTTONUP事件里调用RemovePostPaint反注册自己，并且刷新控件。
我写了个简单的例子，并且实验成功了，这是实验代码：
void CModulePaneCellUI::DoEvent(TEventUI& event)
{
if( event.Type == UIEVENT_BUTTONDOWN && IsEnabled() )
{
if( ::PtInRect(&m_rcItem, event.ptMouse) )
{
m_uButtonState |= UISTATE_CAPTURED;
m_ptLastMouse = event.ptMouse;
m_rcNewPos = m_rcItem;
if( m_pManager )
m_pManager->AddPostPaint(this);
return;
}
}
if( event.Type == UIEVENT_BUTTONUP )
{
if( (m_uButtonState & UISTATE_CAPTURED) != 0 )
{
m_uButtonState &= ~UISTATE_CAPTURED;
CModulePaneConfigUI* pParent = static_cast<CModulePaneConfigUI*>(m_pParent);
pParent->NotifyDrag(this); // NotifyDrag函数是CModulePaneConfigUI容器的函数，和拖拽的效果本身没关系
if( m_pManager )
{
m_pManager->RemovePostPaint(this);
m_pManager->Invalidate(m_rcNewPos);
}
NeedParentUpdate();
return;
}
}
if( event.Type == UIEVENT_MOUSEMOVE )
{
if( (m_uButtonState & UISTATE_CAPTURED) != 0 )
{
LONG cx = event.ptMouse.x - m_ptLastMouse.x;
LONG cy = event.ptMouse.y - m_ptLastMouse.y;
m_ptLastMouse = event.ptMouse;
RECT rcCurPos = m_rcNewPos;
rcCurPos.left += cx;
rcCurPos.right += cx;
rcCurPos.top += cy;
rcCurPos.bottom += cy;
//将当前拖拽块的位置 和 当前拖拽块的前一时刻的位置，刷新
CDuiRect rcInvalidate = m_rcNewPos;
m_rcNewPos = rcCurPos;
rcInvalidate.Join(m_rcNewPos);
if( m_pManager ) m_pManager->Invalidate(rcInvalidate);
return;
}
}
if( event.Type == UIEVENT_SETCURSOR )
{
if( IsEnabled() )
{
::SetCursor(::LoadCursor(NULL, MAKEINTRESOURCE(IDC_HAND)));
return;
}
}
CLabelUI::DoEvent(event);
}
void CModulePaneCellUI::DoPostPaint(HDC hDC, const RECT& rcPaint)
{
if( (m_uButtonState & UISTATE_CAPTURED) != 0 ) {
CDuiRect rcParent = m_pParent->GetPos();
RECT rcUpdate ={0};
rcUpdate.left = m_rcNewPos.left < rcParent.left ? rcParent.left : m_rcNewPos.left;
rcUpdate.top = m_rcNewPos.top < rcParent.top ? rcParent.top : m_rcNewPos.top;
rcUpdate.right = m_rcNewPos.right > rcParent.right ? rcParent.right : m_rcNewPos.right;
rcUpdate.bottom = m_rcNewPos.bottom > rcParent.bottom ? rcParent.bottom : m_rcNewPos.bottom;
CRenderEngine::DrawColor(hDC, rcUpdate, 0xAA000000);
}
}
这是实验效果，蓝色部分是原本的按钮控件，黑色阴影是正在被拖拽的过程。我在DoPostPaint中控制了阴影绘制范围不超过父容器。这只是实验，我没有用好看的素材去做，但是证明了可行性，替换素材后将会变得很好看。CModulePaneConfigUI是红色的容器，实现了拖拽元素的类似磁块效果自动布局，这个和拖拽效果本身没关系。CModulePaneCellUI是拖拽元素控件，他可以是继承任何Duilib控件而来的。
![[置顶] duilib中控件拖拽功能的实现方法（附源码）_第3张图片](http://img.e-com-net.com/image/info5/578fd02866aa4cccbbe721b45211f3da.jpg)
使用这个方法，可以修改duilib原本的代码，为List控件和TreeView控件支持拖拽功能，也可以自定义某些特殊用途的控件。这里提供了绘制拖拽效果的思路，具体用法是多变的！
总结：
这是我之前为了完成某个功能而写的代码，希望可以帮到需要的朋友。如果代码中有bug，或者有更好的拖拽实现方法，请联系我或者留言！
Redrain 2014.11.15
QQ：491646717