이 페이지에서

입력 컨트롤

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

ComboBox

옵션을 선택하기 위한 버튼과 팝업 목록의 결합

Dial

값을 설정하기 위해 회전하는 원형 다이얼

DoubleSpinBox

사용자가 미리 설정된 부동 소수점 값 집합 중에서 선택할 수 있게 해줍니다

RangeSlider

트랙을 따라 두 개의 핸들을 슬라이드하여 값의 범위를 선택하는 데 사용됩니다

SearchField

검색 기능에 사용하도록 설계된 특수 입력 필드

Slider

트랙을 따라 핸들을 슬라이드하여 값을 선택하는 데 사용됩니다

SpinBox

사용자가 미리 설정된 값 집합 중에서 선택할 수 있게 해줍니다

TextArea

여러 줄 텍스트 입력 영역

TextField

단일 줄 텍스트 입력 필드

Tumbler

선택 가능한 항목이 표시된 회전 가능한 휠

각 입력 컨트롤 유형마다 고유한 사용 사례가 있습니다. 다음 섹션에서는 사용 사례에 따라 적절한 입력 컨트롤 유형을 선택하는 데 필요한 지침을 제공합니다.

콤보박스 컨트롤

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.