라디오 버튼

라디오 버튼은 2가지 상태를 가진 대화식 다이얼로그 항목입니다. 라디오 버튼에는 2가지 기본 종류가 있습니다: 단순한 것과 버튼 같은 것. 라디오 버튼은 세트에서 하나의 옵션을 선택하는 데 사용됩니다. 옵션이 하나 선택되면 동그라미에 점 표시가 나타나거나 라디오 버튼 서브타입에 따라 버튼이 눌러집니다.

동일한 옵션 세트에 속하는 라디오 버튼들을 "라디오 버튼 그룹"이라고 합니다. 세트에서 하나의 버튼을 선택하면 이전에 선택한 버튼이 선택 취소되므로 세트에서 옵션 중 하나만 선택할 수 있습니다. 이와는 대조적으로, 세트에서 둘 이상의 옵션을 동시에 선택해야 할 때 체크박스가 사용됩니다.

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

항목 타입

DG_ITM_RADIOBUTTON

서브 타입

값	의미
`DG_BT_TEXT`	단순한 텍스트 라디오 버튼입니다.
`DG_BT_ICON`	단순한 아이콘 라디오 버튼입니다.
`DG_BT_PUSHTEXT`	버튼 같은 텍스트 라디오 버튼입니다.
`DG_BT_PUSHICON`	버튼 같은 아이콘 라디오 버튼입니다.

GRC 사양

    RadioButton        x  y  dx  dy  fontSpec  groupID  "text"
    PushRadio          x  y  dx  dy  fontSpec  groupID  "text"

    IconRadioButton    x  y  dx  dy  groupID  iconID
    IconPushRadio      x  y  dx  dy  groupID  iconID

여기서 x와 y는 라디오 버튼의 좌상단 코너의 픽셀 좌표입니다. dx와 dy는 컨트롤의 폭과 높이의 픽셀 크기입니다. groupID은 컨트롤이 속한 라디오 버튼들의 그룹의 1-기반 인덱스를 정의합니다. 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`	라디오 버튼이 체크되었습니다. (스위치 on) 메시지 데이터 파라미터는 동일한 그룹 내에서 예전에 선택된 라디오 버튼의 1-기반 인덱스를 포함하고 있습니다.
`DG_MSG_DOUBLECLICK`	라디오 버튼을 더블 클릭 했습니다. 메시지 데이터 파라미터는 항상 0입니다. 다이얼로그 콜백 함수는 버튼 같은 라디오 버튼에 대하여 이 메시지를 수신합니다. (`DG_BT_PUSHTEXT`, `DG_BT_PUSHICON`)

수정 Flag

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

설명

라디오 버튼은 2가지 상태가 있습니다: 체크됨(누름)과 체크안됨(해제). DG에서 이러한 상태들은 라디오 버튼의 항목 값들로 표현됩니다. 항목 값 1은 체크된 상태를 의미하며 0은 체크되지 않은 상태를 나타냅니다. 라디오 버튼 상태를 세트하고 가져오려면 DGSelectRadio 또는 DGSetItemValLong 그리고 DGGetItemValLong을 호출하십시오. DGSetItemValLong을 사용하여 라디오 버튼을 선택 취소할 수 없습니다. 대신 같은 그룹에 있는 다른 라디오 버튼을 체크하십시오.

라디오 버튼은 동일한 다이얼로그 또는 탭 페이지의 다른 라디오 버튼과 그룹화할 수 있습니다. 그룹화 정보는 GRC에서만 지정할 수 있습니다. DG는 어떤 그룹의 라디오 버튼을 (사용자 액션 또는 프로그램 코드에 의해) 스위치 on 할 때 해당 그룹의 다른 라디오 버튼을 자동으로 스위치 off 합니다. 그룹 내의 라디오 버튼이 사용자 액션에 의해 켜지면 다이얼로그 콜백 함수는 라디오 버튼을 누르는 경우에만 DG_MSG_CHANGE로 호출됩니다. 그러나 그룹 내 모든 라디오 버튼의 수정 flag가 세트됩니다. (DGModified는 1을 리턴함) DGGetCheckedRadio를 사용하여 그룹에서 체크된 라디오 버튼의 1-기반 인덱스를 가져옵니다.

텍스트 스타일 라디오 버튼(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, DGGetCheckedRadio, DGGetItemFont, DGGetItemImage, DGGetItemImageId, DGGetItemText, DGGetItemValLong, DGModified, DGResetModified, DGSetItemFont, DGSetItemImage, DGSetItemImageId, DGSetItemText, DGSetItemValLong, 콜백 함수
DG_MSG_CHANGE, DG_MSG_DOUBLECLICK, DG_MSG_INIT