AbstractButton QML Type

버튼에 공통된 기능을 제공하는 추상 기본 유형입니다. 더 보기...

Import Statement: import QtQuick.Controls
Inherits:

Control

Inherited By:

Button, CheckBox, DelayButton, ItemDelegate, MenuBarItem, MenuItem, RadioButton, Switch, and TabButton

속성

신호

방법

상세 설명

AbstractButton은 버튼과 같은 동작을 하는 컨트롤(예: 라디오 버튼 및 확인란과 같은 푸시 버튼 및 체크 가능한 컨트롤)을 위한 인터페이스를 제공합니다. 추상 컨트롤로서 델리게이트 구현이 없으므로 이 컨트롤에서 파생되는 유형에 맡깁니다.

ButtonGroup버튼 컨트롤을참조하세요 .

속성 문서

action : Action [since QtQuick.Controls 2.3 (Qt 5.10)]

이 프로퍼티는 버튼 액션을 보유합니다.

이 프로퍼티는 QtQuick.Controls 2.3(Qt 5.10)에서 도입되었습니다.

Action참조하십시오 .


autoExclusive : bool

이 속성은 자동 독점성 활성화 여부를 저장합니다.

자동 독점성이 활성화되면 동일한 상위 항목에 속하는 체크 가능한 버튼은 동일한 ButtonGroup 의 일부인 것처럼 동작합니다. 한 번에 하나의 버튼만 체크할 수 있으며, 다른 버튼을 체크하면 이전에 체크한 버튼의 체크가 자동으로 해제됩니다.

참고: 이 속성은 ButtonGroup 에 속한 버튼에는 영향을 미치지 않습니다.

RadioButtonTabButton 는 기본적으로 자동 독점입니다.


autoRepeat : bool

이 속성은 버튼을 길게 누르고 있는 동안 버튼이 pressed(), released() 및 clicked() 신호를 반복할지 여부를 유지합니다.

이 속성을 true 으로 설정하면 pressAndHold() 신호가 전송되지 않습니다.

기본값은 false 입니다.

초기 지연 및 반복 간격은 autoRepeatDelayautoRepeatInterval 으로 밀리초 단위로 정의됩니다.


autoRepeatDelay : int [since QtQuick.Controls 2.4 (Qt 5.11)]

이 속성은 자동 반복의 초기 지연을 밀리초 단위로 유지합니다. 기본값은 300 ms입니다.

이 프로퍼티는 QtQuick.Controls 2.4(Qt 5.11)에서 도입되었습니다.

autoRepeatautoRepeatInterval참조하십시오 .


autoRepeatInterval : int [since QtQuick.Controls 2.4 (Qt 5.11)]

이 속성은 자동 반복 간격을 밀리초 단위로 유지합니다. 기본값은 100 ms입니다.

이 프로퍼티는 QtQuick.Controls 2.4 (Qt 5.11)에 도입되었습니다.

autoRepeatautoRepeatDelay참조하십시오 .


checkable : bool

이 속성은 버튼의 체크 가능 여부를 저장합니다.

체크 가능 버튼은 버튼에 활성 포커스가 있는 상태에서 사용자가 버튼을 클릭하거나 스페이스바를 누르면 체크(켜짐)와 체크 해제(꺼짐) 사이를 전환합니다.

기본값은 false 입니다.

checked참조하세요 .


checked : bool

이 속성은 버튼의 체크 여부를 보유합니다.

Qt 6.2부터는 이 속성을 설정해도 checkable 속성에 더 이상 영향을 주지 않습니다. 필요한 경우 checkable 속성을 명시적으로 설정하세요.

checkable도 참조하십시오 .


display : enumeration [since QtQuick.Controls 2.3 (Qt 5.10)]

이 속성은 버튼 내에 icontext 이 표시되는 방식을 결정합니다.

표시결과
AbstractButton.IconOnly

AbstractButton.TextOnly

AbstractButton.TextBesideIcon (기본값)

AbstractButton.TextUnderIcon

이 프로퍼티는 QtQuick.Controls 2.3(Qt 5.10)에 도입되었습니다.

spacingpadding참조하십시오 .


down : bool

이 속성은 버튼이 시각적으로 아래로 표시되는지 여부를 저장합니다.

명시적으로 설정하지 않는 한, 이 속성은 pressed 값을 따릅니다. 기본값으로 돌아가려면 이 속성을 undefined 으로 설정합니다.

pressed참조하세요 .


icon group

icon.cache : bool

icon.color : color

icon.height : int

icon.name : string

icon.source : url

icon.width : int

이 속성 그룹은 QtQuick.Controls 2.3에 추가되었습니다.

Name설명
name이 속성에는 사용할 아이콘의 이름이 저장됩니다.

아이콘은 플랫폼 테마에서 로드됩니다. 테마에서 아이콘을 찾을 수 있으면 icon.source 이 설정되어 있어도 항상 해당 아이콘이 사용됩니다. 아이콘을 찾을 수 없으면 icon.source 이 대신 사용됩니다.

테마 아이콘에 대한 자세한 내용은 QIcon::fromTheme()를 참조하세요.

source이 속성에는 사용할 아이콘의 이름이 저장됩니다.

아이콘은 일반 이미지로 로드됩니다.

icon.name 이 설정되어 있고 유효한 테마 아이콘을 참조하는 경우 이 속성 대신 항상 해당 아이콘이 사용됩니다.

width이 속성은 아이콘의 너비를 보유합니다.

아이콘의 너비는 이 값을 초과하지 않지만 필요한 경우 축소됩니다.

높이이 속성은 아이콘의 높이를 저장합니다.

아이콘의 높이는 이 값을 초과하지 않지만 필요한 경우 축소됩니다.

color이 속성은 아이콘의 색상을 저장합니다.

색상이 "transparent" 로 설정되지 않은 경우 아이콘은 지정된 색상으로 채색됩니다.

캐시이 속성은 아이콘을 캐시할지 여부를 지정합니다.

기본값은 true입니다.

자세한 내용은 cache 을 참조하세요.

이 속성은 QtQuick.Controls 2.13에 도입되었습니다.

text, display, 및 Qt Quick Controls 의 아이콘도참조하세요 .


implicitIndicatorHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

이 속성은 암시적 표시기 높이를 보유합니다.

값은 indicator ? indicator.implicitHeight : 0 입니다.

이것은 일반적으로 implicitContentHeightimplicitBackgroundHeight 과 함께 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 와 같습니다.

이것은 일반적으로 implicitContentWidthimplicitBackgroundWidth 과 함께 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참조하세요 .


신호 문서

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밀리초의 지연 시간을 두고 버튼을 클릭하는 것을 시뮬레이션하여 그 과정에서 시각적 상태에 애니메이션을 적용합니다.

클릭과 관련된 모든 신호가 적절하게 방출됩니다.

focusPolicyQt.ClickFocus 이 포함된 경우 activeFocustrue 이 됩니다.

버튼이 disabled 인 경우 이 함수는 아무 작업도 수행하지 않습니다.

버튼이 해제되기 전에 이 함수를 다시 호출하면 해제 타이머가 재설정됩니다.

이 메서드는 Qt 6.8에 도입되었습니다.

click(), pressed(), released() 및 clicked()도 참조하십시오 .


[since Qt 6.8] void click()

누르고 놓는 사이에 지연 없이 버튼을 클릭하는 것을 시뮬레이션합니다.

클릭과 관련된 모든 신호가 적절하게 방출됩니다.

focusPolicyQt.ClickFocus 이 포함된 경우 activeFocustrue 이 됩니다.

버튼이 disabled 인 경우 이 함수는 아무 작업도 수행하지 않습니다.

버튼이 해제되기 전에 이 함수를 다시 호출하면 해제 타이머가 재설정됩니다.

이 메서드는 Qt 6.8에 도입되었습니다.

animateClick(), pressed(), released() 및 clicked()도 참조하십시오 .


void toggle()

버튼의 체크 상태를 토글합니다.

click() 및 animateClick()도 참조하세요 .


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