MFC CTreeCtrl 완전 정복 – 계층 구조 UI를 구현하는 가장 쉬운 방법

🌲 CTreeCtrl이란?

CTreeCtrl은 Microsoft Foundation Class (MFC) 라이브러리에서 제공하는 클래스 중 하나로, 윈도우 애플리케이션에서 계층 구조의 데이터를 트리 형태로 표현할 수 있도록 도와주는 컨트롤입니다.
Windows의 Tree View 컨트롤을 감싸고 있는 MFC 래퍼 클래스라고 볼 수 있으며, 사용자가 폴더처럼 펼치고 접을 수 있는 UI를 쉽게 구현할 수 있도록 설계되어 있습니다.

• 🌳계층형 데이터 표시를 위한 트리 구조 제공
• 📌HTREEITEM 객체를 통해 노드 제어
• 📂노드의 추가, 삭제, 수정, 이동, 펼침/접기 지원
• 🖥️파일 탐색기처럼 시각적 탐색이 필요한 UI 구현에 최적

초보 개발자라면 처음엔 다소 생소할 수 있지만, 한 번 구조를 이해하고 나면 다양한 트리 기반 인터페이스를 구현할 수 있는 강력한 도구가 됩니다.
특히 노드 간 계층 구조를 시각적으로 표현할 때 다른 컨트롤보다 훨씬 직관적이고 효율적인 것이 장점입니다.

🔧 기본 구조와 주요 멤버 함수

CTreeCtrl을 제대로 활용하려면 이 클래스가 어떻게 구성되어 있는지를 먼저 이해해야 합니다.
이 컨트롤은 기본적으로 CWnd를 상속한 윈도우 컨트롤로, 트리 형태의 데이터를 노드 단위로 다루며 다양한 멤버 함수를 제공합니다.
여기서 핵심이 되는 개념은 HTREEITEM이라는 핸들을 통해 각 노드를 식별하고, 그 노드를 기반으로 작업을 수행한다는 점입니다.

또한 트리 컨트롤은 각 노드에 텍스트, 아이콘, 이미지 등을 지정할 수 있으며, 노드 간의 부모-자식 관계도 자유롭게 설정할 수 있습니다.
이를 통해 복잡한 계층 구조도 시각적으로 매우 명확하게 표현할 수 있죠.

• 📌InsertItem : 새 노드를 추가할 때 사용
• ❌DeleteItem : 특정 노드를 제거
• 📂Expand : 노드를 펼치거나 접는 데 사용
• 🔍GetChildItem, GetNextSiblingItem 등으로 노드 탐색

// 트리 컨트롤에서 아이템 추가 예시
HTREEITEM hRoot = m_TreeCtrl.InsertItem(_T("루트 노드"));
HTREEITEM hChild = m_TreeCtrl.InsertItem(_T("자식 노드"), hRoot);
m_TreeCtrl.Expand(hRoot, TVE_EXPAND);

위와 같은 함수들을 적절히 조합하면, 매우 직관적인 방식으로 트리 형태의 데이터를 제어할 수 있습니다.
트리 컨트롤을 잘만 다루면 사용자에게 깔끔하고 논리적인 UI 흐름을 제공할 수 있어, 특히 대규모 설정 화면이나 프로젝트 구조를 구성할 때 큰 장점을 가집니다.

➕ 노드 추가 및 삭제 방법

CTreeCtrl을 활용할 때 가장 기본적이면서도 자주 사용되는 기능이 바로 노드 추가와 삭제입니다.
사용자가 직접 트리 구조를 편집하거나 프로그램적으로 동적으로 구조를 구성할 수 있게 하기 위해서는, 이 기능에 대한 이해가 꼭 필요합니다.

노드를 추가할 때는 InsertItem 함수를 사용하며, 이 함수는 노드 텍스트, 부모 노드, 이미지 등 다양한 파라미터를 설정할 수 있습니다.
삭제는 DeleteItem 또는 전체 삭제를 위한 DeleteAllItems를 사용하게 됩니다.

• 🆕InsertItem으로 노드 생성 및 삽입
• 🗑️DeleteItem으로 특정 노드 삭제
• 🧹DeleteAllItems로 전체 초기화

// 노드 추가
HTREEITEM hRoot = m_TreeCtrl.InsertItem(_T("루트"));
HTREEITEM hChild = m_TreeCtrl.InsertItem(_T("하위 노드"), hRoot);

// 노드 삭제
m_TreeCtrl.DeleteItem(hChild);

// 전체 노드 삭제
m_TreeCtrl.DeleteAllItems();

이처럼 간단한 API 호출만으로도 트리 구조의 노드를 동적으로 생성하고 삭제할 수 있어, 사용자 맞춤형 인터페이스를 구성하는 데 매우 유용합니다.
또한 삭제할 때에는 부모-자식 관계를 잘 파악하여 필요 없는 노드만 선택적으로 제거하는 로직도 함께 고려해야 합니다.

📂 노드 펼치기/접기 제어

트리 컨트롤의 핵심 기능 중 하나는 사용자가 노드를 자유롭게 펼치고 접을 수 있다는 점입니다.
이러한 상호작용은 정보의 계층 구조를 명확히 보여주고, 필요할 때만 하위 항목을 볼 수 있도록 하여 UI의 가독성과 효율성을 높이는 데 큰 기여를 합니다.

MFC의 CTreeCtrl에서는 이 기능을 Expand() 함수를 통해 제어할 수 있으며, 원하는 노드를 명시적으로 확장하거나 접는 작업이 가능합니다.
예를 들어 설정 화면을 초기화할 때 루트 노드만 열어두고 나머지는 닫아둘 수 있고, 특정 상황에서 자동으로 펼쳐지도록 설정할 수도 있습니다.

• 🔼TVE_EXPAND : 노드를 펼치는 상수
• 🔽TVE_COLLAPSE : 노드를 접는 상수
• 🔁TVE_TOGGLE : 펼침/접기 전환

// 특정 노드 펼치기
m_TreeCtrl.Expand(hRoot, TVE_EXPAND);

// 특정 노드 접기
m_TreeCtrl.Expand(hRoot, TVE_COLLAPSE);

// 현재 상태에 따라 자동 전환
m_TreeCtrl.Expand(hRoot, TVE_TOGGLE);

이러한 제어는 사용자 경험을 유연하게 만들 뿐만 아니라, UI 초기화 및 상태 복원에도 자주 사용됩니다.
예를 들어 사용자가 마지막에 열어둔 노드를 저장해두고, 다시 프로그램을 실행했을 때 해당 노드를 자동으로 펼쳐주는 것도 가능합니다.

💡 실전 예제 코드로 이해하기

지금까지 CTreeCtrl의 구조와 주요 기능에 대해 알아봤다면, 이제는 실제 예제 코드를 통해 개념을 더욱 확실히 이해해보는 것이 좋습니다.
이 섹션에서는 노드 추가부터 펼치기, 삭제까지 전체 흐름을 코드로 구현한 예제를 소개합니다.
이 예제는 MFC 애플리케이션의 OnInitDialog 함수나 OnCreate 함수 등에서 사용할 수 있으며, 트리 컨트롤 초기화의 기초 틀로 매우 유용하게 활용됩니다.

void CMyDialog::InitTreeControl()
{
    // 트리 컨트롤 초기화
    m_TreeCtrl.DeleteAllItems();

    // 루트 노드 추가
    HTREEITEM hRoot = m_TreeCtrl.InsertItem(_T("회사"));

    // 자식 노드 추가
    HTREEITEM hDept1 = m_TreeCtrl.InsertItem(_T("개발부서"), hRoot);
    HTREEITEM hDept2 = m_TreeCtrl.InsertItem(_T("디자인부서"), hRoot);

    // 하위 자식 노드 추가
    m_TreeCtrl.InsertItem(_T("프론트엔드 팀"), hDept1);
    m_TreeCtrl.InsertItem(_T("백엔드 팀"), hDept1);

    // 노드 펼치기
    m_TreeCtrl.Expand(hRoot, TVE_EXPAND);
    m_TreeCtrl.Expand(hDept1, TVE_EXPAND);
}

위 코드처럼 트리 구조를 구성하면, 사용자는 회사 → 부서 → 팀 순으로 명확한 계층 구조를 탐색할 수 있게 됩니다.
이 구조는 직관적인 UI 제공은 물론, 코드 구조 자체도 명확하게 설계할 수 있어 유지 보수에 있어서도 매우 유리합니다.

이제 여러분도 트리 컨트롤을 활용해 원하는 구조의 UI를 설계할 수 있을 것입니다.
이제 다음 단계로는 이벤트 처리, 커스텀 이미지 삽입, 노드 선택 제어 등 더 고급 기능도 도전해볼 수 있습니다.

❓ 자주 묻는 질문 (FAQ)