입력 컨트롤

Qt Quick Controls 은 숫자 및 텍스트 입력을 위한 다양한 입력 컨트롤을 제공합니다.

ComboBox

옵션을 선택하기 위한 버튼과 팝업 목록이 결합되어 있습니다.

Dial

회전하여 값을 설정하는 원형 다이얼

RangeSlider

트랙을 따라 두 개의 핸들을 밀어서 값의 범위를 선택하는 데 사용됩니다.

Slider

트랙을 따라 핸들을 밀어서 값을 선택하는 데 사용됩니다.

TextArea

여러 줄 텍스트 입력 영역

TextField

한 줄 텍스트 입력 필드

Tumbler

선택할 수 있는 항목의 회전 가능한 휠

각 입력 컨트롤 유형에는 고유한 대상 사용 사례가 있습니다. 다음 섹션에서는 사용 사례에 따라 적절한 입력 컨트롤 유형을 선택하기 위한 가이드라인을 제공합니다.

콤보박스 컨트롤

ComboBox 는 정적 여러 줄 드롭다운 목록에서 값을 선택하는 데 사용됩니다. 새 값을 추가할 수 없으며 하나의 옵션만 선택할 수 있습니다.

권장 사항:

  • 값의 수가 매우 많은 경우 필터를 적용하는 것이 좋습니다.
  • 목록이 매우 제한적인 경우에는 RadioButton 을 사용하는 것이 좋습니다. 이렇게 하면 사용자가 모든 옵션을 동시에 볼 수 있다는 장점이 있습니다.
  • 가장 자주 선택되는 값인 기본값을 선택합니다.

체크박스 컨트롤, 텀블러 컨트롤도참조하세요.

다이얼 컨트롤

Dial 은 스테레오나 산업용 장비와 같은 장치에서 볼 수 있는 기존의 다이얼 노브와 유사합니다.

다이얼은 클릭하고 드래그하여 회전하며, 손잡이는 다이얼의 값을 나타냅니다.

빠른 입력이 중요한 애플리케이션의 경우 다이얼을 클릭하면 해당 위치로 바로 이동하므로 원형( input mode )이 유용합니다.

정확한 입력이 중요한 애플리케이션의 경우 다이얼을 클릭한 위치에 따라 미세하게 조정할 수 있는 수평 및 수직 입력 모드를 사용하는 것이 좋습니다. 또한 이 모드는 오디오 볼륨을 조절하는 다이얼과 같이 값이 크게 점프하면 안전하지 않을 수 있는 다이얼에 더 적합합니다.

텀블러 컨트롤도참조하세요.

텍스트 영역 제어

TextArea 는 여러 줄 텍스트 편집기입니다.

텍스트 필드 컨트롤

TextField 는 한 줄 텍스트 편집기입니다.

텀블러 컨트롤도참조하십시오.

슬라이더 컨트롤

Slider 는 트랙을 따라 핸들을 밀어서 값을 선택하는 데 사용됩니다.

범위 슬라이더 컨트롤

RangeSlider 는 트랙을 따라 각 핸들을 밀어서 두 값으로 지정된 범위를 선택하는 데 사용됩니다.

슬라이더 컨트롤도참조하십시오.

텀블러 컨트롤

Tumbler 는 선택할 수 있는 항목의 회전 가능한 휠입니다.

콤보 상자 컨트롤도참조하십시오.

© 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.