MultiLineListBox

UserPreferences

1 개요

가끔씩 리스트 박스에 한 라인이 아니라, 여러 라인이 출력되었으면 하는 때가 있다. 리스트 뷰를 이용하기에는 컬럼이 별로 필요 없거나/너무 많거나, 게다가 귀찮을 때이다.

위의 그림 하단 부분에 보면 여러 라인이 출력되는 리스트 박스가 있는 걸 볼 수 있다. 위와 같은 로그 뷰어의 경우, 리스트 뷰를 이용하게 되면, 컬럼이 너무 많아져, 가로스크롤 때문에 아이템들을 주욱 살펴보는 일이 고통스러워진다. (전체창은 싫다, 전체창은...)

CppBuilder를 이용해 여러 행의 문자열이 들어가는 리스트 박스를 구현해 보자.

2 구현

우선 리스트 박스를 폼에다 추가하고, 속성을 다음과 같이 설정해 준다.


Style = lbOwnerDrawVariable 
IntegralHeight = false 

그 다음 이벤트 핸들러를 아래와 같이 구현해 준다.


// 라인 구분자로 사용할 문자
static const char LineSeperator = '\n';

// 아이템 그림자 박스 색깔
static const TColor ShadowColor = TColor(0x000A0A0A); 

// 아이템 박스 색깔 
static const TColor NormalColor = clWindow;

// 선택한 아이템 박스 색깔
static const TColor SelectedColor = clSkyBlue;

// 라인 간의 간격 (백분율)
static LineSpacer = 140;

// 모서리가 동그란 사각형을 그리는가?
static const bool bRountRect = false;

// 모서리가 동그란 사각형일 경우, 깍을 모서리의 양
static const int MLLB_XCURVE = 10;
static const int MLLB_YCURVE = 10;

void TListBox::MeasureItem(int Index, int &Height)
{
    Height = 0;

    // 폭을 계산할 아이템이 올바른 아이템이라면,
    // (Index가 -1일 경우, 현재 리스트 박스 안에 들어가는 아이템이 아니다.)
    if (Index != -1)
    {
        // 현재 리스트 박스 안의 텍스트를 읽어온다.
        string text = Items->Strings[Index].c_str();

        // 한 행의 기본 높이를 계산한다.
        TCanvas* pCanvas    = Canvas;
        int fontHeight = -(pCanvas->Font->Size);
        int pitch = (pCanvas->Font->PixelsPerInch);
        int cy = (int)((double)(abs(fontHeight * pitch / 72) * LineSpacer) / 100.0);

        // 텍스트를 검색하면서 개행 문자를 만나면,
        // 반환할 높이에다가 한 행의 높이를 더한다.
        unsigned int oldpos = 0;
        unsigned int pos    = 0;
        while (oldpos < text.size() && pos < text.size())
        {
            oldpos = pos;
            pos = text.find_first_of(LineSeperator, oldpos);

            if (pos == string::npos) pos = text.size();
            pos++;

            Height += cy; // 한 행의 높이를 더한다.
        }

        Height += cy; // 마지막으로 한번 더 더해준다.
    }
    else
    {
        Height = 80; // 제대로 된 아이템이 아니라면 그냥 80을...
    }
}

void TListBox::DrawItem(int Index, TRect &Rect, TOwnerDrawState State)
{
    // 리스트 안의 아이템이 아니라면 에러다.
    if (Index < 0) return;

    // 문자열을 읽어온다.
    string text = Items->Strings[Index].c_str();

    // 문자열의 길이가 0이라도 에러다.
    if (text.size() == 0) return;

    // 리스트 박스의 캔버스를 얻어온다.
    TCanvas* pCanvas = Canvas;

    /////////////////////////////////////////////////////////
    // +------------+
    // |            |-+ 대강 이런 모양으로 두 개의
    // +------------+ | 사각형을 그린다.
    //   +------------+
    /////////////////////////////////////////////////////////

    // 그림자를 그릴 사각형을 계산한다.
    TRect shadow;
    shadow.left   = Rect.left + 6;
    shadow.top    = Rect.top + 6;
    shadow.right  = Rect.right;
    shadow.bottom = Rect.bottom;

    // 밝은 상자를 그릴 사각형을 계산한다.
    TRect light;
    light.left   = Rect.left + 3;
    light.top    = Rect.top + 3;
    light.right  = Rect.right - 3;
    light.bottom = Rect.bottom - 3;

    // 먼저 현재 리스트 박스의 배경 색깔로 사각형을 그린다.
    // 그리지 않으면, 이전의 focus 사각형이 지워지지 않는다.
    pCanvas->Brush->Style = bsSolid;
    pCanvas->Brush->Color = Color;
    pCanvas->FillRect(Rect);

    // 그림자 사각형을 그린다.
    pCanvas->Brush->Style = bsSolid;
    pCanvas->Brush->Color = ShadowColor;

    if (bRountRect)
    {
        pCanvas->RoundRect(
            shadow.left, shadow.top, shadow.right, shadow.bottom,
            MLLB_XCURVE, MLLB_YCURVE);
    }
    else
    {
        pCanvas->FillRect(shadow);
    }

    // 밝은(?) 사각형을 그림자 사각형 위에다 그린다.
    pCanvas->Brush->Style = bsSolid;
    pCanvas->Brush->Color = TColor(::GetSysColor(COLOR_HIGHLIGHT));

    if (State.Contains(odSelected)) pCanvas->Brush->Color = SelectedColor;
    else pCanvas->Brush->Color = NormalColor;

    if (bRountRect)
    {
        pCanvas->RoundRect(
            light.left, light.top, light.right, light.bottom,
            MLLB_XCURVE, MLLB_YCURVE);
    }
    else
    {
        pCanvas->FillRect(light);
    }

    // 문자열을 하나씩 그린다.
    int fontHeight = -(pCanvas->Font->Size);
    int pitch = (pCanvas->Font->PixelsPerInch);
    int cy = (int)((double)(abs(fontHeight * pitch / 72) * LineSpacer) / 100.0);

    unsigned int oldpos = 0;
    unsigned int pos = 0;
    unsigned int count  = 0;

    while (oldpos < text.size() && pos < text.size())
    {
        oldpos = pos;
        pos = text.find_first_of(LineSeperator, oldpos);

        if (pos == string::npos) pos = text.size();
        pos++;

        string substring = text.substr(oldpos, (pos - 1) - oldpos);

        Set<TFontStyle, fsBold, fsStrikeOut> FONT_STYLE;

        pCanvas->Font->Color = clWindowText;
        pCanvas->Font->Style = FONT_STYLE;

        TRect textRect;
        textRect.left   = light.left + 10;
        textRect.top    = Rect.top + count * cy + 6;
        textRect.right  = light.right - 20;
        textRect.bottom = textRect.top + cy;

        DrawText(pCanvas->Handle, substring.c_str(), -1, &textRect,
            DT_LEFT | DT_NOPREFIX | DT_END_ELLIPSIS | DT_SINGLELINE | DT_VCENTER |
            DrawTextBiDiModeFlagsReadingOnly());

        count++;
    }
}

마지막으로 폼이 리사이즈되었을 때, 리스트 박스를 새로 그려줘야한다.


void __fastcall TForm::FormResize(TObject *Sender)
{
    ListBox->Invalidate();
}

3 설명

별 거 없다. MeasureItem 이벤트 핸들러는 실제로 아이템을 그리기 전에 아이템이 화면에서 차지할 높이를 알기 위해서 호출되는 함수다. DrawItem 이벤트 핸들러는 이름 그대로 실제로 아이템을 그려주는 함수다.

그러므로 MeasureItem 이벤트 핸들러가 호출되었을 때, 개행 문자의 갯수를 이용해, 라인의 높이를 정해준 다음, DrawItem 함수 안에서 개행 문자를 구분자로 문자열들을 한 라인씩 내려주면서 따로 그려주는 것이다. 그림자 사각형을 그려주는 것은 핵심 기능과는 아무 관련이 없고, 단지 연출(-_-)일 뿐이다.

옛날에 짰던 소스다 보니 허접하다. 함수로 빼야할 부분도 군데군데 보이고...

VisualCpp로 짰던 걸 다시 CppBuilder로 옮긴 것인데, 별로 고생한 기억이 없는 걸로 봐서는 다시 VisualCpp 버전으로 돌아가는 것도 별로 어렵지 않을 듯 하다.

4 링크

• Multi-Line ListBox
  

• see also CppBuilder
  

• CategoryTools