MFC CComboBox 완벽 가이드 드롭다운 항목 관리 쉽게 배우기

🔗 CComboBox란 무엇인가요?

CComboBox는 MFC(Microsoft Foundation Classes)에서 제공하는 컨트롤 중 하나로,
드롭다운 형태의 선택 목록을 사용자에게 제공하는 UI 요소입니다.
사용자는 여러 항목 중 하나를 선택할 수 있으며, 기본적으로 선택된 항목만 보여주기 때문에 공간 활용에 매우 효율적입니다.

CComboBox는 내부적으로 리스트 박스와 에디트 박스를 조합한 형태이며,
선택 전용(drop-down list)과 편집 가능한(drop-down edit) 모드를 모두 지원합니다.
이를 통해 사용자는 미리 정의된 항목 중 하나를 고르거나 직접 텍스트를 입력할 수도 있습니다.

• 📌CBS_DROPDOWN – 드롭다운 목록 + 사용자 입력 가능
• 📌CBS_DROPDOWNLIST – 드롭다운 목록만 제공 (편집 불가)
• 📌CBS_SIMPLE – 항상 펼쳐진 리스트 형태

CComboBox는 AddString, DeleteString, GetCurSel, GetLBText, ResetContent 등의 멤버 함수를 통해
항목을 동적으로 제어할 수 있습니다.
또한 사용자의 선택을 기반으로 후속 동작을 처리할 수 있어 다양한 실무 상황에서 자주 사용됩니다.

🛠️ 항목 추가 및 삭제 함수 정리

CComboBox에서 항목을 동적으로 추가하거나 삭제하는 기능은 UI를 구성할 때 매우 중요합니다.
MFC에서는 AddString과 DeleteString 함수를 통해 쉽게 처리할 수 있습니다.
리스트 구성의 기본이 되는 만큼, 정확한 사용 방법을 익혀두면 유용하게 활용할 수 있어요.

➕ AddString으로 항목 추가하기

AddString 함수는 콤보박스에 새로운 문자열 항목을 추가할 때 사용됩니다.
기본적으로 항목은 맨 아래에 추가되며, 인자로 문자열(CString 또는 LPCTSTR)을 전달합니다.

m_comboBox.AddString(_T("항목 1"));
m_comboBox.AddString(_T("항목 2"));

이와 같이 사용하면 콤보박스에 “항목 1”, “항목 2″가 순서대로 추가됩니다.
반환값은 해당 항목의 인덱스이며, 실패 시 CB_ERR가 반환됩니다.

🗑️ DeleteString으로 항목 삭제하기

DeleteString 함수는 인덱스를 지정하여 해당 항목을 삭제합니다.
삭제 후 인덱스는 자동으로 재정렬되며, 삭제에 성공하면 남은 항목 수를 반환합니다.

m_comboBox.DeleteString(0); // 첫 번째 항목 삭제

이 함수 역시 인덱스 범위를 벗어나면 CB_ERR를 반환하므로, 사전에 GetCount로 항목 수를 확인하는 것이 안전합니다.

⚙️ 선택 항목 확인 및 값 가져오기

CComboBox에서 사용자가 선택한 항목을 확인하려면 GetCurSel과 GetLBText 함수를 활용하면 됩니다.
이 두 함수는 각각 선택된 인덱스를 얻고, 해당 인덱스의 문자열을 가져오는 역할을 합니다.
드롭다운에서 선택한 항목을 기반으로 로직을 처리할 때 반드시 알아두어야 할 기본기죠.

🔎 GetCurSel: 현재 선택된 인덱스 확인

GetCurSel 함수는 콤보박스에서 현재 선택된 항목의 인덱스를 반환합니다.
만약 아무것도 선택되지 않은 경우에는 CB_ERR를 반환하므로 반드시 예외 처리를 함께 해주는 것이 좋습니다.

int nIndex = m_comboBox.GetCurSel();
if (nIndex != CB_ERR) {
    // 유효한 선택
}

이렇게 선택 인덱스를 먼저 확인한 다음, 해당 인덱스를 활용해 텍스트를 얻는 것이 일반적인 처리 방식입니다.

💬 GetLBText: 선택 항목의 문자열 가져오기

GetLBText 함수는 주어진 인덱스의 항목 문자열을 CString 형태로 가져옵니다.
보통 GetCurSel과 함께 사용되며, 사용자가 선택한 항목을 문자열로 얻고자 할 때 활용됩니다.

int nIndex = m_comboBox.GetCurSel();
if (nIndex != CB_ERR) {
    CString strText;
    m_comboBox.GetLBText(nIndex, strText);
    AfxMessageBox(strText);
}

위 예제처럼 사용하면 사용자가 선택한 항목의 텍스트를 간단히 출력하거나 다른 로직으로 넘길 수 있습니다.
이는 사용자 인터페이스와 내부 처리 로직을 연결하는 기본 패턴 중 하나입니다.

🔌 전체 항목 관리와 초기화

CComboBox는 항목을 하나씩 추가하고 삭제하는 것뿐만 아니라, 전체 항목을 초기화하거나 전체 개수를 확인하는 기능도 제공합니다.
이런 작업은 리스트를 재구성하거나 특정 조건에 따라 전체 항목을 갱신할 때 유용하게 활용됩니다.

♻️ ResetContent: 모든 항목 초기화

ResetContent 함수는 콤보박스에 있는 모든 항목을 한 번에 삭제합니다.
초기화 이후에는 항목이 완전히 비워진 상태가 되며, UI에도 빈 드롭다운으로 표시됩니다.

m_comboBox.ResetContent();

리스트를 완전히 새로 구성하고자 할 때, 이 함수로 초기화한 뒤 새로운 항목을 AddString으로 추가하면 됩니다.

📊 GetCount: 전체 항목 개수 확인

GetCount 함수는 현재 콤보박스에 등록된 항목의 수를 반환합니다.
특정 인덱스를 넘지 않도록 반복문을 구성할 때 반드시 필요하며, 동적으로 UI를 제어하는 로직에 자주 사용됩니다.

int nCount = m_comboBox.GetCount();
CString msg;
msg.Format(_T("총 항목 수: %d개"), nCount);
AfxMessageBox(msg);

이처럼 GetCount를 활용하면 콤보박스 상태를 쉽게 점검할 수 있고, 조건에 따라 반복 작업을 수행하기에도 좋습니다.

💡 실전 예제로 익히는 CComboBox

지금까지 배운 CComboBox의 기본 기능들을 실제 코드에 어떻게 적용할 수 있을까요?
실무에서는 사용자의 입력을 기반으로 리스트를 구성하고, 특정 조건에 따라 항목을 추가하거나 삭제하는 흐름이 자주 등장합니다.
이제는 그 흐름을 직접 구현해보는 예제를 통해 이해도를 높여볼 시간입니다.

✅ 입력값 중복 검사 후 추가

사용자가 입력한 값을 중복 없이 리스트에 추가하려면 아래와 같이 중복 여부를 먼저 확인해야 합니다.

CString input = _T("사용자 입력");
bool exists = false;
int count = m_comboBox.GetCount();

for (int i = 0; i < count; i++) {
    CString item;
    m_comboBox.GetLBText(i, item);
    if (item.CompareNoCase(input) == 0) {
        exists = true;
        break;
    }
}

if (!exists) {
    m_comboBox.AddString(input);
}

이 코드를 활용하면 동일한 문자열이 콤보박스에 중복으로 등록되지 않도록 방지할 수 있습니다.
단순한 유효성 검증이지만, 실무에서는 매우 자주 사용되는 패턴이에요.

🗑️ 선택 항목 자동 삭제

사용자가 선택한 항목을 버튼 클릭으로 삭제하는 경우도 흔한 시나리오입니다.
이럴 땐 GetCurSel과 DeleteString을 함께 활용하면 됩니다.

int sel = m_comboBox.GetCurSel();
if (sel != CB_ERR) {
    m_comboBox.DeleteString(sel);
}

위처럼 간단한 로직이지만 UI와 연결하면 매우 직관적인 기능이 됩니다.
‘삭제’ 버튼을 누르면 선택된 항목이 바로 사라지는 구조로 연결해보세요.

❓ 자주 묻는 질문 (FAQ)