BANANA.Web.Controls.CheckBox

BANANA.Web.Controls.CheckBox는 체크박스 컨트롤입니다.
상세한 기능은 아래에 정의된 체크박스 컨트롤의 property를 참조하세요.
System.Web.UI.WebControls.CheckBox 컨트롤을 확장한 컨트롤이기 때문에 기존에 사용하시던 CheckBox 컨트롤과 유사합니다.
다만 몇가지 바나나 프레임워크에서 확장된 기능들 위주로 설명 드리겠습니다.
우선 아래에 보이는 체크박스의 기본 모양을 살펴볼까요?
좌측에 있는 것이 바나나 프레임워크에서 제공하는 체크박스이고, 우측에 있는 것이 닷넷에서 기본적으로 제공하는 체크박스 컨트롤입니다.
어떤 차이가 있는지 확인이 되시나요? 네, 맞습니다. 바나나 프레임워크의 체크박스는 체크박스의 텍스트가 세로로 정렬이 되어 있지요.
체크박스의 체크 컨트롤과 텍스트가 세로로 정렬되어 있습니다. 별 것 아니지만, 많은 고객들이 요구하는 사항이지요?

이제 property를 살펴 보겠습니다.

Properties
Name Type Description
AutoTab bool
(default: true)
엔터키를 입력하였을 때, 자동으로 다음 포커스로 이동할지 여부를 가져오거나 저장합니다.
주의 하실 점은 다음 포커스로 이동하는 개체는 바나나 프레임워크의 컨트롤만 가능합니다.
그리고, 활성화 되어 있는 컨트롤에만 포커스가 주어지게 됩니다.
아래 링크를 클릭하시면, AutoTab에 대한 예제 화면을 보실 수 있습니다.
AutoTab에 대한 예제 화면
ContainerID string
(읽기전용)
컨트롤과 컨트롤에 종속적인 각종 오브젝트를 포함한 전체 태그의 ID를 가져옵니다.
닷넷 기본 컨트롤들의 ClientID와는 다릅니다.
IsToggleHeader bool
(default: false)
다른 체크박스들을 한 번에 체크/해제하는 헤더 체크박스인지 여부를 가져오거나 저장합니다.
IsToggleHeader가 true로 설정된 체크된 체크박스가 체크되면, 나머지 IsToggleHeader가 true로 설정되지 않은 자식 체크박스들을 자동으로 체크/해제합니다.
Toggle 상세설명 바로가기
ResourceName string 다국어를 지원하기 위한 리소스명을 가져오거나 저장합니다.
리소스명을 지정해 놓으면, 해당 컨트롤의 Text 속성에 해당하는 다국어 리소스를 자동으로 표기합니다.
다국어는 브라우저의 기본 언어 속성을 파악하여, 자동으로 해당 언어를 출력합니다.
또는, 강제적으로 특정 언어를 사용하도록 지정할 수도 있습니다.
좀 더 상세한 설명을 원하시면, 아래 링크를 클릭하세요.
리소스명 지정에 대한 상세설명 바로가기
ShowDot bool
(default: false)
컨트롤 앞에 작고 네모난 점을 하나 찍어 줍니다.
 
<ul>과 비슷한 효과를 주게 됩니다.
ToggleGroup string IsToggleHeader와 함께 사용되는 속성입니다.
IsToggleHeader가 true로 설정되어 있는 체크박스가 체크/해제되면, 해당 체크박스의 ToggleGroup 값과 동일한 나머지 체크박스들이 체크/해제됩니다.
물론 헤더 체크박스의 ToggleGroup이 공백 문자열이라면, 모든 자식 체크박스들을 관리하게 됩니다.
이때에는 자식 체크박스가 어떤 ToggleGroup에 속해 있는지를 따지지 않습니다.
Value object 간혹 개발하시다가, 체크박스에 텍스트 값 이외에 어떠한 값을 저장해야할 필요가 있으셨나요?
Value 속성을 이러한 경우에 유용하게 사용될 수 있습니다.

  

protected void Page_Load(object sender, EventArgs e)
{
	if (!IsPostBack)
	{
		CheckBox3.Value = "Value 값입니다";
	}
}

protected void Button1_Click(object sender, EventArgs e)
{
	Label1.Text = (string)CheckBox3.Value;
}

TOP