MFC CListCtrl 뷰 모드 완벽 이해하기, 리스트뷰 스타일로 고급 UI 구성하는 법

🔗 CListCtrl이란 무엇인가?

MFC에서 CListCtrl은 리스트 형태의 데이터를 보여주기 위한 고급 컨트롤로, Windows 공용 컨트롤인 SysListView32를 기반으로 만들어졌습니다.
다양한 스타일 설정을 통해 아이콘, 타일, 리스트, 디테일 등의 뷰 모드를 지원하며, 각 항목을 열(Column)과 행(Row)으로 구성할 수 있습니다.
주로 폴더 탐색기, 설정 창, 데이터 목록 등 사용자 인터페이스에 필요한 리스트 구성에 폭넓게 활용됩니다.

기본적으로 CListCtrl은 리스트 항목을 추가하는 InsertItem() 함수와 열을 정의하는 InsertColumn() 함수를 통해 구성됩니다.
뿐만 아니라 항목에 이미지를 삽입하거나, 사용자 정의 데이터를 바인딩하는 등 확장성도 높습니다.

• 📌아이콘, 리스트, 디테일 뷰 등 다양한 모드를 지원
• 🧩InsertItem, InsertColumn 등으로 항목/열 구성
• 🎨이미지 리스트(ImageList)를 통해 아이콘 표시 가능
• ⚙️뷰 스타일을 코드 또는 리소스에서 설정 가능

🛠️ 뷰 모드(View Mode)의 종류와 특징

CListCtrl의 가장 큰 장점 중 하나는 다양한 뷰 모드를 지원한다는 점입니다.
뷰 모드는 컨트롤이 화면에 항목을 어떻게 표시할지를 결정하는 스타일로, 주로 LVS_ICON, LVS_SMALLICON, LVS_LIST, LVS_REPORT 네 가지로 나뉩니다.

각 뷰 모드는 사용 목적과 UI 형태에 따라 선택할 수 있으며, 리소스 뷰나 코드 상에서 스타일 플래그를 설정하는 방식으로 지정합니다.
특히 LVS_REPORT는 다중 열을 구성할 수 있어, 가장 자주 활용되는 뷰 타입입니다.

📁 대표적인 4가지 뷰 모드

• 🖼️LVS_ICON: 큰 아이콘 중심의 아이템 나열 (기본 아이콘 보기)
• 🧷LVS_SMALLICON: 작은 아이콘 기반의 뷰 (컴팩트 UI에 적합)
• 📋LVS_LIST: 아이템이 수평으로 나열되는 리스트 형식
• 📑LVS_REPORT: 열(Column) 기반 디테일 뷰 제공, 가장 자주 쓰임

⚙️ InsertColumn과 InsertItem 활용법

CListCtrl을 제대로 활용하려면 InsertColumn()과 InsertItem() 함수에 대한 이해가 필수입니다.
InsertColumn은 열(Column)을 추가할 때 사용되며, InsertItem은 각 행(Row)의 데이터를 삽입하는 역할을 합니다.
이 두 함수의 조합으로 리스트뷰의 기본 틀이 완성되며, 각 셀에 표시할 텍스트는 SetItemText()를 통해 설정할 수 있습니다.

🧩 기본 사용 구조

// 컬럼 추가
m_listCtrl.InsertColumn(0, _T("이름"), LVCFMT_LEFT, 100);
m_listCtrl.InsertColumn(1, _T("직업"), LVCFMT_LEFT, 120);

// 항목 추가
int index = m_listCtrl.InsertItem(0, _T("홍길동"));
m_listCtrl.SetItemText(index, 1, _T("개발자"));

InsertColumn의 세 번째 인자는 열 너비, 네 번째 인자는 정렬 방식입니다.
InsertItem으로는 행이 추가되며, 첫 번째 열만 직접 입력하고 나머지 셀은 SetItemText()로 개별 설정합니다.

• 📌열 추가는 InsertColumn()으로 구성
• ➕행 추가는 InsertItem()으로 첫 번째 셀 지정
• ✏️다른 열의 셀은 SetItemText()로 설정
• 📐열 정렬 방식은 LVCFMT_LEFT, CENTER, RIGHT 지원

🔌 LVS 스타일 및 확장 기능 설정

CListCtrl은 다양한 스타일 플래그를 통해 뷰 모드뿐 아니라, 선택 방식, 헤더, 그리드 등 다양한 UI 동작을 설정할 수 있습니다.
이러한 플래그는 컨트롤 생성 시 리소스 설정에서 지정하거나, ModifyStyle() 함수를 통해 동적으로 변경할 수도 있습니다.

스타일 플래그는 LVS_ 계열 외에도 LVS_EX_ 확장 스타일로 구성되며, 특히 디테일 뷰에서 자주 사용되는 기능이 많습니다.
예를 들어 행 간 그리드 표시나 전체 행 선택, 더블 버퍼링 효과 등은 SetExtendedStyle()을 통해 설정합니다.

🔧 확장 스타일 설정 예시

// 확장 스타일 설정
m_listCtrl.SetExtendedStyle(LVS_EX_FULLROWSELECT | LVS_EX_GRIDLINES | LVS_EX_DOUBLEBUFFER);

• 📏LVS_EX_FULLROWSELECT: 항목 클릭 시 전체 행 강조
• 🧮LVS_EX_GRIDLINES: 행/열 구분선 표시
• 🚀LVS_EX_DOUBLEBUFFER: 깜빡임 방지를 위한 더블 버퍼링
• 🔒LVS_SINGLESEL: 단일 항목만 선택 가능 (멀티 선택 방지)

💡 실전 예제: 디테일 뷰 리스트 구현

디테일 뷰(Details View)는 CListCtrl에서 가장 많이 활용되는 뷰 모드입니다.
각 항목을 열(Column) 단위로 세분화하여, 구조화된 정보를 사용자에게 효과적으로 전달할 수 있기 때문이죠.
이번 섹션에서는 LVS_REPORT 스타일을 활용하여 이름, 나이, 직업 정보를 표시하는 리스트를 구성하는 실전 코드를 소개합니다.

🧪 디테일 뷰 리스트 구성 예시

// 스타일 설정
m_listCtrl.ModifyStyle(0, LVS_REPORT);
m_listCtrl.SetExtendedStyle(LVS_EX_FULLROWSELECT | LVS_EX_GRIDLINES);

// 컬럼 설정
m_listCtrl.InsertColumn(0, _T("이름"), LVCFMT_LEFT, 100);
m_listCtrl.InsertColumn(1, _T("나이"), LVCFMT_CENTER, 50);
m_listCtrl.InsertColumn(2, _T("직업"), LVCFMT_LEFT, 120);

// 데이터 삽입
int index = m_listCtrl.InsertItem(0, _T("홍길동"));
m_listCtrl.SetItemText(index, 1, _T("35"));
m_listCtrl.SetItemText(index, 2, _T("개발자"));

index = m_listCtrl.InsertItem(1, _T("김영희"));
m_listCtrl.SetItemText(index, 1, _T("29"));
m_listCtrl.SetItemText(index, 2, _T("디자이너"));

디테일 뷰는 리스트 컨트롤의 강력한 확장성을 보여주는 예시입니다.
열의 너비와 정렬 방식, 데이터 포맷 등을 자유롭게 설정할 수 있으며, 이후에는 헤더 클릭 정렬, 서브 아이템 강조 등도 추가 구현할 수 있습니다.

• 📑LVS_REPORT 스타일로 디테일 뷰 설정
• 📌InsertColumn으로 열 제목과 너비 지정
• 📝InsertItem → SetItemText 순으로 행/열 값 입력
• 💬SetExtendedStyle로 그리드와 전체 행 선택 적용

❓ 자주 묻는 질문 (FAQ)