22-3.값 입력

22-3-1.텍스트 박스

텍스트 박스는 키보드로 문자열을 입력받으며 정수, 실수같은 수치형도 입력할 수 있다. 상속 계층은 다음과 같다.

TextBoxBase는 기본적인 입력, 선택, 클립보드 기능을 제공하는 추상 클래스이며 편집 기능과 서식 표현 여부에 따라 몇 가지 하위 클래스가 파생된다. 일반적인 문자열 입출력에는 TextBox 클래스 정도면 충분하다. 주요 프로퍼티는 다음과 같다.

프로퍼티	타입	설명
Text	string	텍스트 박스에 입력한 내용이다. 읽을 수도 있고 쓸 수도 있다. Text.Length 프로퍼티로 길이를 조사한다.
Multiline	bool	여러 줄을 입력받을 것인가를 지정한다. 디폴트값은 false이므로 딱 한 줄밖에 입력받지 못하지만 true로 변경하면 개행 코드를 인식하여 여러 줄 입력이 가능하다.
AcceptReturn	bool	Enter 키 입력을 개행으로 인식할 것인지 아니면 폼의 디폴트 버튼을 누르는 것으로 인식할 것인지를 지정한다. 디폴트는 false이다. AcceptReturn이 false이더라도 폼에 디폴트 버튼이 없으면 개행 코드가 입력된다.
ScrollBars	ScrollBars	스크롤 바의 표시 여부를 지정한다. 한 줄만 입력받는 텍스트 박스에는 필요 없지만 여러 줄을 입력받을 때는 마우스로 스크롤할 수 있도록 해야 한다. None, Horizontal, Verical, Both 중 하나를 선택한다.
PasswordChar	char	암호 문자를 지정한다. 0이면 암호 문자를 사용하지 않는다.
HideSelection	bool	텍스트 박스가 포커스를 잃을 때 선택 영역을 숨긴다.
Modified	bool	텍스트 편집 여부를 조사하거나 설정한다. 내용이 조금이라도 수정되면 true가 된다. 이 프로퍼티가 true이면 문서를 저장해야 한다.
ReadOnly	bool	읽기 전용인지 지정한다. 이 프로퍼티가 true이면 사용자가 텍스트를 편집할 수 없다.
SelectedText	string ⓥ	선택된 문자열을 조사한다. 이 프로퍼티에 다른 문자열을 대입하면 선택 영역이 대체된다.
SelectionStart	int	선택 영역의 시작 지점을 나타낸다. 선택 영역이 없으면 캐럿의 위치를 나타낸다.
SelectionLength	int ⓥ	선택 영역의 길이이며 문자수로 표현한다. 선택 영역이 없으면 0이다.
WordWrap	bool	여러 줄을 입력할 수 있는 텍스트 박스에서 자동 개행을 할 것인가를 지정한다.
UseSystemPasswordChar	bool	시스템이 정의하는 기본 암호 문자를 사용한다.
Lines	string[]	전체 문장을 문자열의 배열 형태로 조사하며 문단 단위로 텍스트를 읽는다.
CharacterCasing	CharacterCasing	대소문자 표시 여부를 지정한다. 디폴트인 Normal은 입력한 대로 표시되지만 Lower나 Upper로 지정하면 입력한 문자가 소문자나 대문자로 강제 변환되어 표시된다.

여러 줄을 편집할 때 Multiline을 변경하는데 이 프로퍼티를 true로 바꾸지 않으면 딱 한 줄만 입력할 수 있으며 텍스트 박스의 높이를 변경할 수 없다. 다음은 텍스트 박스의 메서드인데 주로 클립보드 동작을 수행한다.

메서드	설명
AppendText(str)	문자열을 뒤에 추가한다. Text += "문자열"; 과 같다.
Clear()	모든 문자열을 삭제한다. Text = ""; 과 같다.
Cut()	선택 영역을 삭제한다.
Copy()	선택 영역을 클립보드로 복사한다.
Paste()	클립보드의 문자열을 현재 위치에 붙여 넣는다.
Select(int, int)	지정한 영역을 선택한다.
SelectAll()	모든 문자열을 선택한다.

프로퍼티가 바뀔 때는 MultilineChanged, ReadOnlyChanged, ModifiedChanged 등의 이벤트가 전달된다. 사용자가 문자열을 편집할 때마다 발생하는 TextChanged 이벤트가 가장 실용적이다. 편집 즉시 어떤 동작을 하고 싶다면 이 이벤트의 핸들러를 작성한다.

TextBoxTest

using System; ~ using System.Windows.Forms;

namespace TextBoxTest {

public partial class Form1 : Form {

public Form1() {

InitializeComponent();

}

private void textBox1_TextChanged(object sender, EventArgs e) {

TextBox text = sender as TextBox;

Text = text.Text;

}

private void maskedTextBox1_TextChanged(object sender, EventArgs e) {

if (maskedTextBox1.MaskCompleted) {

label1.Text = "휴대폰 번호 입력 완료";

} else {

label1.Text = "번호 형식이 맞지 않습니다.";

}

}

}

}

폼에 텍스트 박스를 배치하고 TextChanged 이벤트에서 텍스트 박스의 Text 프로퍼티를 읽어 폼의 Text 프로퍼티에 대입했다. 사용자가 텍스트 박스에 입력한 내용을 폼의 타이틀 바에 출력한다. 다음 항에서 알아볼 마스크 텍스트 박스와 리치 텍스트 박스도 미리 배치해 두었다.

편집 즉시 어떤 동작을 하지 않는다면 굳이 TextChanged 이벤트를 처리할 필요 없다. 언제든 Text 프로퍼티를 읽으면 사용자가 입력한 텍스트를 조사할 수 있다. 대화상자의 텍스트 박스는 사용자가 마음대로 편집하도록 내버려 두고 대화상자를 닫을 때 입력한 값을 조사하는 것이 일반적이다.

22-3-2.마스크 텍스트 박스

정수나 실수를 입력받는 컨트롤은 따로 존재하지 않으며 텍스트 박스로 입력받는다. 키보드로부터 입력되는 모든 정보는 일단 문자열로 받아 원하는 타입으로 변환해서 사용해야 한다. 예를 들어 텍스트 박스로 가격을 입력받는다면 다음과 같이 한다.

Price = Convert.ToInt32(textBox1.Text);

Text 프로퍼티를 통해 사용자가 입력한 문자열을 구하고 ToInt32 메서드로 정수형으로 변환한다. 이렇게 하면 불편한 것은 둘째 치더라도 사용자가 엉뚱한 문자를 입력할 때 예외가 발생한다는 문제가 있다. 프로그램의 의도를 정확하게 알고 텍스트 박스에 1000, 3000 같은 숫자만 입력한다면 아무 문제가 없지만 "싸게", "좀 깍아줘" 라고 입력할 수도 있다. 아라비아 숫자가 아닌 문자열은 정수로 변환할 수 없으므로 예외가 발생하며 이 예외를 처리하지 않으면 프로그램은 다운되어 버린다.

사용자는 부정확한 존재이고 무슨 짓을 할 지 알 수 없다. 그래서 규칙에 맞는 문자만 입력하도록 강제할 필요가 있는데 이때 마스크 텍스트 박스를 사용한다. Mask 프로퍼티에 규칙을 미리 설정해 놓으면 사용자는 규칙에 맞는 문자만 입력할 수 있다. 마스크는 어떤 종류의 문자가 입력 가능한지, 필수적인지 선택적인지 등의 규칙을 지정한다.

마스크	설명
0	0~9 사이의 숫자만 입력받을 수 있으며 필수적으로 입력해야 한다.
9	숫자 또는 공백을 입력받으며 선택적이다.
#	숫자 또는 공백, +, - 기호를 쓸 수 있으며 선택적이다.
L	문자이며 필수이다. AsciiOnly 프로퍼티가 false이면 한글도 입력 가능하다.
?	선택적인 문자이다.
&	문자이며 필수이다.
C	선택적인 문자이다.
A, a	영숫자이며 선택적이다.
.	소수점 자리 표시이다. 실제 표시되는 문자는 FormatProvider 프로퍼티에 의해 결정된다.
,	천자리 표시이다.
:	시간 구분 기호이다.
/	날짜 구분 기호이다.
$	통화 구분 기호이다.
<	이후 나오는 모든 문자를 소문자로 변환한다.
>	이후 나오는 모든 문자를 대문자로 변환한다.
|	이전의 <, > 설정을 비활성화한다.
\	마스크 문자를 이스케이프하여 리터럴로 만든다.
그외 문자	사용자가 직접 편집할 수 없는 리터럴이며 미리 입력되어 있다. 예를 들어 전화 번호의 하이픈 등은 미리 입력해 놓는다.

개수도 많지만 규칙도 복잡해 제대로 쓰려면 많은 연습이 필요하다. 속성창에서 Mask 프로퍼티를 편집할 때 대화상자로 샘플을 보여준다. 샘플을 통해 마스크 문자를 활용하는 예를 볼 수 있으며 약간만 응용하면 원하는 마스크를 어렵지 않게 만들 수 있다.

휴대폰 번호는 000-9000-0000으로 마스크가 지정되어 있다. 앞 세 자리는 010, 011 같은 사업자 번호이며 필수적으로 기입해야 한다. 국번은 3자리 또는 4자리이므로 제일 앞자리는 선택적이고 나머지 세 자리는 필수적이다. 전화 번호 4 자리는 모두 숫자이며 생략할 수 없다. 사업자 번호, 국번, 전화번호의 중간에는 하이픈이 미리 입력되어 있어 사용자는 번호만 입력할 수 있다.

사용자가 마스크대로 입력했는지 조사하려면 MakeComplete, MaskFull 프로퍼티를 조사한다. MaskComplete는 필수 입력 마스크가 입력되었는지만 점검하고 MaskFull은 선택 입력 마스크까지도 점검하는 점이 다른데 통상 MaskComplete 프로퍼티를 점검하면 된다. 이 프로퍼티가 true가 아니면 요구한 정보중 일부를 입력하지 않았거나 잘못된 문자를 입력한 것이므로 재입력을 요구해야 한다. BeepOnError 프로퍼티는 입력할 수 없는 문자를 입력할 때 경고음을 출력한다.

이 마스크에 의하면 017-777-9907이나 010-9696-1818 같은 번호는 잘 입력되고 적법하지만 02-123-4567이나 033-58-8282 같은 번호는 마스크 조건을 만족하지 못하므로 MaskComplete 프로퍼티가 true로 조사되지 않는다. 017-123-???? 나 010-1234-abcd 같은 번호는 아예 입력조차 거부되며 BeepOnError 프로퍼티가 true일 때 삑삑거리며 허튼 짓 하지 말라는 경고음까지 출력된다.

주민등록번호나 학번, 제품 코드 처럼 형식이 엄격한 정보는 마스크 기능을 사용하여 안전하게 입력받는 것이 좋다. 물론 마스크를 쓰더라도 논리적인 값의 구조까지 완벽하게 점검할 수 있는 것은 아니다. 휴대폰 번호에 015-123-4567 같은 삐삐 번호를 입력한다든가 851597-2122678 같은 틀린 주민등록번호에 대한 것까지 걸러낼 수는 없다. 이런 논리적인 에러는 TextChanged 이벤트에서 따로 점검해야 한다.

RichTextBox 컨트롤은 서식을 지정할 수 있다는 면에서 텍스트 박스보다 기능이 많다. 글꼴이나 문단의 모양까지 지정할 수 있어 워드프로세서 수준의 편집이 가능하다. 그러나 RTF 포맷이 난해하고 속도도 느려 실용성이 떨어진다. 서식있는 텍스트를 출력할 때는 차라리 커스텀 컨트롤을 만드는 것이 더 낫다.

22-3-3.스크롤 바

스크롤 바는 표시할 내용이 작업영역보다 더 많을 때 스크롤하기 위해 사용한다. 비주얼 스튜디오의 소스 편집창에 사용되며 텍스트 박스나 리스트 박스처럼 다량의 항목을 관리하는 컨트롤에도 스크롤 바가 나타난다.

스크롤 바는 문서의 어디쯤을 표시할 것인지 위치를 선택하며 정확한 값보다는 대충의 값을 신속하게 입력받을 때 주로 사용한다. 문서의 위치도 대충 선택하는 것이며 볼륨이나 동영상 재생 위치도 정확성보다는 신속한 선택이 더 우선이다. 정확한 값은 텍스트 박스를 쓰는 것이 적합하다.

ScrollBar 추상 클래스가 스크롤 바를 표현하며 수평, 수직 방향에 따라 파생된 HScrollBar, VScrollBar 클래스를 사용한다. 이 두 클래스는 스크롤 방향만 다를 뿐 프로퍼티나 이벤트는 거의 동일하므로 수평 스크롤 바 위주로 알아보자. 다음은 스크롤 바의 주요 프로퍼티인데 스크롤 범위와 이동할 때 값의 증감분을 지정한다.

프로퍼티	타입	설명
Minimum, Maximum	int	최소값과 최대값이며 곧 스크롤 범위를 지정한다. 디폴트는 0~100이다.
SmallChange	int	양쪽의 화살표 버튼을 클릭할 때 변화될 값이다. 디폴트는 1이다.
LargeChange	int	스크롤 바의 몸통을 클릭할 때 변화될 값이다. 디폴트는 10이다.
Value	int	현재 스크롤 바의 위치이다.

사용자가 스크롤 바를 클릭하거나 드래그하면 Scroll 이벤트가 발생하며 인수로 ScrollEventArgs 객체가 전달된다. 이 객체의 OldValue, NewValue 프로퍼티는 스크롤 하기 전의 값과 후의 값이며 ScrollOrientation 프로퍼티는 스크롤 방향이 수평인지, 수직인지를 나타낸다. Type 프로퍼티는 사용자가 스크롤 바의 어디를 조작했는지를 나타낸다.

Type	설명
SmallIncrement, SmallDecrement	스크롤 바 양쪽의 화살표 버튼을 클릭한 것이다. 이때는 SmallChange 프로퍼티가 지정하는 양만큼 Value가 증감한다.
LargeIncrement, LargeDecrement	스크롤 바의 몸통을 클릭한 것이다. 이때는 LargeChange 프로퍼티가 지정하는 양만큼 Value가 증감한다.
ThumbTrack	스크롤 바 중앙의 썸(Thumb)을 드래그하여 이동하고 있는 중이다.
ThumbPosition	스크롤 바 중앙의 썸(Thumb)을 드래그하여 이동을 완료했다.
First	Minimum 위치로 이동했다. 스크롤 바가 포커스를 가질 때 Home 키를 누르면 이 이벤트가 발생한다.
Last	Maximum 위치로 이동했다.
EndScroll	스크롤이 끝났다.

다음 예제는 스크롤 바로 버튼의 배경색을 선택한다. 색상은 R, G, B 세 요소로 구성되며 각 요소는 0 ~ 255까지의 범위를 가지므로 스크롤 바로 입력받기에 적당하다. 버튼과 스크롤 바 세 개를 배치하고 스크롤 바의 Maximum 프로퍼티를 255로 수정했다. 키보드 포커스를 받으려면 TabStop 프로퍼티를 true로 설정한다.

ScrollTest

using System; ~ using System.Windows.Forms;

namespace ScrollTest {

public partial class Form1 : Form {

public Form1() {

InitializeComponent();

}

private void hScrollBar1_Scroll(object sender, ScrollEventArgs e) {

button1.BackColor = Color.FromArgb(hScrollBar1.Value,

hScrollBar2.Value, hScrollBar3.Value);

}

}

}

세 스크롤 바의 Scroll 이벤트 핸들러는 따로 만들 필요 없이 통합하여 작성했다. 색상 요소 중 하나라도 바뀌면 배경색을 다시 지정해야 하므로 중복된 코드를 작성할 필요 없다. 이벤트 핸들러에서 각 스크롤 바의 Value 값을 색상 요소로 하여 FromArgb로 색상을 만든 후 버튼의 BackColor 프로퍼티에 대입한다.

스크롤 바를 클릭하거나 드래그하면 버튼의 배경색이 변한다. TabStop 프로퍼티를 true로 지정했으므로 스크롤 바가 포커스를 가질 수 있으며 커서 이동키, PgUp, PgDn, Home, End 키로 스크롤 바를 조작한다. 포커스를 받은 스크롤 바는 썸이 깜박거린다. 스크롤 바와 비슷한 트랙바도 있는데 용도나 방법은 거의 같되 모양이 조금 다르다.