22-4.목록의 선택

22-4-1.리스트 박스

리스트 박스와 콤보 박스는 선택 가능한 목록 중 하나를 선택하는 컨트롤이다. 다수의 목록을 표시할 때 리스트 박스가 일반적으로 사용된다.

ListControl 클래스는 리스트 박스와 콤보 박스의 공통적인 기능을 제공하는 추상 클래스인데 주로 데이터 바인딩에 관련된 기능을 제공한다. ListBox의 주요 프로퍼티는 다음과 같다.

프로퍼티	타입	설명
Items	ObjectCollection ⓡ	리스트 박스의 항목 목록이며 이 프로퍼티를 통해 항목의 집합을 관리한다. 항목을 추가, 삭제하고 개수를 구한다.
MultiColumn	bool	항목을 여러 열로 표시할 것인가를 지정한다. 디폴트는 false다.
ColumnWidth	int	여러 열로 표시할 때 열의 너비를 지정한다.
Sorted	bool	항목을 정렬하여 표시할 것인지 지정한다. 디폴트는 false이다. 이 프로퍼티가 true이면 추가된 항목이 사전순으로 정렬되어 표시된다.
TopIndex	int	제일 위쪽에 표시된 항목의 인덱스를 조사하거나 설정한다. 보통 0번째 항목이 목록의 제일 위에 있지만 스크롤되면 그렇지 않을 수도 있다.
UseTabStops	bool	항목 내의 탭 문자를 인식할 것인가를 지정한다.
DrawMode	DrawMode ⓥ	항목 그리기 모드를 지정한다. 디폴트는 Normal이지만 OwnerDrawFixed, OwnerDrawVariable을 선택하면 항목을 직접 그릴 수 있다.
IntegralHeight	bool	항목의 일부분만 보이는 것을 허락할 것인가를 지정한다. 디폴트는 false이며 리스트 박스의 높이를 항목의 배수로 맞춤으로서 일부만 보이지 않도록 한다. 정확한 높이를 유지하려면 이 프로퍼티를 false로 변경한다.
ItemHeight	int ⓥ	항목의 높이를 표현한다. 가변 높이의 오너 드로우인 경우 첫 번째 항목의 높이만 조사한다.
HorizontalScrollbar	bool	가로 스크롤 막대의 표시 여부를 지정한다.
ScrollAlwaysVisible	bool	세로 스크롤 막대를 항상 표시할 것인가를 지정한다. 디폴트는 false이며 항목이 리스트 박스의 높이보다 많을 때만 세로 스크롤 바가 나타난다.
SelectedIndex	int	선택된 항목의 인덱스이다.
SelectedIndices	SelectedIndexCollection ⓡ	선택된 항목의 인덱스 배열이다. 다중 선택이 가능할 때 이 프로퍼티로 항목의 배열을 조사한다.
SelectedItem	Object	선택된 항목이다.
SelectedItems	SelectedObjectCollection ⓡ	선택된 항목의 배열이다.
SelectionMode	SelectionMode	항목을 선택하는 방법을 지정한다. 디폴트는 One이며 하나만 선택할 수 있으나 MultiSimple, MultiExtended로 변경하여 복수 개를 선택할 수 있으며 None으로 변경하면 선택을 금지한다.
Text	string	현재 선택된 항목의 텍스트이다.
CustomTabOffsets	IntegerCollection ⓡ	사용자 정의 탭 컬렉션이다.
UseCustomTabOffsets	bool	사용자 정의 탭 지정을 사용할 것인가를 지정한다.

항목의 선택이 변경될 때 SelectedIndexChanged 이벤트가 발생하며 이 이벤트에서 항목이 바뀔 때마다 할 작업을 처리한다. 새 프로젝트를 만들고 빈 폼에 리스트 박스를 하나 배치한다. 속성창에서 Items 프로퍼티의 ... 버튼을 누르면 항목을 추가하는 대화상자가 나타난다. 아니면 컨트롤 위쪽에 있는 조그만 삼각형 모양의 스마트 태그 버튼을 눌러 항목 편집을 선택한다.

스마트 태그는 컨트롤에 대한 주요 작업 목록을 표시한다. 간단한 컨트롤에는 별 기능이 없지만 메뉴나 리스트 박스같은 복잡한 컨트롤에는 자주 수행하는 작업 목록이 정리되어 있다. 항목 편집을 선택하면 컬렉션 편집기 대화상자가 나타나는데 여기에 항목을 입력한다.

문자열로 된 항목을 디자인 타임에 미리 입력해 놓을 수 있다. 항목을 입력한 후 실행하면 리스트 박스에 항목이 나타난다. 다음은 리스트 박스의 SelectedItemChanged 이벤트 핸들러를 작성하여 항목이 바뀔 때마다 선택된 항목 문자열을 읽어 폼의 타이틀 바에 출력해 보자.

ListBoxTest

using System; ~ using System.Windows.Forms;

namespace ListBoxTest {

public partial class Form1 : Form {

public Form1() {

InitializeComponent();

}

private void listBox1_SelectedIndexChanged(object sender, EventArgs e) {

Text = listBox1.Text;

}

}

}

리스트 박스의 Text 프로퍼티를 읽으면 선택된 항목의 문자열을 바로 조사할 수 있다. 선택한 항목을 확인하기 위해 폼의 Text 프로퍼티에 대입했다.

실행중에 항목을 편집할 때는 Items 프로퍼티의 타입인 ObjectCollection 클래스의 메서드를 호출한다. Add, AddRange, Remove, RemoveAt, Insert, Clear 등의 메서드가 정의되어 있고 항목의 총 개수를 조사하는 Count 프로퍼티도 정의되어 있다. 다음 예제는 실행중에 리스트 박스의 항목을 추가 및 제거한다.

ListBoxItem

using System; ~ using System.Windows.Forms;

namespace ListBoxItem {

public partial class Form1 : Form {

public Form1() {

InitializeComponent();

}

// 항목 추가

private void button1_Click(object sender, EventArgs e) {

string Item = textBox1.Text;

listBox1.Items.Add(Item);

}

// 항목 제거

private void button2_Click(object sender, EventArgs e) {

int index = listBox1.SelectedIndex;

if (index != -1) {

listBox1.Items.RemoveAt(index);

}

}

// 모두 제거

private void button3_Click(object sender, EventArgs e) {

listBox1.Items.Clear();

}

}

}

리스트 박스와 텍스트 박스, 버튼을 배치해 놓고 이 컨트롤로 리스트 박스의 항목을 관리한다. 추가 버튼을 누르면 텍스트 박스의 문자열을 리스트 박스의 항목 목록에 추가하고 제거 버튼을 누르면 선택된 항목을 제거한다.

Items 프로퍼티의 Add, RemoveAt 같은 메서드만 호출하면 된다. 디자인 타임에 컬렉션 편집기로 입력한 항목도 이런 방식으로 실행 직후에 리스트 박스에 추가된 것이다.

22-4-2.오너 드로우

리스트 박스는 스스로 이벤트를 처리할 수 있는 컨트롤이며 목록만 제공하면 항목을 그리는 것도 직접 처리한다. 컬렉션 편집기에서 추가할 수 있는 항목은 문자열 뿐이므로 리스트 박스가 직접 관리하고 그릴 수 있는 항목도 문자열뿐이다. 그러나 오너, 즉 부모가 직접 그리면 문자열 뿐만 아니라 그래픽으로 된 내용물을 그릴 수 있다.

이런 식으로 오너가 직접 그리기는 컨트롤을 오너 드로우(Owner Draw)라고 한다. 리스트 박스뿐만 아니라 대부분의 컨트롤은 DrawMode 프로퍼티로 오너 드로우 방식을 지원한다. 이 프로퍼티가 None이 아니면 부모가 직접 내용물을 그릴 수 있도록 DrawItem 이벤트를 보낸다. 오너 드로우는 항목의 높이를 결정하는 방식에 따라 두 가지가 있다.

l OwnerDrawFixed : 항목의 높이가 일정하다. 항목의 높이는 ItemHeight 프로퍼티로 딱 한 번만 지정하면 된다.

l OwnerDrawVariable : 항목의 높이가 개별적으로 다르다. 따라서 프로퍼티로 항목의 높이를 지정할 수 없으며 각 항목에 대해 MeasureItem 이벤트로 질문을 하여 높이를 결정한다.

항목을 그릴 때는 부모에게 DrawItem 이벤트가 전달된다. 리스트 박스는 부모에게 이벤트를 보내 어떤 항목을 그려 달라고 부탁한다. 인수로 DrawItemEventArgs 객체를 전달하여 항목을 그리는데 필요한 정보를 프로퍼티로 제공하며 메서드도 포함되어 있다.

프로퍼티	타입	설명
Graphics	Graphics ⓡ	그리기에 사용할 Graphics 객체이다. 별도의 Graphics 객체를 생성할 필요 없이 인수로 전달된 객체를 사용하면 된다.
Bounds	Rectangle ⓡ	항목의 경계를 나타내는 사각영역이다. 항목은 이 경계 내에 그리면 된다.
Font	Font ⓡ	항목을 그리는데 사용할 글꼴이다.
ForeColor	Color ⓡ	항목의 전경색이다. 항목이 선택되어 있으면 HighlightText가 되고 그렇지 않으면 WindowText가 된다.
BackColor	Color ⓡ	항목의 배경색이다. 항목의 선택 여부에 따라 색상이 결정된다.
Index	int ⓡ	그릴 항목의 인덱스이다.
State	DrawItemState ⓡ	항목의 현재 상태를 나타내는 비트 필드이다. DrawItemState 열거형이며 Selected, Focus, Grayed, Disabled, Checked, None 등의 비트값의 조합으로 표현한다.

부모는 인수로 전달된 정보를 참조하여 항목을 그린다. 인덱스에 따라 그릴 대상을 결정하고 상태에 따라 배경색, 전경색, 항목의 모양을 그린다. State 프로퍼티는 항목의 상태인데 선택 여부에 따라 항목의 색상이 달라지며 포커스 여부에 따라 포커스 사각형을 그리기도 한다. 리스트 박스의 항목은 사용 금지될 수 없지만 사용 금지 상태가 있는 컨트롤(예:메뉴)은 흐릿하게 그린다.

DrawItemEventArgs 클래스에 State, 전경색, 배경색 등을 참조하여 배경과 포커스 사각형을 그리는 DrawBackground, DrawFocusRectangle 메서드가 제공된다. 다음 예제는 선의 모양을 오너 드로우 리스트 박스로 선택한다.

OwnerDrawList

using System; ~ using System.Windows.Forms;

using System.Drawing.Drawing2D;

namespace OwnerDrawList {

public partial class Form1 : Form {

private DashStyle Dash = DashStyle.Solid;

public Form1() {

InitializeComponent();

}

private void Form1_Paint(object sender, PaintEventArgs e) {

Pen P = new Pen(Color.Black, 2);

P.DashStyle = Dash;

e.Graphics.DrawRectangle(P, 200, 20, 140, 140);

}

private void listBox1_DrawItem(object sender, DrawItemEventArgs e) {

Pen P = new Pen(Color.Black, 2);

P.DashStyle = (DashStyle)e.Index;

e.DrawBackground();

P.Color = e.ForeColor;

e.Graphics.DrawLine(P, e.Bounds.Left + 10, e.Bounds.Top + 10,

e.Bounds.Right - 10, e.Bounds.Top + 10);

e.DrawFocusRectangle();

}

private void listBox1_SelectedIndexChanged(object sender, EventArgs e) {

ListBox L = (ListBox)sender;

Dash = (DashStyle)L.SelectedIndex;

Invalidate();

}

}

}

DashStyle 타입의 Dash 필드를 선언하고 Paint 이벤트에서 이 스타일로 펜을 만들어 사각형을 그린다. 디폴트는 Solid 즉, 실선이지만 Dash 필드의 값을 변경하면 외곽선 모양이 달라진다. 사용자가 펜의 모양을 선택하도록 오너 드로우 리스트 박스를 사용했다. 점선, 실선, 쇄선 따위의 이름보다는 실제 모양을 보여주는 것이 직관적이다.

폼에 리스트 박스를 배치하고 DrawMode를 OwnerDrawFixed로 선택하여 부모 폼이 그리기를 한다는 것과 항목의 높이가 일정하다는 것을 알린다. ItemHeight 프로퍼티에 20을 대입하여 각 항목은 20 픽셀 높이를 가지도록 지정한다. 그리고 리스트 박스의 Items 프로퍼티에 선의 모양에 해당하는 문자열 항목을 등록한다.

오너 드로우 리스트 박스는 문자열로 항목을 출력하지 않아 Items 프로퍼티의 문자열은 아무 의미가 없다. 다만 항목의 개수가 다섯 개라는 것을 밝힐 뿐인데 리스트 박스는 이 개수만큼 부모에게 DrawItem 이벤트를 보내 그리기 요청한다. 필요한 개수만큼 등록해 놓기만 하면 된다.

폼은 DrawItem 이벤트를 받았을 때 인수로 전달된 DrawItemEventArgs 객체를 참조하여 각 항목을 그린다. 항목의 인덱스 번호를 DashStyle로 캐스팅하면 Solid, Dash 등의 펜 스타일을 조사할 수 있다. 열거형은 0부터 시작하는 정수이므로 인덱스와 펜의 스타일을 일부러 일치시켜 놓았다. 인덱스 번호가 지정하는 대시 스타일로 펜을 생성한 후 배경을 그리고 전경색으로 선을 그었다.

DrawBackground, DrawFocusRectangle 메서드는 State 프로퍼티를 참조하여 항목의 상태에 맞는 배경색과 포커스 사각형을 그린다. SelectedIndexChanged 이벤트에서 선택된 항목의 인덱스를 Dash에 대입하고 무효화한다. Paint 이벤트는 변경된 Dash 값대로 펜을 만든 후 사각형을 다시 그린다. 코드는 복잡하지만 실제 적용될 선의 모양을 보면서 선택할 수 있어 편리하다.

이 예제는 항목의 인덱스와 선의 대시 열거값이 일치해서 코드가 아주 간단한데 그렇지 않을 경우 별도의 룩업 배열을 통해 인덱스로부터 적용할 값을 찾아야 한다. 가변 높이의 오너 드로우를 프로그래밍하는 방법도 거의 유사하다. 다만 항목별로 높이가 제각각이어서 MeasureItem 이벤트에서 인덱스에 따라 높이를 결정한다는 점이 다르다.

22-4-3.콤보 박스

콤보 박스는 리스트 박스와 텍스트 박스를 결합한 컨트롤이다. 평소에는 텍스트 박스처럼 보이지만 드롭 다운을 펼치면 리스트 박스가 열려 목록 중 하나를 고를 수 있다. 목록에 없는 것도 텍스트 박스에 직접 입력해 넣을 수 있고 필요할 때만 드롭 다운을 펼치므로 자리를 적게 차지한다. 그러나 드롭 다운을 펼치기 전에는 목록을 볼 수 없고 선택을 변경하기 위해 두 번 클릭해야 한다는 점은 불편하다.

리스트 박스와 거의 같은 용도로 사용하며 텍스트 박스도 포함하고 있어 리스트 박스와 텍스트 박스의 프로퍼티를 모두 가진다. Items, ItemHeight, Sorted는 리스트 박스의 것이고 Text, MaxLength는 텍스트 박스의 것이다. 콤보 박스에만 있는 프로퍼티도 몇 가지 있다. DropDownStyle은 동작 방식을 결정하는데 다음 셋 중 하나의 값을 가진다.

DropDownStyle	설명
DropDown	목록에서 고르거나 직접 입력할 수 있다. 이 값이 디폴트이다.
DropDownList	목록에서 고를 수만 있으며 직접 입력할 수는 없다.
Simple	목록이 항상 펼쳐져 있다.

DropDownWidth와 DropDownHeight 프로퍼티는 화살표 버튼을 누를 때 아래로 펼쳐지는 드롭 다운의 폭과 높이를 지정한다. 드롭 다운의 디폴트 폭은 콤보 박스의 폭과 같되 항목이 길면 콤보 박스보다 더 넓게 설정할 수도 있다.

드롭 다운의 높이는 한꺼번에 몇 개의 항목을 볼 수 있는가를 결정하는데 이 높이가 너무 낮으면 스크롤해야 아래쪽 항목을 선택할 수 있어 불편하다. 다음 예제는 세 가지 스타일의 콤보 박스를 만들고 테스트한다.

ComboBoxTest

using System; ~ using System.Windows.Forms;

namespace ComboBoxTest {

public partial class Form1 : Form {

public Form1() {

InitializeComponent();

}

private void comboBox1_SelectedIndexChanged(object sender, EventArgs e) {

Text = comboBox1.Text;

}

private void comboBox1_TextChanged(object sender, EventArgs e) {

Text = comboBox1.Text;

}

}

}

특별한 코드는 없고 첫 번째 콤보 박스의 선택이 바뀔 때 폼의 타이틀 바에 선택된 항목을 출력하여 확인만 한다. 콤보 박스는 위쪽의 텍스트 박스에 직접 입력할 수 있으므로 TextChanged 이벤트도 처리해야 한다.

DropDown 스타일의 첫 번째 콤보 박스는 직접 입력하거나 드롭 다운을 펼쳐 목록에서 선택한다. DropDownList 스타일의 두 번째 콤보 박스는 드롭 다운에서 선택만 할 수 있고 직접 입력은 불가능하다. 목록이 제한되어 있다면 DropDownList 스타일의 콤보 박스를 사용하는 것이 좋다. Simple 스타일의 콤보 박스는 항상 펼쳐져 목록을 언제나 볼 수 있고 직접 입력할 수도 있지만 자리를 너무 많이 차지한다.

다음은 리스트 박스의 또 다른 변형인 체크드 리스트 박스(CheckedListBox)에 대해 알아보자. ListBox로부터 파생되므로 모든 특성이 리스트 박스와 유사하다. 다만 항목이 단순한 문자열이 아니라 체크 박스를 가지는 옵션이라는 점만 다르다. 옵션의 목록은 Items 프로퍼티의 컬렉션 편집기를 통해 입력한다. 간단하게 예제를 만들어 보자.

CheckedListBoxTest

Items에 여러 가지 옵션을 추가했으며 코드는 작성하지 않았다. 옵션이 많다면 체크 박스를 일일이 나열하는 것보다 체크드 리스트 박스로 한꺼번에 입력받는 것이 간편하다. 옵션의 개수에 제한이 없고 스크롤까지 가능해 대량의 옵션을 일목요연하게 입력할 수 있다. 실행중에 항목을 추가하거나 삭제하는 것도 가능하다.

CheckedItems 프로퍼티를 읽으면 체크된 항목의 목록을 구할 수 있으며 CheckedIndices 프로퍼티는 체크된 항목의 인덱스를 구한다. Get(Set)ItemChecked 메서드로 개별 항목의 체크 여부를 조사하거나 변경한다.

22-4-4.컨트롤의 컬렉션

폼이나 그룹 박스, 패널처럼 다른 컨트롤을 자식으로 거느릴 수 있는 컨트롤을 컨테이너라고 한다. 컨테이너는 ControlCollection 타입의 Controls 프로퍼티로 소속 컨트롤의 목록을 유지하고 관리한다. ControlCollection 클래스는 컨트롤의 배열인데 목록을 관리하는 메서드와 프로퍼티가 정의되어 있다. 다음 메서드는 컨트롤을 추가, 제거한다.

public virtual void Add (Control value)

public virtual void AddRange (Control[] controls)

public virtual void Remove (Control value)

public void RemoveAt (int index)

이외에도 자식 컨트롤을 검색하거나 열거하는 메서드도 제공한다. ListBoxItem 예제의 디자이너가 만든 소스를 보면 다음과 같은 코드를 볼 수 있다.

this.Controls.Add(this.button3);

this.Controls.Add(this.button2);

this.Controls.Add(this.button1);

this.Controls.Add(this.textBox1);

this.Controls.Add(this.listBox1);

이 코드에 의해 세 개의 버튼과 리스트 박스, 텍스트 박스가 폼의 차일드로 배치된다. 디자이너가 작성한 코드를 그대로 따라하면 실행중에 컨트롤을 동적으로 생성할 수 있다. 다음 예제는 실행중에 버튼을 생성 및 파괴한다.

RuntimeControl

using System; ~ using System.Windows.Forms;

namespace RuntimeControl {

public partial class Form1 : Form {

Button Btn;

public Form1() {

InitializeComponent();

}

private void Btn_Click(object sender, EventArgs e) {

MessageBox.Show("실행중에 만든 버튼을 클릭했습니다.");

}

private void Form1_MouseDown(object sender, MouseEventArgs e) {

if (e.Button == MouseButtons.Left && Btn == null) {

Btn = new Button();

Btn.Location = new Point(10, 10);

Btn.Size = new Size(150, 25);

Btn.Name = "RunButton";

Btn.Text = "실행중에 만든 버튼";

Btn.Click += new EventHandler(Btn_Click);

Controls.Add(Btn);

}

if (e.Button == MouseButtons.Right && Btn != null) {

Controls.RemoveAt(0);

Btn = null;

}

}

}

}

디자인 타임에 컨트롤을 배치하지 않아 최초 실행시에는 폼에 아무것도 없다. 마우스 왼쪽 버튼을 누르면 버튼 컨트롤이 생성되며 이 버튼을 누르면 메시지 박스가 나타난다. 오른쪽 버튼을 누르면 버튼이 사라진다.

버튼 컨트롤을 생성할 때는 new 연산자로 Button 객체를 할당하고 프로퍼티에 적당한 값을 대입한 후 폼의 Controls 컬렉션에 추가한다. 프로퍼티뿐만 아니라 이벤트 핸들러도 += 연산자로 등록할 수 있다. 메서드를 실행중에 만들 수는 없어 핸들러는 미리 준비해 두어야 한다. 아니면 익명 메서드를 쓸 수도 있다.

제거할 때는 Controls 컬렉션의 RemoveAt 메서드로 첫 번째 차일드를 제거한다. 이 예제의 경우 차일드가 하나밖에 없어 무조건 0번을 지우는데 만약 차일드가 여러 개라면 제거 대상 컨트롤을 검색해야 한다. 컨트롤을 동적으로 생성하거나 제거할 때는 이중 생성 및 제거하지 않도록 조건을 잘 점검해야 하는데 위 예제는 Btn 필드가 null 인지 아닌지 점검함으로써 버튼이 생성되어 있는지 아닌지 조사한다.

런타임에 컨트롤을 생성하는 것은 디자인 타임에 개발툴의 도움을 받는 것보다 번거롭고 불편하다. 그러나 실행해 보기 전에 어떤 컨트롤이 몇 개나 필요한지 알 수 없는 경우가 있다. 성적을 텍스트 박스에 출력할 때 학생 수가 얼마나 될지 미리 알 수 없다면 실행중에 입력된 학생수만큼 텍스트 박스를 생성해야 한다.

가능한 최대치만큼 텍스트 박스를 미리 배치해 놓고 실행중에는 Visible 프로퍼티를 통해 꼭 필요한 컨트롤만 보이는 꼼수를 쓸 수도 있지만 낭비가 심하고 최대치만큼의 한계가 생긴다. 런타임에 생성하면 필요한만큼 컨트롤을 만들 수 있어 경제적이고 안전하다. 사실 닷넷의 컨트롤은 모두 런타임에 생성된다. 다만 그 생성 코드를 우리가 작성하느냐 아니면 디자이너가 작성하느냐의 차이가 있을 뿐이다.