10. 드래그 와 드롭(Drag & Drop)
10.1 컬럼 순서를 바꾸기위해 컬럼 드래깅하기
종종 리스트뷰 컨트롤에 제공되는 화면공간은 컨트롤의 모든 컬럼들을 보여주기에는 부족할때가 많습니다. 또한 매우 자주 사용자는 자신이 원하는대로 컬럼들을 재정렬하고자 합니다. 이 일을 해결하는데 주로 사용되는 방법은 컬럼을 드래깅하는 것으로 사용자가 리스트를 재정렬(컬럼순서)하도록 하는것입니다.
현재는 컬럼을 드래깅하는것에 대한 지원은 없으며, 다음버젼의 공통 컨트롤에서는 소개될 것 같습니다. 아래는 이것을 지원하는 방법입니다.
단계 1:
커스텀 헤더 클래스를 만듭니다. CHeaderCtrl 로 부터 파생한 커스텀 헤더 클래스를 작성하여,컬럼드래깅을 처리하고 사용자에게 비주얼한 피드백을 제공하며 마지막으로 CListCtrl 의 멤버 함수를 호출하여 리스트를 재정렬하게 합니다.
먼저 헤더파일입니다.
#if !defined( AFX_MYHEADERCTRL_H__CC3DDBF3_EF5E_11D0_82AD_9A0A48000000__INCLUDED_
)
#define AFX_MYHEADERCTRL_H__CC3DDBF3_EF5E_11D0_82AD_9A0A48000000__INCLUDED_
#if _MSC_VER >= 1000
#pragma once
#endif // _MSC_VER >= 1000
// MyHeaderCtrl.h : header file
// CMyHeaderCtrl window
class CMyHeaderCtrl : public CHeaderCtrl
{
public: // Construction
CMyHeaderCtrl();
CMyHeaderCtrl(CWnd*
pWnd, void (CWnd::*fpDragCol)(int, int));
public: // Attributes
public: // Operations
// Overrides
// ClassWizard generated virtual
function overrides
//{{AFX_VIRTUAL(CMyHeaderCtrl)
//}}AFX_VIRTUAL
public: // Implementation
virtual ~CMyHeaderCtrl();
void SetCallback(CWnd* pWnd,
void (CWnd::*fpDragCol)(int, int));
protected:
BOOL m_bCheckForDrag;
BOOL m_bDragging;
int* m_pWidth;
int m_nDragCol;
int m_nDropPos;
CRect marker_rect;
CWnd* m_pOwnerWnd;
void (CWnd::*m_fpDragCol)(int, int);
protected: //
Generated message map functions
//{{AFX_MSG(CMyHeaderCtrl)
afx_msg
void OnMouseMove(UINT nFlags, CPoint point);
afx_msg
void OnLButtonUp(UINT nFlags, CPoint point);
afx_msg
void OnLButtonDown(UINT nFlags, CPoint point);
//}}AFX_MSG
DECLARE_MESSAGE_MAP()
};
//{{AFX_INSERT_LOCATION}}
#endif // !defined(AFX_MYHEADERCTRL_H__CC3DDBF3_EF5E_11D0_82AD_9A0A48000000__INCLUDED_)
CMyHeaderCtrl 은 CHeaderCtrl 로 부터 파생한 것입니다. 변경 기본 생성자가 다소생소할것입니다. 이것은 CListCtrl 이나 CListView 파생클래스에 대한 포인터와 사용자가 컬럼 드래깅을 끝마쳤을 시 호출할 멤버함수에 대한 포인터를 받습니다. SetCallback() 이란 멤버 함수도 정의됩니다. 이 함수는 CMyListCtrl 클래스의 기본(Default) 생성자를 사용하고 싶을때 사용합니다.
Protected 멤버 변수의 사용용도에 대한 간단한 설명입니다.
m_bCheckForDrag
는 사용자가 컬럼헤더에 왼쪽마우스를 클릭했을때 WM_LBUTTONDOWN 핸들러에 의해 TRUE 로 세트됩니다. 이것은 WM_MOUSEMOVE 핸들러에 의해 현재가컬럼 드래그 상태인지 체크하는데 사용됩니다. 사용자가 처음에 컬럼헤더에 마우스버튼을 눌렀을때만 컬럼을 드래깅한다는 것은 중요합니다.
m_bDragging
플래그는 컬럼드래그가 진행중이라는 것을 나타냅니다.
m_pWidth
변수는 컬럼넓이에 대한 배열을 가리키고 있습니다.이것은 드롭할 목적지컬럼을 결정하는데 사용합니다.
m_nDragCol
변수는 드래그될 컬럼의 컬럼인덱스를 가지고 있습니다.
m_nDragPos
는 새 위치의 컬럼인덱스를 가지고 있습니다.
marker_rect
는 사용자에게 화면상에서 보여줄 표식인 사각형을 가지고 있습니다. 화면에서 표식의 위치가 바뀌었을때 이전 표식을 지우는데도 사용됩니다.
m_fpDragCol
변수는 사용자가 드래그 작업을 끝냈을때 호출될 CListCtrl 이나 CListView 의 멤버함수에 대한 포인터를 저장합니다.
m_fOwnerWnd
변수는 m_fpDragCol 멤버함수가 호출될 객체에 대한 포인터를 가지게됩니다. 이것은 보통 부모 윈도우가 될것입니다.
아래는 구현파일입니다.
// MyHeaderCtrl.cpp : implementation file
#include "stdafx.h"
#include "MyHeaderCtrl.h"
#ifdef _DEBUG
#define new DEBUG_NEW
#undef THIS_FILE
static char THIS_FILE[]
= __FILE__;
#endif
// CMyHeaderCtrl
CMyHeaderCtrl::~CMyHeaderCtrl() {}
CMyHeaderCtrl::CMyHeaderCtrl() : marker_rect(0,0,0,0)
{
m_pWidth = NULL;
m_bDragging = FALSE;
m_bCheckForDrag = FALSE;
m_fpDragCol = NULL;
m_pOwnerWnd = NULL;
}
CMyHeaderCtrl::CMyHeaderCtrl(CWnd *pWnd, void (CWnd::*fpDragCol)(int, int))
: marker_rect(0,0,0,0)
{
m_pWidth = NULL;
m_bDragging = FALSE;
m_bCheckForDrag = FALSE;
m_fpDragCol = fpDragCol;
m_pOwnerWnd = pWnd;
}
BEGIN_MESSAGE_MAP(CMyHeaderCtrl, CHeaderCtrl)
//{{AFX_MSG_MAP(CMyHeaderCtrl)
ON_WM_MOUSEMOVE()
ON_WM_LBUTTONUP()
ON_WM_LBUTTONDOWN()
//}}AFX_MSG_MAP
END_MESSAGE_MAP()
// CMyHeaderCtrl message handlers
void CMyHeaderCtrl::OnMouseMove(UINT nFlags, CPoint point)
{
if( (MK_LBUTTON & nFlags)
== 0) { // 왼쪽버튼이 눌려지지
않았다. 플래그 리셋
m_bCheckForDrag
= FALSE;
m_bDragging
= FALSE;
} else
if( m_bDragging ) { //
마우스 아래의 컬럼넘버를 가져온다.
int
i=0, cx = 0;
if(
point.x > 0 )
for(
i = 0; i < GetItemCount(); i++ ) {
if(
point.x > cx && point.x < cx + m_pWidth[i] ) break;
cx
+= m_pWidth[i];
}
if(
i != m_nDropPos ) {
m_nDropPos
= i;
CRect
rect;
GetWindowRect(
&rect );
//
이전 표식에 의해 점유된 영역을 무효화(Invalidate) 한다.
InvalidateRect(
&marker_rect );
//
새로운 표식을 그린다.
CClientDC
dc(this);
POINT
pts[3];
pts[0].x
= cx;
pts[1].x
= cx -3;
pts[2].x
= cx +3;
pts[0].y
= rect.Height();
pts[1].y
= pts[2].y = rect.Height() -7;
dc.Polygon(
pts, 3);
//
새로운 표식의 정보를 저장한다.
marker_rect.left
= cx - 4;
marker_rect.top
= rect.Height() -8;
marker_rect.right
= cx + 4;
marker_rect.bottom
= rect.Height();
}
return;
} else
if( m_bCheckForDrag ) {
//
마우스 버튼이 컬럼헤더상에서 클릭되었고 마우스가 움직였으므로 드래깅을 시작한다.
m_bCheckForDrag
= FALSE;
m_bDragging
= TRUE;
SetCapture();
//
나중 사용을 위해 정보를 저장한다.
int
iCount = GetItemCount();
HD_ITEM
hd_item;
m_pWidth
= new int[iCount];
for(
int i = 0; i < iCount; i++ ) {
hd_item.mask
= HDI_WIDTH;
GetItem(
i, &hd_item );
m_pWidth[i]
= hd_item.cxy;
}
return;
}
CHeaderCtrl::OnMouseMove(nFlags,
point);
}
void CMyHeaderCtrl::OnLButtonUp(UINT nFlags, CPoint point)
{
ASSERT( m_pOwnerWnd != NULL
&& m_fpDragCol != NULL );
if( m_bDragging ) {
m_bDragging
= FALSE;
delete[]
m_pWidth;
ReleaseCapture();
Invalidate();
//
콜백함수를 가져온다.
if(
m_nDragCol != m_nDropPos && m_nDragCol != m_nDropPos -1 )
(m_pOwnerWnd->*m_fpDragCol)(
m_nDragCol, m_nDropPos );
}
CHeaderCtrl::OnLButtonUp(nFlags,
point);
}
void CMyHeaderCtrl::SetCallback( CWnd* pWnd,void (CWnd::*fpDragCol)(int,
int))
{
m_fpDragCol =
fpDragCol;
m_pOwnerWnd =
pWnd;
}
void CMyHeaderCtrl::OnLButtonDown(UINT nFlags, CPoint point)
{
// 마우스가 컬럼헤더상에서 눌렸는지
검사한다.
HD_HITTESTINFO hd_hittestinfo;
hd_hittestinfo.pt = point;
SendMessage(HDM_HITTEST, 0,
(LPARAM)(&hd_hittestinfo));
if( hd_hittestinfo.flags ==
HHT_ONHEADER ) {
m_nDragCol = hd_hittestinfo.iItem;
m_bCheckForDrag = TRUE;
}
CHeaderCtrl::OnLButtonDown(nFlags,
point);
}
CMyHeaderCtrl의 구현은 매우 간단합니다. 이것은 필수적으로 WM_MOUSEMOVE, WM_LBUTTONDOWN, WM_LBUTTONUP 에 대한 핸들러를 가지고 있습니다.
OnLButtonDown()은 m_nDragCol 에 값을 넣고 만약 사용자가 컬럼헤더상에서 마우스버튼을 눌렀다면 m_bCheckForDrag 를 세트한다.
OnMouseMove() 는 사용자에게 시각적인 효과를 주는곳이다. 이것은 먼저 왼쪽마우스버튼이 눌렸는지 체크하고 m_bCheckForDrag 와 m_bDragging 플래그를 리셋합니다. 만약 드래깅중이라면 m_nDropPos 값이 세트되고 헤더상에 표식이 그려집니다. 만약 처음 두개의 조건이 실패하면 드래그가 초기화되어야 하는지 체크합니다.
OnLButtonUp() 은 드래그 작업을 종료하고 , 드래그가 진행중이었다면 콜백함수를 드래그된 컬럼과 드롭 위치를 인자로 해서 호출합니다.
단계 2:
CListCtrl 파생클래스에 CMyHeaderCtrl 멤버변수를 추가합니다. 만약 CListView를사용중이라면 그 클래스에 멤버변수를 추가합니다.
CMyHeaderCtrl m_headerctrl;
단계 3:
CMyHeaderCtrl 객체를 초기화 합니다. CListCtrl 파생클래스의 생성자에 아래문장을 추가합니다.
m_headerctrl.SetCallback( this, (void (CWnd::*)(int, int))DragColumn );
DragColumn 은 다음단계에서 정의할 콜백함수입니다.
단계 4:
컬럼 재정렬을위해 콜백함수를 정의합니다.
CMyHeaderCtrl 객체는 사용자가 드래그 작업이 끝났을때 호출할 함수의 포인터를 필요로 합니다. 이함수는 콜백함수로 실제로 컬럼을 재정렬할 책임이 있습니다. 우리는 3에서 CMyHeaderCtrl객체를 초기화 할 때 DragColumn이란 것을 사용했습니다.
void CMyListCtrl::DragColumn(int source, int dest)
{
TCHAR sColText[160];
// 목적지에 컬럼을 삽입한다.
LV_COLUMN lv_col;
lv_col.mask = LVCF_FMT | LVCF_TEXT
| LVCF_WIDTH | LVCF_SUBITEM;
lv_col.pszText = sColText;
lv_col.cchTextMax = 159;
GetColumn( source, &lv_col
);
lv_col.iSubItem = dest;
InsertColumn( dest, &lv_col
);
// 새컬럼이 삽입되었기 때문에
변화된 원본 Col 번호를 조절한다.
// because a new column was
inserted
if( source > dest ) source++;
// 컬럼을 0 위치로 옮기는
것은 특별한 경우이다.
if( dest == 0 )
for(
int i = GetItemCount()-1; i > -1 ; i-- )
SetItemText(i,
1, GetItemText( i, 0) );
// 원본에서 목적지로 하부아이템을
복사한다.
for( int i = GetItemCount()-1;
i > -1 ; i-- )
SetItemText(i, dest, GetItemText(
i, source ) );
// 첫컬럼이 아닌경우 원본
컬럼을 지웁니다.
if( source != 0 ) DeleteColumn(
source );
else {
//
만약 원본 컬럼이 0이면 col#1 의 것을 col#0 으로 복사한다.
//
and then delete col# 1
GetColumn(
1, &lv_col );
lv_col.iSubItem
= 0;
SetColumn(
0, &lv_col );
for(
int i = GetItemCount()-1; i > -1 ; i-- )
SetItemText(i,
0, GetItemText( i, 1) );
DeleteColumn(
1 );
}
Invalidate();
}
이 함수에서 취한 일반적인 접근방법은 맞는 자리에 컬럼을 삽입하고, 원본의 모든컬럼을 모든 하부아이템으로 옮기는 겁니다. 리스트뷰 컨트롤은 첫번째 컬럼에 특별한 처리를 해주지 않습니다만, 우리는 해야만 합니다. 당신이 컬럼을 추가하거나삭제할때 알아야할 특별한 것은... 0번 위치에 컬럼을 추가하려고 할때 이미 하나이상의 컬럼이 있다면 새 컬럼은 실제로 두번째 컬럼에 추가됩니다. 만약 첫번재 컬럼을 지운다면 결과는 컬럼헤더들이 왼쪽으로 하나씩 시프트되고 마지막컬럼이 지워진다는 것입니다. DragColumn() 함수는 이 두가지상황을 처리합니다.
단계 5:
마지막으로 헤더컨트롤을 서브클래스 합니다. 좋은 곳은 리스트뷰 컨트롤 클래스의PreSubclassWindow() 입니다.
void CMyListCtrl::PreSubclassWindow()
{
CListCtrl::PreSubclassWindow();
// Add initialization code
m_headerctrl.SubclassWindow(
::GetDlgItem(m_hWnd,0) );
}
리스트뷰 컨트롤을 사용하실 일이 생기시면 아주 도움이 될거라 믿습니다.
- the end of this article -