입력 컨트롤
Qt Quick Controls 숫자 및 텍스트 입력을 위한 다양한 입력 컨트롤을 제공합니다.
옵션을 선택하기 위한 버튼과 팝업 목록의 결합 | |
값을 설정하기 위해 회전하는 원형 다이얼 | |
사용자가 미리 설정된 부동 소수점 값 집합 중에서 선택할 수 있게 해줍니다 | |
트랙을 따라 두 개의 핸들을 슬라이드하여 값의 범위를 선택하는 데 사용됩니다 | |
검색 기능에 사용하도록 설계된 특수 입력 필드 | |
트랙을 따라 핸들을 슬라이드하여 값을 선택하는 데 사용됩니다 | |
사용자가 미리 설정된 값 집합 중에서 선택할 수 있게 해줍니다 | |
여러 줄 텍스트 입력 영역 | |
단일 줄 텍스트 입력 필드 | |
선택 가능한 항목이 표시된 회전 가능한 휠 |
각 입력 컨트롤 유형마다 고유한 사용 사례가 있습니다. 다음 섹션에서는 사용 사례에 따라 적절한 입력 컨트롤 유형을 선택하는 데 필요한 지침을 제공합니다.
콤보박스 컨트롤
ComboBox 은 정적인 다중 행 드롭다운 목록에서 값을 선택하는 데 사용됩니다. 새 값을 추가할 수 없으며, 하나의 옵션만 선택할 수 있습니다.
권장 사항:
- 값의 수가 매우 많다면 필터를 적용하는 것을 고려하십시오.
- 목록이 매우 제한적인 경우, RadioButton 를 사용하는 것을 고려해 보십시오. 이 방법은 사용자가 모든 옵션을 한 번에 볼 수 있다는 장점이 있습니다.
- 가장 자주 선택될 것으로 예상되는 값을 기본값으로 지정하십시오.
참조: CheckBox 컨트롤, Tumbler 컨트롤.
다이얼 컨트롤

Dial 은 스테레오나 산업용 장비와 같은 장치에서 볼 수 있는 기존의 다이얼 노브와 유사합니다.
다이얼은 클릭하고 드래그하여 회전하며, 핸들은 다이얼의 값을 나타냅니다.
빠른 입력이 중요한 응용 프로그램의 경우, 다이얼을 클릭하면 해당 위치로 바로 이동하는 원형 input mode 가 유용합니다.
정밀한 입력이 중요한 애플리케이션의 경우, 다이얼을 클릭한 위치를 기준으로 미세한 조정이 가능한 수평 및 수직 입력 모드를 사용하는 것이 좋습니다. 이러한 모드는 오디오 볼륨을 제어하는 다이얼과 같이 값이 크게 변동하면 위험할 수 있는 다이얼에도 더 적합합니다.
‘텀블러 컨트롤’항목도 참조하십시오.
TextArea 컨트롤

TextArea 는 여러 줄로 구성된 텍스트 편집기입니다.
TextField 컨트롤

TextField 는 단일 줄 텍스트 편집기입니다.
Tumbler 컨트롤도 참조하십시오.
슬라이더 컨트롤
Slider 트랙을 따라 핸들을 밀어서 값을 선택하는 데 사용됩니다.
RangeSlider 컨트롤
RangeSlider 각 핸들을 트랙을 따라 슬라이딩하여 두 값으로 지정된 범위를 선택하는 데 사용됩니다.
'슬라이더 컨트롤'도 참조하십시오.
텀블러 컨트롤

Tumbler 선택할 수 있는 항목이 표시된 회전 가능한 휠입니다.
'콤보박스 컨트롤'도 참조하십시오.
관련 정보
© 2026 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.