이 페이지에서

버튼 컨트롤

Qt Quick Controls 버튼과 유사한 다양한 컨트롤을 제공합니다.

AbstractButton

버튼에 공통적으로 적용되는 기능을 제공하는 추상 기본 유형

Button

클릭하여 명령을 실행하거나 질문에 답할 수 있는 푸시 버튼

CheckBox

켜거나 끌 수 있는 체크 버튼

DelayButton

충분히 오래 누르고 있으면 작동하는 체크 버튼

RadioButton

켜거나 끌 수 있는 배타적 라디오 버튼

RoundButton

사용자가 클릭할 수 있는 모서리가 둥근 푸시 버튼 컨트롤

Switch

켜거나 끌 수 있는 버튼

ToolButton

툴바에 어울리는 디자인의 버튼

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

버튼 컨트롤

Button 은 클릭 시 특정 동작을 시작하거나 팝업을 열거나 닫는 클릭 가능한 컨트롤입니다. 버튼에는 일반적으로 텍스트 레이블이 있지만 아이콘이 포함될 수도 있습니다.

버튼은 팝업이나 대화 상자에서 특정 작업을 수행해야 할 때 매우 적합한 컨트롤입니다. 가장 일반적인 예로는 ‘적용’, ‘취소’, ‘저장’, ‘닫기’ 및 ‘도움말’이 있습니다.

권장 사항:

  • 버튼의 텍스트는 해당 동작을 설명하는 동사이거나, 열릴 팝업의 제목과 일치하는 명사여야 합니다.
  • 상태를 설정하는 데 버튼을 사용하지 마십시오. 그런 용도에는 ' Switch '가 더 적합합니다.
  • 별도의 UI 가이드라인이 없는 한 기본 글꼴을 사용하십시오.
  • 텍스트가 현지화되는 경우, 텍스트가 길어질 때 레이아웃에 미치는 영향을 고려하십시오.

관련 항목: Button 및 AbstractButton

CheckBox 컨트롤

CheckBox 는 다중 선택 옵션 목록을 구성하는 데 사용됩니다. 선택하지 않는 경우를 포함하여 원하는 수의 옵션을 선택할 수 있지만, 옵션들은 서로 배타적이지 않아야 합니다.

양식에서 서비스 약관에 동의해야 하는 경우와 같이 ‘예/아니오’ 선택의 경우 단일 CheckBox 를 사용하십시오.

단일 예/아니오 선택의 경우 스위치를 사용할 수도 있습니다. 선택 사항이 옵션과 관련된 경우에는 CheckBox 를 사용하는 것이 가장 좋습니다. 취해야 할 조치와 관련된 경우에는 스위치를 사용하는 것이 권장됩니다.

옵션을 그룹으로 묶을 수 있는 경우, 전체 그룹을 나타내기 위해 부분적으로 선택된 CheckBox 를 사용할 수 있습니다. 사용자가 그룹 내의 일부 하위 항목을 선택했지만 전부는 선택하지 않은 경우에는 체크박스의 ‘ partially checked state ’를 사용하십시오.

체크박스의 세 가지 가능한 상태는 ‘선택됨(checked)’, ‘부분적으로 선택됨(partially checked)’, ‘선택되지 않음(unchecked)’입니다.

선택 가능한 옵션은 대개 세로로 나열됩니다.

권장 사항:

  • 체크박스 레이블은 체크 표시가 있을 때 참이 되고, 체크 표시가 없을 때 거짓이 되는 문장이어야 합니다.
  • 체크박스 레이블에는 부정적인 문구가 포함되어서는 안 됩니다.
  • 별도의 UI 지침이 없는 한 기본 글꼴을 사용해야 합니다.
  • 텍스트가 현지화되는 경우, 텍스트 길이가 늘어나면 레이아웃에 미치는 영향을 고려하십시오.

참조 CheckBox

DelayButton 컨트롤

DelayButton 는 동작을 실행하기 전에 지연 시간을 두는 버튼입니다. 이 지연 시간은 실수로 버튼을 누르는 것을 방지합니다.

권장 사항:

  • 터치 기반 사용자 인터페이스에서 사용하십시오.
  • 신중하게 실행해야 하는 작업에 사용하십시오.

참조: Button 및 AbstractButton

RadioButton 컨트롤

RadioButton 은 일련의 옵션 중에서 단 하나의 옵션만 선택하는 데 사용됩니다. 하나의 옵션을 선택하면 이전에 선택했던 옵션은 자동으로 선택이 해제됩니다.

서로 배타적인 옵션이 두 개뿐인 경우, 이를 하나의 체크박스나 스위치로 통합하십시오.

권장 사항:

  • 라벨 텍스트는 한 줄로 제한하십시오.
  • 적절한 기본 옵션이 선택되어 있는지 확인하십시오.
  • RadioButton 한 옵션들은 세로로 나열하십시오.
  • 텍스트가 현지화되는 경우, 텍스트 길이가 길어질 때 레이아웃에 미치는 영향을 고려하십시오.
  • 별도로 명시된 UI 가이드라인이 없는 한 기본 글꼴을 사용하십시오.
  • CheckBox 의 경우와 마찬가지로 목록을 너무 길게 만들지 마십시오.
  • 혼동을 피하기 위해 두 그룹의 라디오 버튼을 나란히 배치하지 마십시오.

참조 RadioButton

RoundButton 컨트롤

RoundButton 은 작업을 시작하거나 팝업을 열거나 닫는 클릭 가능한 컨트롤입니다. 사각형 이미지 아이콘이나 한 글자 글꼴 아이콘이 있는 둥근 버튼은 원형입니다. 원형 RoundButton 은 일반 Button 보다 공간을 덜 차지하며, 플로팅 액션 버튼으로도 사용할 수 있습니다.

체크 표시 아이콘이 있는 둥근 버튼

권장 사항:

  • 라벨은 짧고 간결하게 작성하십시오.
  • 텍스트가 현지화되는 경우, 텍스트 길이가 길어질 때 레이아웃에 미치는 영향을 고려하십시오.

참조 RoundButton

스위치 컨트롤

'Switch'라고 표시된 스위치가 꺼진 상태

Switch 는 사용자가 “켜기” 또는 “끄기” 상태 중에서 선택할 수 있게 해주는 물리적 스위치를 나타냅니다. 스위치를 켜자마자 즉시 효과가 나타나는 이진 작업에 스위치를 사용하십시오. 예를 들어, Wi-Fi를 켜거나 끄는 스위치입니다.

권장 사항:

  • 라벨은 짧고 간결하게 작성하십시오.
  • 텍스트가 현지화되는 경우, 텍스트 길이가 길어질 때 레이아웃에 미치는 영향을 고려하십시오.

참조 Switch

ToolButton 컨트롤

'ToolButton'이라는 레이블이 붙은 도구 버튼

ToolButton 는 Button 와 거의 동일하지만, 그래픽적인 외관 덕분에 ToolBar 에 삽입하기에 더 적합합니다.

참조 ToolButton

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