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属性表示拖动布局的分隔符时是否立即改变大小，下面两幅图分别是不立即改变大小的和立即改变大小的：

可以看到不立即改变大小的拖拽，会有一个半透明黑色阴影来表示当前拖动的位置，立即拖动就是立马改变了容器的大小。拖拽功能的实现代码主要在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);
			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中控制了阴影绘制范围不超过父容器。这只是实验，我没有用好看的素材去做，但是证明了可行性，替换素材后将会变得很好看：

使用这个方法，可以修改duilib原本的代码，为List控件和TreeView控件支持拖拽功能，也可以自定义某些特殊用途的控件。这里提供了绘制拖拽效果的思路，具体用法是多变的！

总结：

这是我之前为了完成某个功能而写的代码，希望可以帮到需要的朋友。如果代码中有bug，或者有更好的拖拽实现方法，请联系我或者留言！

Redrain  2014.11.15

QQ：491646717