AbstractButton QML Type
버튼에 공통적으로 적용되는 기능을 제공하는 추상 기본 유형. 더 보기...
| Import Statement: | import QtQuick.Controls |
| Inherits: | |
| Inherited By: |
속성
- action : Action
(since QtQuick.Controls 2.3 (Qt 5.10)) - autoExclusive : bool
- autoRepeat : bool
- autoRepeatDelay : int
(since QtQuick.Controls 2.4 (Qt 5.11)) - autoRepeatInterval : int
(since QtQuick.Controls 2.4 (Qt 5.11)) - checkable : bool
- checked : bool
- display : enumeration
(since QtQuick.Controls 2.3 (Qt 5.10)) - down : bool
- icon
(since QtQuick.Controls 2.3)- icon.cache : bool
(since QtQuick.Controls 2.3) - icon.color : color
(since QtQuick.Controls 2.3) - icon.height : int
(since QtQuick.Controls 2.3) - icon.name : string
(since QtQuick.Controls 2.3) - icon.source : url
(since QtQuick.Controls 2.3) - icon.width : int
(since QtQuick.Controls 2.3)
- icon.cache : bool
- implicitIndicatorHeight : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - implicitIndicatorWidth : real
(since QtQuick.Controls 2.5 (Qt 5.12)) - indicator : Item
- pressX : real
(since QtQuick.Controls 2.4 (Qt 5.11)) - pressY : real
(since QtQuick.Controls 2.4 (Qt 5.11)) - pressed : bool
- text : string
신호
- canceled()
- clicked()
- doubleClicked()
- pressAndHold()
- pressed()
- released()
- toggled()
(since QtQuick.Controls 2.2 (Qt 5.9))
방법
- void animateClick()
(since Qt 6.8) - void click()
(since Qt 6.8) - void toggle()
상세 설명
AbstractButton은 버튼과 유사한 동작을 하는 컨트롤(예: 푸시 버튼, 라디오 버튼 및 체크 박스와 같은 선택 가능 컨트롤)을 위한 인터페이스를 제공합니다. 추상 컨트롤로서, 이 인터페이스 자체에는 델리게이트 구현이 없으며, 이를 상속받는 타입에서 구현하도록 되어 있습니다.
ButtonGroup 및 Button 컨트롤항목도 참조하십시오 .
속성 설명
action : Action [since QtQuick.Controls 2.3 (Qt 5.10)]
이 속성은 버튼의 동작을 저장합니다.
이 속성은 QtQuick.Controls 2.3(Qt 5.10)에서 도입되었습니다.
Action도 참조하십시오 .
autoExclusive : bool
이 속성은 자동 배타성 기능이 활성화되어 있는지 여부를 나타냅니다.
자동 배타성이 활성화된 경우, 동일한 상위 항목에 속하는 선택 가능한 버튼들은 마치 동일한 선택 그룹( ButtonGroup)의 일부인 것처럼 동작합니다. 한 번에 하나의 버튼만 선택할 수 있으며, 다른 버튼을 선택하면 이전에 선택된 버튼의 선택이 자동으로 해제됩니다.
참고: 이 속성은 ' ButtonGroup'에 속한 버튼에는 영향을 미치지 않습니다.
RadioButton 및 TabButton 는 기본적으로 자동 배타성이 적용됩니다.
autoRepeat : bool
이 속성은 버튼이 눌린 상태로 유지되는 동안 버튼이 pressed(), released() 및 clicked() 신호를 반복적으로 발송할지 여부를 결정합니다.
이 속성이 true 로 설정된 경우, pressAndHold() 신호는 발생하지 않습니다.
기본값은 false 입니다.
초기 지연 시간과 반복 간격은 autoRepeatDelay 및 autoRepeatInterval 을 통해 밀리초 단위로 정의됩니다.
autoRepeatDelay : int [since QtQuick.Controls 2.4 (Qt 5.11)]
이 속성은 자동 반복의 초기 지연 시간을 밀리초 단위로 저장합니다. 기본값은 300 ms입니다.
이 속성은 QtQuick.Controls 2.4(Qt 5.11)에서 도입되었습니다.
autoRepeat 및 autoRepeatInterval도 참조하십시오 .
autoRepeatInterval : int [since QtQuick.Controls 2.4 (Qt 5.11)]
이 속성은 자동 반복 간격을 밀리초 단위로 저장합니다. 기본값은 100 ms입니다.
이 속성은 QtQuick.Controls 2.4(Qt 5.11)에서 도입되었습니다.
autoRepeat 및 autoRepeatDelay도 참조하십시오 .
checkable : bool
이 속성은 버튼이 선택 가능한지 여부를 나타냅니다.
선택 가능한 버튼은 사용자가 버튼을 클릭하거나 버튼에 포커스가 있는 상태에서 스페이스 바를 누르면 선택됨(켜짐)과 선택 해제됨(꺼짐) 상태를 번갈아 전환합니다.
기본값은 ` false`입니다.
checked도 참조하십시오 .
checked : bool
이 속성은 버튼이 선택되어 있는지 여부를 나타냅니다.
Qt 6.2부터는 이 속성을 설정해도 ` checkable ` 속성에 더 이상 영향을 미치지 않습니다. 필요한 경우 ` checkable ` 속성을 명시적으로 설정하십시오.
checkable도 참조하십시오 .
display : enumeration [since QtQuick.Controls 2.3 (Qt 5.10)]
이 속성은 버튼 내에서 ‘ icon ’ 및 ‘ text ’가 어떻게 표시될지를 결정합니다.
| 표시 | 표시 결과 |
|---|---|
AbstractButton.IconOnly |
|
AbstractButton.TextOnly |
|
AbstractButton.TextBesideIcon (기본값) |
|
AbstractButton.TextUnderIcon |
|
이 속성은 QtQuick.Controls 2.3(Qt 5.10)에서 도입되었습니다.
down : bool
이 속성은 버튼이 시각적으로 눌린 상태인지 여부를 나타냅니다.
명시적으로 설정하지 않는 한, 이 속성은 ` pressed`의 값을 따릅니다. 기본값으로 되돌리려면 이 속성을 ` undefined`로 설정하십시오.
pressed도 참조하십시오 .
icon group
icon.cache : bool [since QtQuick.Controls 2.3]
icon.color : color [since QtQuick.Controls 2.3]
icon.height : int [since QtQuick.Controls 2.3]
icon.name : string [since QtQuick.Controls 2.3]
icon.source : url [since QtQuick.Controls 2.3]
icon.width : int [since QtQuick.Controls 2.3]
| 이름 | 설명 |
|---|---|
| 이름 | 이 속성은 사용할 아이콘의 이름을 저장합니다. 아이콘은 플랫폼 테마에서 불러옵니다. 테마에서 아이콘이 발견되면, ` icon.source `가 설정되어 있더라도 항상 해당 아이콘이 사용됩니다. 아이콘이 발견되지 않으면 대신 ` icon.source `가 사용됩니다. 테마 아이콘에 대한 자세한 내용은 QIcon::fromTheme()을 참조하십시오. |
| source | 이 속성은 사용할 아이콘의 이름을 지정합니다. 아이콘은 일반 이미지처럼 로드됩니다. icon.name 가 설정되어 있고 유효한 테마 아이콘을 가리키는 경우, 이 속성 대신 항상 해당 아이콘이 사용됩니다. |
| width | 이 속성은 아이콘의 너비를 지정합니다. 아이콘의 너비는 이 값을 초과하지 않지만, 필요한 경우 축소될 수 있습니다. |
| height | 이 속성은 아이콘의 높이를 지정합니다. 아이콘의 높이는 이 값을 초과하지 않지만, 필요한 경우 크기가 줄어듭니다. |
| 색상 | 이 속성은 아이콘의 색상을 지정합니다. 색상이 ` |
| 캐시 | 이 속성은 아이콘을 캐시에 저장할지 여부를 지정합니다. 기본값은 true입니다. 자세한 내용은 cache 을 참조하십시오. 이 속성은 QtQuick.Controls 2.13 버전에서 도입되었습니다. |
이 속성들은 QtQuick.Controls 2.3에서 도입되었습니다.
text, display 및 Qt Quick Controls 의 ‘아이콘(Icons)’항목도 참조하십시오 .
implicitIndicatorHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]
이 속성은 암시적 지표의 높이를 나타냅니다.
이 값은 indicator ? indicator.implicitHeight : 0 과 같습니다.
이 속성은 일반적으로 implicitContentHeight 및 implicitBackgroundHeight 과 함께 사용되어 implicitHeight 을 계산합니다.
이 속성은 QtQuick.Controls 2.5(Qt 5.12)에서 도입되었습니다.
implicitIndicatorWidth도 참조하십시오 .
implicitIndicatorWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]
이 속성은 암시적 표시기 너비를 저장합니다.
이 값은 indicator ? indicator.implicitWidth : 0 와 동일합니다.
이 속성은 일반적으로 ` implicitContentWidth ` 및 ` implicitBackgroundWidth`과 함께 사용되어 ` implicitWidth`을 계산합니다.
이 속성은 QtQuick.Controls 2.5(Qt 5.12)에서 도입되었습니다.
implicitIndicatorHeight도 참조하십시오 .
indicator : Item
이 속성은 표시 항목을 포함합니다.
pressX : real [read-only, since QtQuick.Controls 2.4 (Qt 5.11)]
이 속성은 마지막으로 터치된 지점의 x 좌표를 저장합니다.
참고: 이 값은 터치 이동 시 업데이트되지만, 터치를 떼면 변경되지 않은 상태로 유지됩니다.
이 속성은 QtQuick.Controls 2.4(Qt 5.11)에서 도입되었습니다.
pressY도 참조하십시오 .
pressY : real [read-only, since QtQuick.Controls 2.4 (Qt 5.11)]
이 속성은 마지막으로 터치된 지점의 y 좌표를 저장합니다.
참고: 이 값은 터치 이동 시 업데이트되지만, 터치를 떼면 그대로 유지됩니다.
이 속성은 QtQuick.Controls 2.4(Qt 5.11)에서 도입되었습니다.
pressX도 참조하십시오 .
pressed : bool [read-only]
이 속성은 버튼이 물리적으로 눌려 있는지 여부를 나타냅니다. 버튼은 터치 이벤트나 키 이벤트를 통해 눌릴 수 있습니다.
down도 참조하십시오 .
text : string
이 속성에는 버튼에 대한 텍스트 설명이 포함됩니다.
참고: 이 텍스트는 접근성 목적으로 사용되므로, 콘텐츠 항목이 이미지인 경우에도 텍스트 설명을 설정하는 것이 좋습니다.
관련 항목: icon, display 및 contentItem.
Signal 문서
canceled()
이 신호는 버튼이 눌린 상태에서 마우스 그랩을 잃었을 때, 또는 released 신호를 발생시켜야 하지만 마우스 커서가 버튼 내부에 있지 않을 때 발생합니다.
참고: 이에 해당하는핸들러는 onCanceled 입니다.
clicked()
이 신호는 사용자가 터치, 마우스 또는 키보드를 통해 버튼을 직접 클릭할 때 발생합니다.
참고: 해당 핸들러는 onClicked 입니다.
click(), animateClick() 및 ‘버튼이 클릭되었을 때 QML에서 C++ 함수 호출하기’항목도 참조하십시오 .
doubleClicked()
이 신호는 사용자가 터치나 마우스를 통해 버튼을 상호작용 방식으로 두 번 클릭할 때 발생합니다.
참고: 해당 핸들러는 onDoubleClicked 입니다.
pressAndHold()
이 신호는 사용자가 터치나 마우스를 통해 버튼을 직접 누르고 계속 누르고 있을 때 발생합니다. ‘ autoRepeat ’가 활성화된 경우에는 발생하지 않습니다.
참고: 이에 해당하는핸들러는 onPressAndHold 입니다.
pressed()
이 신호는 사용자가 터치, 마우스 또는 키보드를 통해 버튼을 직접 눌렀을 때 발생합니다.
참고: 해당 핸들러는 onPressed 입니다.
released()
이 신호는 사용자가 터치, 마우스 또는 키보드를 통해 버튼을 직접 놓았을 때 발생합니다.
참고: 해당 핸들러는 onReleased 입니다.
[since QtQuick.Controls 2.2 (Qt 5.9)] toggled()
이 신호는 사용자가 터치, 마우스 또는 키보드를 통해 체크 가능한 버튼을 직접 토글할 때 발생합니다.
참고: 해당핸들러는 ` onToggled`입니다.
이 신호는 QtQuick.Controls 2.2(Qt 5.9)에서 도입되었습니다.
메서드 문서
[since Qt 6.8] void animateClick()
버튼이 클릭되는 것을 시뮬레이션하며, 누르는 시점과 손을 떼는 시점 사이에 100밀리초의 지연 시간을 두고, 그 과정에서 버튼의 시각적 상태가 변화하도록 애니메이션을 적용합니다.
클릭과 관련된 모든 신호가 적절하게 발생됩니다.
focusPolicy 에 Qt.ClickFocus 가 포함되어 있는 경우, activeFocus 는 true 로 변경됩니다.
버튼이 ‘ disabled ’ 상태인 경우, 이 함수는 아무런 작업도 수행하지 않습니다.
버튼이 놓이기 전에 이 함수를 다시 호출하면 릴리스 타이머가 재설정됩니다.
이 메서드는 Qt 6.8에서 도입되었습니다.
click(), pressed(), released(), clicked()도 참조하십시오 .
[since Qt 6.8] void click()
버튼을 눌렀다가 놓을 때까지 지연 시간 없이 클릭된 상태를 시뮬레이션합니다.
클릭과 관련된 모든 신호가 적절하게 발생합니다.
focusPolicy 에 Qt.ClickFocus 가 포함되어 있는 경우, activeFocus 은 true 로 변경됩니다.
버튼이 ‘ disabled ’ 상태인 경우, 이 함수는 아무 작업도 수행하지 않습니다.
버튼이 놓이기 전에 이 함수를 다시 호출하면 릴리스 타이머가 재설정됩니다.
이 메서드는 Qt 6.8에서 도입되었습니다.
animateClick(), pressed(), released(), clicked()도 참조하십시오 .
void toggle()
버튼의 선택 상태를 전환합니다.
click() 및 animateClick()도 참조하십시오 .
© 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.
