체크박스

체크박스는 두 상태 대화식 다이얼로그 항목입니다. 2가지 기본적인 종류의 체크박스가 있습니다: 단순한 것과 버튼 같은 것. 체크박스들은 세트에서 하나 이상의 옵션을 사용하거나 사용하지 않도록 설정하는 데 사용됩니다. 옵션이 선택되면, 체크 마크가 상자 안에 나타나거나, 체크박스 서브 타입에 따라 눌러진 버튼이 나타납니다.

체크박스는 세트에서 둘 이상의 옵션을 동시에 선택할 수 있는 경우에 사용됩니다. 이와는 대조적으로, 세트의 옵션 중 하나만 선택해야 할 경우 라디오 버튼을 사용해야 합니다.

DG에는 또 다른 특별한 종류의 체크박스가 있는데, 소위 푸시 메뉴 컨트롤(DG_BT_PUSHMENUICON 서브 타입)입니다. 푸시 메뉴 컨트롤은 아이콘 버튼의 팝업 메뉴와 결합된 체크박스입니다. 표준 버튼과 같은 체크박스의 동작 외에도 이 컨트롤에는 몇 가지 특별한 기능이 있습니다. 이것이 DG에서 일련의 핸들링 함수들을 가지고 있는 이유입니다. 자세한 내용은 푸시 메뉴 컨트롤 및 푸시 메뉴 특정 함수들을 참조하십시오.

항목 타입

DG_ITM_CHECKBOX

서브 타입

서브 타입	의미
`DG_BT_TEXT`	단순한 텍스트 체크박스입니다.
`DG_BT_ICON`	단순한 아이콘 체크박스입니다.
`DG_BT_PUSHTEXT`	버튼 같이 생긴 텍스트 체크박스입니다.
`DG_BT_PUSHICON`	버튼 같이 생긴 아이콘 체크박스입니다.

GRC 사양

    CheckBox         x  y  dx  dy  fontSpec  "text"
    PushCheck        x  y  dx  dy  fontSpec  "text"

    IconCheckBox     x  y  dx  dy  iconID
    IconPushCheck    x  y  dx  dy  iconID

여기서 x와 y는 체크박스의 좌상단 코너의 픽셀 좌표입니다. dx와 dy는 컨트롤의 폭과 높이의 픽셀 크기입니다. fontSpec은 체크박스 text의 글꼴 크기와 스타일을 선언합니다. iconID는 아이콘 스타일 체크박스의 아이콘 리소스 ID를 정의합니다.

fontSpec의 가능한 값은 다음과 같습니다:

값	DGSetItemFont에서 사용되는 DG 상수 조합
`ExtraSmall`	`DG_IS_EXTRASMALL`
`SmallPlain`	`DG_IS_SMALL \| DG_IS_PLAIN`
`SmallBold`	`DG_IS_SMALL \| DG_IS_BOLD`
`SmallItalic`	`DG_IS_SMALL \| DG_IS_ITALIC`
`SmallUnderline`	`DG_IS_SMALL \| DG_IS_UNDERLINE`
`LargePlain`	`DG_IS_LARGE \| DG_IS_PLAIN`
`LargeBold`	`DG_IS_LARGE \| DG_IS_BOLD`
`LargeItalic`	`DG_IS_LARGE \| DG_IS_ITALIC`
`LargeUnderline`	`DG_IS_LARGE \| DG_IS_UNDERLINE`

제안된 크기

텍스트 스타일 체크박스의 경우, 다음 항목 높이를 제안합니다. GRC에서 혹은 프로그램 코드로 체크박스를 생성할 때 이 값들을 사용하는 것을 권고합니다.

서브 타입	`dy` (픽셀)
`DG_BT_TEXT`	18
`DG_BT_PUSHTEXT`	20

메시지

메시지	의미
`DG_MSG_CHANGE`	체크박스의 체크된 상태가 변경되었습니다. 메시지 데이터 파라미터는 체크박스의 이전 상태를 포함하고 있습니다.
`DG_MSG_DOUBLECLICK`	체크박스를 더블클릭 했습니다. 메시지 데이터 파라미터는 항상 0입니다. 다이얼로그 콜백 함수는 버튼 같은 체크박스에 대해서만 이 메시지를 받습니다. (`DG_BT_PUSHTEXT`, `DG_BT_PUSHICON`)

수정 Flag

DGSetItemValLong 함수는 다이얼로그 콜백 함수에서 DG_MSG_INIT 메시지를 처리할 때 호출되는 경우를 제외하고 체크박스의 수정 flag를 세트합니다. flag는 또한 DG_MSG_CHANGE 메시지를 생성하는 사용자 액션에 의해 세트될 수 있습니다. 수정 flag의 상태를 가져오거나 리셋(지우기)하려면 DGModified 또는 DGResetModified를 사용하십시오.

설명

체크박스에는 2가지 상태가 있습니다: 체크됨(누름)과 체크안됨(해제). DG에서 이러한 상태들은 체크박스의 항목 값들로 표시됩니다. 항목 값 1은 체크된 상태를 의미하며 0은 체크되지 않은 상태를 나타냅니다. 체크박스의 상태를 세트하고 가져오려면 DGSetItemValLong과 DGGetItemValLong를 호출하십시오.

텍스트 스타일 체크박스(DG_BT_TEXT, DG_BT_PUSHTEXT)의 텍스트는 각각 DGSetItemText, DGCatItemText, DGGetItemText로 세트, 변경, 가져올 수 있습니다. 텍스트는 모든 타입의 DG 글꼴로 표시할 수 있습니다. 글꼴은 GRC뿐만 아니라 DGSetItemFont 함수로도 지정할 수 있습니다. DGGetItemFont를 사용하여 현재 체크박스에 할당된 글꼴을 가져옵니다.

아이콘 스타일의 체크박스(DG_BT_ICON, DG_BT_PUSHICON)의 아이콘은 리소스 ID 또는 아이콘의 핸들에 의해 할당될 수 있습니다. 체크박스의 아이콘을 세트하고 가져오려면 각각 DGSetItemImageId 또는 DGSetItemImage 그리고 DGGetItemImageId 또는 DGGetItemImage를 사용합니다. 아이콘 리소스 ID는 GRC에서도 정의할 수 있습니다.

요구사항

버전: DG 2.2.0 또는 이후

헤더: DG.h

참고사항

다이얼로그 항목 타입, 푸시 메뉴 컨트롤, 라디오 버튼
푸시 메뉴 지정 함수, DGCatItemText, DGGetItemFont, DGGetItemImage, DGGetItemImageId, DGGetItemText, DGGetItemValLong, DGModified, DGResetModified, DGSetItemFont, DGSetItemImage, DGSetItemImageId, DGSetItemText, DGSetItemValLong, 콜백 함수
DG_MSG_CHANGE, DG_MSG_DOUBLECLICK, DG_MSG_INIT