6.4 하부아이템 편집을 위해 드롭다운 리스트 사용하기
때때로, 사용자가 마음대로 아이템을 편집하게하는것보다, 사용자에게 선택값들을주는것이
좋을수도 있습니다. 에디
트 컨트롤대신 드롭다운 리스트를 사용함으로써이것이 가능합니다. 구현하려면, 하부아이템편집과
같은 패턴을 따릅
니다.
<그림>
단계 1: CListCtrl 상속클래스
생성
CListCtrl
로 부터 새로운 클래스를 파생하거나 존재하는 서브클래스에 수정을 합니다. 만약
이미 6.3에서 설명한 하부아이템 편집이 가능한 클래스를 사용한다면그 클래스를
사용할수 있습니다.
단계 2: HitTestEx() 함수
정의
CMyListCtrl
클래스에 확장된 HitTest 함수를 정의합니다. 이 함수는 클릭한 점의 Row 인덱스와
컬럼을 결정할것입니다. HitTestEx() 함수는 이미 4.4 에서 살펴보았습니다. 클릭이나
더블클릭시 편집이 시작되도록 이 함수를 필요로 합니다.
단계 3: 드롭다운 리스트를 생성하는 함수를 작성합니다.
이
함수는 6.3에서 설명했던 EditSubLabel() 함수와 매우 비슷합니다. 차이점은 마지막에
CInPlaceList 클래스로부터 콤보박스를 만든다는것입니다. 이것은 인자로문자열들의
리스트를 필요로 한다는것을 주의하십시오. 이 리스트는 드롭다운리스트를 채우기
위해 필요합니다. 마지막인자는 기본적으로 선택될 아이템의 번호입니다.
// ShowInPlaceList -
리스트뷰의 아무셀에나 드롭다운리스트 생성
// Returns -
콤보박스에 대한 임시 포인터
// nItem -
편집할 아이템의 로우 인덱스
// nCol -
편집할 아이템의 컬럼 인덱스
// lstItems -
컨트롤을 채울 스트링의 리스트
// nSel -
기본적으로 선택될 아이템의 번호
CComboBox* CMyListCtrl::ShowInPlaceList( int nItem , int nCol , CStringList
&lstItems, int nSel )
{
// 리턴된 포인터는 저장되면
안됨(Save)
// 아이템이 보이는지 확인
if( !EnsureVisible( nItem, TRUE
) ) return NULL;
// nCol 이 유효한지 확인
CHeaderCtrl* pHeader = (CHeaderCtrl*)GetDlgItem(0);
int nColumnCount = pHeader->GetItemCount();
if( nCol >= nColumnCount
|| GetColumnWidth(nCol) < 10 ) return NULL;
// 컬럼 오프셋(Offset) 가져오기
int offset = 0;
for( int i = 0; i < nCol;
i++ ) offset += GetColumnWidth( i );
CRect rect;
GetItemRect( nItem, &rect,
LVIR_BOUNDS );
// 컬럼을 보이기 위해 필요하면
스크롤한다.
CRect rcClient;
GetClientRect( &rcClient
);
if( offset + rect.left <
0 || offset + rect.left > rcClient.right ) {
CSize
size;
size.cx
= offset + rect.left;
size.cy
= 0;
Scroll(
size );
rect.left
-= size.cx;
}
rect.left += offset+4;
rect.right = rect.left + GetColumnWidth(
nCol ) - 3;
int height = rect.bottom-rect.top;
rect.bottom += 5*height;
if( rect.right > rcClient.right)
rect.right = rcClient.right;
DWORD dwStyle = WS_BORDER|WS_CHILD|WS_VISIBLE|WS_VSCROLL|WS_HSCROLL
|CBS_DROPDOWNLIST|CBS_DISABLENOSCROLL;
CComboBox *pList = new CInPlaceList(nItem,
nCol, &lstItems, nSel);
pList->Create( dwStyle, rect,
this, IDC_IPEDIT );
pList->SetItemHeight( -1,
height);
pList->SetHorizontalExtent(
GetColumnWidth( nCol ));
return pList;
}
단계 4: 스크롤 메시지 처리하기
( Handle the scroll messages )
CInPlaceList클래스는
포커스를 잃었을때 드롭다운리스트 컨트롤을 파괴하고 객체를없애기위해 만들어 졌습니다.
리스트뷰의 스크롤바를 클릭하는것은 리스트 컨트롤에서 포커스를 뺐지 않습니다.
그러므로 우리는 리스트뷰 컨트롤에 포커스를 줌으로써 포커스를 리스트 컨트롤에서
빼았기는 것을 방지하는 스크롤바 메시지에 대한 핸들러를 작성해야 합니다.
void CMyListCtrl::OnHScroll(UINT nSBCode, UINT nPos, CScrollBar* pScrollBar)
{
if( GetFocus() != this ) SetFocus();
CListCtrl::OnHScroll(nSBCode,
nPos, pScrollBar);
}
void CMyListCtrl::OnVScroll(UINT nSBCode, UINT nPos, CScrollBar* pScrollBar)
{
if( GetFocus() != this ) SetFocus();
CListCtrl::OnVScroll(nSBCode,
nPos, pScrollBar);
}
단계 5: EndLabelEdit 처리
내장
에디트 컨트롤처럼, 우리의 드롭다운 리스트 컨트롤도 사용자가 아이템을 선택했을때
LVN_ENDLABELEDIT 통지를 보냅니다. 만약 이 통지 메시지가 이미 처리되지않았다면,
변경사항이 받아들여질 수 있도록 핸들러를 추가합니다.
void CMyListCtrl::OnEndLabelEdit(NMHDR* pNMHDR, LRESULT* pResult)
{
LV_DISPINFO *plvDispInfo
= (LV_DISPINFO *)pNMHDR;
LV_ITEM *plvItem
= &plvDispInfo->item;
if (plvItem->pszText != NULL) {
SetItemText(plvItem->iItem,
plvItem->iSubItem, plvItem->pszText);
}
*pResult = FALSE;
}
단계 6: 사용자가 편집을 시작할수
있도록 하는 방법을 추가합니다.
아래코드는
WM_LBUTTONDOWN 메시지에 대한 핸들러입니다. 포커스가 있는 아이템의 서브아이템이
클릭되었을 때 드롭다운 리스트 컨트롤을 생성합니다. 이 코드는 드롭다운 리스트
컨트롤을 만들기 전에 먼저 LVS_EDITLABELS 스타일을 체크합니다. 물론, 이것은 매우
간단한 구현이므로 필요에 따라 수정될 필요가 있습니다.
void CMyListCtrl::OnLButtonDown(UINT nFlags, CPoint point)
{
int index;
CListCtrl::OnLButtonDown(nFlags,
point);
int colnum;
if( ( index = HitTestEx( point,
&colnum )) != -1 ) {
UINT
flag = LVIS_FOCUSED;
if(
(GetItemState( index, flag ) & flag) == flag ) {
//
LVS_EDITLABELS 에 대한 체크
if(
GetWindowLong(m_hWnd, GWL_STYLE) & LVS_EDITLABELS ) {
CStringList
lstItems;
lstItems.AddTail(
"First Item");
lstItems.AddTail(
"Second Item");
lstItems.AddTail(
"Third Item");
lstItems.AddTail(
"Fourth Item");
lstItems.AddTail(
"Fifth Item");
lstItems.AddTail(
"Sixth Item");
ShowInPlaceList(
index, colnum, lstItems, 2 );
}
} else {
SetItemState(index,
LVIS_SELECTED | LVIS_FOCUSED , LVIS_SELECTED | LVIS_FOCUSED);
}
}
}
단계 7: CComboBox 클래스
서브클래싱
우리의
특별한 요구사항을 제공하기위해 CComboBox클래스를 서브클래싱해야 합니다.
이 클래스에 대한 주요 요구사항은 아래와 같습니다.
- 유저가 아이템 선택을 끝냈을시 LVN_ENDLABELEDIT 메시지를 보내야 한다.
- 편집이 끝났을때 자기자신을 파괴해야 한다.
- 사용자가 ESC 또는 엔터키를 누르거나 유저가 아이템을 선택했을때, 컨트롤이 입력
포커스를 잃을때 편집이 끝나야한다.
헤더파일은 구현화일(Implementation File)앞에 있습니다. CInPlaceList는 5개의Private 변수를 선언합니다. 이들은 드롭다운 리스트를 초기화할때와 LVN_ENDLABELEDIT 통지를 보낼때 사용됩니다.
// InPlaceList.h : header file
// CInPlaceList window
class CInPlaceList : public CComboBox {
public: // Construction
CInPlaceList(int iItem, int
iSubItem, CStringList *plstItems, int nSel);
public: // Attributes
public: // Operations
// Overrides
// ClassWizard generated virtual function overrides
//{{AFX_VIRTUAL(CInPlaceList)
public:
virtual BOOL PreTranslateMessage(MSG*
pMsg);
//}}AFX_VIRTUAL
// Implementation
public:
virtual
~CInPlaceList();
protected: //
Generated message map functions
//{{AFX_MSG(CInPlaceList)
afx_msg
int OnCreate(LPCREATESTRUCT lpCreateStruct);
afx_msg
void OnKillFocus(CWnd* pNewWnd);
afx_msg
void OnChar(UINT nChar, UINT nRepCnt, UINT nFlags);
afx_msg
void OnNcDestroy();
afx_msg
void OnCloseup();
//}}AFX_MSG
DECLARE_MESSAGE_MAP()
private:
int
m_iItem;
int
m_iSubItem;
CStringList
m_lstItems;
int m_nSel;
BOOL m_bESC; //
ESC 키가 눌렸는지 나타내기 위해
};
CInPlaceList 의 생성자는 인자로 넘어온 값들을 저장하고 m_bESC를 FALSE로 초기화합니다. OnCreate()함수는 드롭다운리스트 컨트롤을 생성하고 적당한 값으로 초기화합니다. PreTranslateMessage()함수는 에디트 컨트롤에 전달되는 ESC와 엔터키 확인을 위해 오버라이드됩니다. ESC 키와 엔터키는 보통 CDialog 나 CFormView 객체에 의해 Pre-Translate 됩니다. 그러므로 우리는 이것들에 대해 특별히 체크하여 드롭다운 리스트 컨트롤로 넘깁니다.
OnKillFocus()함수는 LVN_ENDLABELEDIT통지를 보내고 콤보박스컨트롤을 파괴합니다.
통지 메시지는 리스트뷰 컨트롤이 아닌 리스트뷰의 부모에게 보내집니다. 통지를
보낼때 m_bESC 멤버 변수를 가지
고 NULL 스트링을 보낼지를 결정합니다.
OnNcDestroy() 함수가 C++ 객체를 파괴하는데 적절한 장소입니다.
OnChar() 함수는 ESC 나 엔터가 눌렸을때 선택을 끝냅니다. 이 함수는 리스트뷰에포커스를
줌으로써 콤보박스 컨트롤의 OnKillFocus() 함수가 불려지도록 합니다.
OnChar() 함수는 다른 문자에 대해선 베이스 클래스 함수가 처리하도록 합니다.
OnCloseup()함수는 사용자가 드롭다운 리스트에서 선택했을때 호출됩니다. 이함수는부모에서
입력 포커스를 줌으로써 아이템 선택을 끝마치게 합니다.
// InPlaceList.cpp : implementation file
#include "stdafx.h"
#include "InPlaceList.h"
#ifdef _DEBUG
#define new DEBUG_NEW
#undef THIS_FILE
static char THIS_FILE[]
= __FILE__;
#endif
// CInPlaceList
CInPlaceList::~CInPlaceList() { }
CInPlaceList::CInPlaceList(int iItem, int iSubItem, CStringList *plstItems,
int nSel)
{
m_iItem =
iItem;
m_iSubItem =
iSubItem;
m_lstItems.AddTail( plstItems
);
m_nSel =
nSel;
m_bESC =
FALSE;
}
BEGIN_MESSAGE_MAP(CInPlaceList, CComboBox)
//{{AFX_MSG_MAP(CInPlaceList)
ON_WM_CREATE()
ON_WM_KILLFOCUS()
ON_WM_CHAR()
ON_WM_NCDESTROY()
ON_CONTROL_REFLECT(CBN_CLOSEUP,
OnCloseup)
//}}AFX_MSG_MAP
END_MESSAGE_MAP()
// CInPlaceList message handlers
int CInPlaceList::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
if (CComboBox::OnCreate(lpCreateStruct)
== -1) return -1;
// Set the proper font
CFont* font = GetParent()->GetFont();
SetFont(font);
for( POSITION pos = m_lstItems.GetHeadPosition();
pos != NULL; ) {
AddString(
(LPCTSTR) (m_lstItems.GetNext( pos )));
}
SetCurSel( m_nSel );
SetFocus();
return 0;
}
BOOL CInPlaceList::PreTranslateMessage(MSG* pMsg)
{
if( pMsg->message == WM_KEYDOWN
) {
if(pMsg->wParam == VK_RETURN
|| pMsg->wParam == VK_ESCAPE) {
::TranslateMessage(pMsg);
::DispatchMessage(pMsg);
return
TRUE; //
더이상 처리하지 않는다.
}
}
return CComboBox::PreTranslateMessage(pMsg);
}
void CInPlaceList::OnKillFocus(CWnd* pNewWnd)
{
CComboBox::OnKillFocus(pNewWnd);
CString str;
GetWindowText(str);
// 리스트뷰 컨트롤의 부모에게
통지 보내기
LV_DISPINFO dispinfo;
dispinfo.hdr.hwndFrom =
GetParent()->m_hWnd;
dispinfo.hdr.idFrom =
GetDlgCtrlID();
dispinfo.hdr.code =
LVN_ENDLABELEDIT;
dispinfo.item.mask =
LVIF_TEXT;
dispinfo.item.iItem =
m_iItem;
dispinfo.item.iSubItem =
m_iSubItem;
dispinfo.item.pszText =
m_bESC ? NULL : LPTSTR((LPCTSTR)str);
dispinfo.item.cchTextMax =
str.GetLength();
GetParent()->GetParent()->SendMessage(
WM_NOTIFY, GetParent()->GetDlgCtrlID(), (LPARAM)&dispinfo );
DestroyWindow();
}
void CInPlaceList::OnChar(UINT nChar, UINT nRepCnt, UINT nFlags)
{
if( nChar == VK_ESCAPE || nChar
== VK_RETURN) {
if(
nChar == VK_ESCAPE ) m_bESC =
TRUE;
GetParent()->SetFocus();
return;
}
CComboBox::OnChar(nChar, nRepCnt,
nFlags);
}
void CInPlaceList::OnNcDestroy()
{
CComboBox::OnNcDestroy();
delete this;
}
void CInPlaceList::OnCloseup()
{
GetParent()->SetFocus();
}