버튼 컨트롤
Qt Quick Controls 는 다양한 버튼형 컨트롤을 제공합니다.
버튼에 공통된 기능을 제공하는 추상적인 기본 유형 | |
명령을 수행하거나 질문에 답하기 위해 클릭할 수 있는 푸시 버튼 | |
켜거나 끌 수 있는 확인 버튼 | |
충분히 길게 누르면 트리거되는 확인 버튼 | |
켜거나 끌 수 있는 전용 라디오 버튼 | |
사용자가 클릭할 수 있는 모서리가 둥근 푸시 버튼 컨트롤 | |
켜거나 끌 수 있는 버튼 | |
툴바에 적합한 모양의 버튼 |
각 유형의 버튼에는 고유한 사용 사례가 있습니다. 다음 섹션에서는 사용 사례에 따라 적절한 버튼 유형을 선택하기 위한 가이드라인을 제공합니다.
버튼 컨트롤
Button 는 작업을 시작하거나 팝업을 열거나 닫는 클릭 가능한 컨트롤입니다. 버튼에는 일반적으로 텍스트 레이블이 있지만 아이콘을 포함할 수도 있습니다.
버튼은 팝업이나 대화 상자에서 작업을 수행해야 할 때 매우 적합한 컨트롤입니다. 가장 일반적인 예로는 적용, 취소, 저장, 닫기 및 도움말이 있습니다.
권장 사항:
- 버튼의 텍스트는 작업을 설명하는 동사 또는 열릴 팝업의 제목과 일치하는 명사이어야 합니다.
- 상태를 설정하는 버튼은 사용하지 마세요. Switch 이 더 적합합니다.
- 달리 명시된 UI 가이드라인이 없는 한 기본 글꼴을 사용하세요.
- 텍스트가 현지화된 경우 긴 텍스트가 레이아웃에 미치는 영향을 고려하세요.
체크박스 컨트롤
CheckBox 는 다중 선택 옵션 목록을 작성하는 데 사용됩니다. 옵션을 선택하지 않는 것을 포함하여 원하는 수의 옵션을 선택할 수 있지만 옵션이 상호 배타적이어서는 안 됩니다.
양식에서 서비스 이용 약관에 동의해야 하는 경우와 같이 예/아니요를 선택해야 하는 경우에는 단일 CheckBox 을 사용합니다.
단일 예/아니요 선택의 경우 스위치를 사용할 수도 있습니다. 선택 항목이 옵션과 관련된 경우에는 CheckBox 을 사용하는 것이 가장 좋습니다. 취해야 할 조치와 관련된 경우에는 스위치를 사용하는 것이 좋습니다.
옵션을 그룹화할 수 있는 경우에는 부분적으로 체크된 CheckBox 을 사용하여 전체 그룹을 나타낼 수 있습니다. 사용자가 그룹에서 전체가 아닌 일부 하위 항목을 선택하는 경우에는 확인란의 partially checked state 을 사용합니다.
사용 가능한 체크 상태는 체크됨, 부분 체크됨, 체크되지 않음 등 세 가지입니다.
선택 가능한 옵션은 세로로 나열되는 경우가 많습니다.
권장 사항:
- 확인란 레이블은 확인 표시가 있으면 참이고, 확인 표시가 없으면 거짓이라는 문장으로 작성해야 합니다.
- 확인란 레이블에는 부정적인 문장이 포함되어서는 안 됩니다.
- 달리 명시된 UI 가이드라인이 없는 한 기본 글꼴을 사용합니다.
- 텍스트가 현지화된 경우 긴 텍스트가 레이아웃에 미치는 영향을 고려하세요.
참고 항목 CheckBox
지연 버튼 컨트롤
DelayButton 는 동작을 트리거하기 전에 지연을 포함하는 버튼입니다. 이 지연은 실수로 누르는 것을 방지합니다.
권장 사항:
- 터치 사용자 인터페이스에서 사용하세요.
- 신중하게 트리거해야 하는 작업에 사용하세요.
라디오 버튼 컨트롤
RadioButton 는 옵션 세트에서 하나의 옵션만 선택하는 데 사용됩니다. 하나의 옵션을 선택하면 이전에 선택한 옵션이 자동으로 선택 취소됩니다.
상호 배타적인 옵션이 두 개만 있는 경우 이를 하나의 확인란 또는 스위치로 결합합니다.
권장 사항:
- 라벨 텍스트는 한 줄로 제한하세요.
- 합리적인 기본 옵션이 선택되어 있는지 확인합니다.
- RadioButton 옵션을 세로로 나열합니다.
- 텍스트가 현지화된 경우 긴 텍스트가 레이아웃에 미치는 영향을 고려하세요.
- 달리 명시된 UI 가이드라인이 없는 한 기본 글꼴을 사용합니다.
- CheckBox 와 마찬가지로 목록을 너무 크게 만들지 마세요.
- 혼동을 피하기 위해 두 개의 라디오 버튼 그룹을 나란히 배치하지 마세요.
참고 항목 RadioButton
라운드 버튼 컨트롤
RoundButton 는 동작을 시작하거나 팝업을 열거나 닫는 클릭 가능한 컨트롤입니다. 정사각형 이미지 아이콘 또는 한 글자 글꼴 아이콘이 있는 둥근 버튼은 원형입니다. 원형 RoundButton 은 일반 Button 보다 공간을 덜 차지하며 플로팅 액션 버튼으로도 사용할 수 있습니다.
권장 사항:
- 라벨은 짧고 간결하게 작성하세요.
- 텍스트가 현지화된 경우 긴 텍스트가 레이아웃에 미치는 영향을 고려하세요.
참고 항목 RoundButton
스위치 제어
Switch 는 사용자가 '켜기' 또는 '끄기' 상태 중에서 선택할 수 있는 물리적 스위치를 나타냅니다. 스위치를 켜면 즉시 적용되는 이진 연산에는 스위치를 사용합니다. 예를 들어, 와이파이를 켜거나 끄는 스위치입니다.
권장 사항:
- 라벨은 짧고 간결하게 만드세요.
- 텍스트가 현지화된 경우에는 긴 텍스트가 레이아웃에 미치는 영향을 고려하세요.
참고 항목 Switch
도구 버튼 컨트롤
ToolButton 는 Button 과 거의 동일하지만 그래픽 모양이 ToolBar 에 삽입하기에 더 적합합니다.
참고 항목 ToolButton
관련 정보
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.