RadioButtonGroup 컨트롤
RadioButtonGroup 컨트롤은 라디오 단추 그룹입니다. 이를 통해 사용자는 값의 미리 결정된 목록에서 속성에 대한 문자열 또는 정수 값을 선택할 수 있습니다. 컨트롤 테이블의 속성 열에 속성 이름을 입력하여 이 컨트롤을 속성과 연결할 수 있습니다. RadioButton 테이블의 값 열에서 선택할 수 있는 값을 지정합니다. 표시되는 문자열이 반드시 사용자가 선택하는 값과 동일하지는 않습니다.
모든 RadioButtonGroup 컨트롤은 속성과 연결됩니다. 이 속성의 기본값은 Property 테이블에서 초기화해야 합니다. RadioButton 테이블에 지정된 각 RadioButtonGroup 내에 이 속성의 기본값과 일치하는 값 필드의 값을 가진 하나의 라디오 단추가 있을 수 있습니다. RadioButtonGroup 컨트롤의 기본 단추입니다. 기본 단추는 처음에 컨트롤에서 선택된 대로 표시됩니다.
그룹의 단추 중 하나가 선택될 때까지 대화 상자의 포커스가 RadioButtonGroup 컨트롤로 이동할 수 없습니다. 포커스를 이 단추 그룹으로 이동하게 만들려면 단추 중 하나를 그룹의 기본 단추로 지정합니다.
RadioButtonGroup 컨트롤은 속성 값만 설정하며 ControlEvent를 보내는 데 사용할 수 없습니다.
구현은 전체 그룹을 하나의 컨트롤로 처리하므로 그룹 내에서 개별 단추를 숨기거나 사용하지 않도록 설정할 수 없습니다. 마찬가지로 모든 단추는 동일한 스타일이어야 합니다. 즉, 모든 단추에 텍스트가 있거나 모두 비트맵(또는 기타 유사한 기능)이 있어야 합니다. 단추의 위치는 그룹을 기준으로 작성됩니다. 이렇게 하면 개별 단추를 변경하지 않고 그룹의 좌표만 변경하여 전체 그룹을 이동할 수 있습니다. 만들 때 컨트롤은 개별 단추가 그룹의 경계를 넘어 확장되지 않는지 확인합니다.
컨트롤 특성
이 컨트롤에서 다음 특성을 사용할 수 있습니다. 이벤트를 사용하여 특성값을 변경하려면 EventMapping 테이블의 ControlEvent에 컨트롤을 구독하고 특성 열에 특성의 식별자를 나열합니다. 이벤트 열에 ControlEvent의 식별자를 입력합니다.
| 특성 식별자 | 16진수 비트 | 설명 |
|---|---|---|
| IndirectPropertyName | 컨트롤과 연결된 간접 속성의 이름입니다. 간접 특성 비트가 설정되면 컨트롤이 이 이름을 가진 속성의 값을 표시하거나 변경합니다. 간접 특성 비트가 설정된 경우 이 이름은 컨트롤 테이블의 속성 열에 나열된 속성의 값이기도 합니다. | |
| 위치 | 대화 상자에서 컨트롤의 위치입니다. 컨트롤의 왼쪽 모서리에 있는 컨트롤의 너비, 높이 및 좌표를 Control 테이블의 너비, 높이, X 및 Y 열에 입력합니다. 길이 및 거리에 설치 관리자 단위를 사용합니다. |
|
| PropertyName | 이 컨트롤과 연결된 속성의 이름입니다. 간접 특성 비트가 설정되지 않은 경우 컨트롤은 이 이름을 가진 속성의 값을 표시하거나 변경합니다. 이 특성은 컨트롤 테이블의 속성 열에 지정됩니다. | |
| PropertyValue | 이 컨트롤에 의해 표시되거나 변경된 속성의 현재 값입니다. 간접 특성 비트가 설정되지 않은 경우 PropertyName 값입니다. Indirect 특성 비트가 설정된 경우 IndirectPropertyName 값입니다. 특성이 변경되면 컨트롤에 새 값이 반영됩니다. | |
| Text | 이 컨트롤 특성은 컨트롤에 표시되는 텍스트, 이진 테이블에 저장된 이미지 또는 런타임에 설정된 이미지를 지정할 수 있습니다. 텍스트를 지정하려면 컨트롤 테이블의 텍스트 열에 텍스트 문자열을 입력합니다. 이 텍스트의 글꼴 및 글꼴 스타일을 설정하려면 표시된 문자의 문자열 앞에 {\style} 또는 {&style}을 접두사로 묶습니다. 여기서 style은 TextStyle 테이블의 TextStyle 열에 나열된 식별자입니다. 둘 중 어느 것도 없지만 DefaultUIFont 속성이 유효한 텍스트 스타일로 정의된 경우 해당 글꼴이 사용됩니다. 이진 테이블에 저장된 아이콘 또는 비트맵 이미지를 지정하려면 이진 테이블의 Name 열에서 컨트롤 테이블 레코드의 Text 열에 이미지 레코드의 기본 키를 입력합니다. |
|
| Visible | 0x00000000 0x00000001 |
숨겨진 컨트롤입니다. 표시되는 컨트롤입니다. 컨트롤 테이블의 속성 열 비트 단어에 이 비트를 포함하면 컨트롤을 만들 때 컨트롤이 표시되거나 숨겨집니다. ControlCondition 테이블 사용하여 컨트롤을 숨기거나 표시할 수도 있습니다. |
| Enabled | 0x00000000 0x00000002 |
사용 안 함 상태의 컨트롤입니다. 사용 상태의 컨트롤입니다. 컨트롤을 만들 때 컨트롤을 사용하도록 설정하려면 컨트롤의 특성 열에 이 비트를 포함합니다. ControlCondition 테이블을 사용하여 컨트롤을 사용하거나 사용하지 않도록 설정할 수도 있습니다. |
| 오목 | 0x00000000 0x00000004 |
기본 비주얼 스타일을 표시합니다. 움푹 들어간 3D 모양으로 컨트롤을 표시합니다. 컨트롤 테이블의 특성 열에 비트 단어에 해당 비트를 포함합니다. |
| 간접 | 0x00000000 0x00000008 |
컨트롤은 컨트롤 테이블의 속성 열에 속성값을 표시하거나 변경합니다. 컨트롤은 컨트롤 테이블의 속성 열에 식별자가 나열된 속성의 값을 표시하거나 변경합니다. 이 컨트롤과 연결된 속성이 간접적으로 참조되는지 여부를 확인합니다. |
| 정수 | 0x00000000 0x00000010 |
컨트롤과 연결된 속성은 문자열 값입니다. 컨트롤과 연결된 속성은 정수 값입니다. 컨트롤을 만들 때 이 특성을 설정하려면 컨트롤 테이블의 특성 열의 비트 단어에 이 비트를 포함합니다. |
| RTLRO | 0x00000000 0x00000020 |
컨트롤의 텍스트는 왼쪽에서 오른쪽 읽기 순서로 표시됩니다. 컨트롤의 텍스트는 오른쪽에서 왼쪽으로 읽기 순서로 표시됩니다. |
| RightAligned | 0x00000000 0x00000040 |
컨트롤의 텍스트가 왼쪽에 맞춰집니다. 컨트롤의 텍스트가 오른쪽에 맞춰집니다. |
| PushLike | 0x00000000 0x00020000 |
컨트롤은 일반적인 모양으로 그려집니다. 컨트롤에는 BS_PUSHLIKE 스타일이 있으며 푸시 단추로 표시되도록 그려집니다. 컨트롤을 만들 때 이 특성을 설정하려면 컨트롤 테이블의 특성 열의 비트 단어에 이 비트를 포함합니다. |
| Bitmap | 0x00000000 0x00040000 |
컨트롤의 텍스트는 컨트롤 테이블의 텍스트 열에 지정됩니다. 컨트롤에는 BS_BITMAP 스타일이 있으며 컨트롤의 텍스트는 비트맵 이미지로 바뀝니다. 컨트롤 테이블의 텍스트 열은 이진 테이블의 외래 키로 사용됩니다. 컨트롤 테이블의 특성 열 비트 단어에 이러한 비트를 포함합니다. 아이콘 및 비트맵 스타일 비트를 동시에 설정하지 마세요. 단추는 비트맵 이미지와 텍스트를 모두 포함할 수 없습니다. 텍스트 문자열의 글꼴 및 글꼴 스타일을 설정하려면 표시된 문자의 문자열 앞에 {\style} 또는 {&style}을 접두사로 묶습니다. 여기서 style은 TextStyle 테이블의 TextStyle 열에 나열된 식별자입니다. 둘 중 어느 것도 없지만 DefaultUIFont 속성이 유효한 텍스트 스타일로 정의된 경우 해당 글꼴이 사용됩니다. |
| 아이콘 | 0x00000000 0x00080000 |
컨트롤의 텍스트는 컨트롤 테이블의 텍스트 열에 지정됩니다. 컨트롤에는 BS_ICON 스타일이 있으며 컨트롤의 텍스트는 비트맵 이미지로 바뀝니다. 컨트롤 테이블의 텍스트 열은 이진 테이블의 외래 키로 사용됩니다. 컨트롤 테이블의 특성 열 비트 단어에 이러한 비트를 포함합니다. 아이콘 및 비트맵 비트를 동시에 설정하지 마세요. 단추에는 아이콘 이미지와 텍스트가 모두 포함될 수 없습니다. 텍스트 문자열의 글꼴 및 글꼴 스타일을 설정하려면 표시된 문자의 문자열 앞에 {\style} 또는 {&style}을 접두사로 묶습니다. 여기서 style은 TextStyle 테이블의 TextStyle 열에 나열된 식별자입니다. 둘 중 어느 것도 없지만 DefaultUIFont 속성이 유효한 텍스트 스타일로 정의된 경우 해당 글꼴이 사용됩니다. |
| FixedSize | 0x00000000 0x00100000 |
컨트롤에 맞게 아이콘 이미지를 늘입니다. 컨트롤의 아이콘 이미지를 자르거나 가운데에 표시합니다. 컨트롤 테이블 테이블의 특성 열 비트 단어에 이 비트를 포함합니다. |
| IconSize | 0x00000000 0x00200000 0x00400000 0x00600000 |
첫 번째 이미지를 로드합니다. 처음 16x16 이미지를 로드합니다. 처음 32x32 이미지를 로드합니다. 처음 48x48 이미지를 로드합니다. 아이콘 파일에는 동일한 아이콘의 다양한 크기 이미지가 포함될 수 있습니다. 컨트롤 테이블의 특성 열에 적절한 비트 단어의 값을 포함합니다. 이러한 비트가 설정되지 않은 경우 설치 관리자는 FixedSize 특성을 무시하고 이미지가 컨트롤 사각형에 맞게 늘어납니다. IconSize 비트와 FixedSize 비트가 모두 설정되면 컨트롤보다 작은 이미지가 가운데에 배치되고 이미지는 맞춰져서 축소된 컨트롤보다 큽니다. |
| HasBorder | 설정되지 않음 0x01000000 |
테두리가 없고 텍스트가 없습니다. 테두리와 텍스트를 표시합니다. Control의 특성 열에 있는 비트 단어에 16777216 포함하여 테두리와 텍스트를 표시합니다. |
설명
Windows에서 프레임을 그리는 방식 때문에 캡션이 없는 경우에도 컨트롤 창의 위쪽과 표시되는 프레임 사이에 간격이 있습니다.
이 컨트롤은 CreateWindowEx 함수를 사용하여 BUTTON 클래스에서 만들 수 있습니다. HasBorder 비트가 설정된 경우 BS_GROUPBOX 스타일이 있으며, 그렇지 않으면 BS_OWNERDRAW 스타일이 있습니다.
RadioButtonGroup 컨트롤은 다른 컨트롤과 겹치지 않아야 하며 다른 컨트롤은 RadioButtonGroup과 겹치지 않아야 합니다. 이 컨트롤과 다른 컨트롤이 겹치면 컨트롤이 제대로 작동하지 않거나 잘못 표시될 수 있습니다. RadioButtonGroup 컨트롤에 대한 추가 설명 텍스트를 화면 리더 프로그램에 제공하려면 라디오 단추에 추가 텍스트 추가에 제공된 예제를 따릅니다.