AbstractButton QML Type

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

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• 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)
• 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()

상세 설명

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

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

속성 문서

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

이 프로퍼티는 버튼 액션을 저장합니다.

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

Action 를참조하십시오 .

autoExclusive : bool

이 속성은 자동 독점 사용 여부를 보유합니다.

자동 독점 기능이 활성화된 경우 동일한 상위 항목에 속한 체크 표시된 버튼은 동일한 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 이 표시되는 방식을 결정합니다.

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

spacing 및 padding 을참조하십시오 .

down : bool

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

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

pressed 를참조하세요 .

icon group

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

text, display, 및 Qt Quick Controls 의 아이콘을참조하십시오 .

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 를참조하세요 .

신호 문서

canceled()

이 신호는 버튼을 누르고 있는 동안 마우스 그랩이 끊어지거나 released 신호가 발생하지만 마우스 커서가 버튼 안에 있지 않을 때 발생합니다.

clicked()

이 신호는 사용자가 터치, 마우스 또는 키보드를 통해 버튼을 대화형으로 클릭할 때 발생합니다.

click(), animateClick() 및 버튼이 클릭될 때 QML에서 C++ 함수를 호출하는방법도 참조하세요 .

doubleClicked()

이 신호는 사용자가 터치 또는 마우스를 통해 버튼을 대화형으로 두 번 클릭할 때 발생합니다.

pressAndHold()

이 신호는 사용자가 터치 또는 마우스를 통해 버튼을 대화형으로 누르고 있을 때 방출됩니다. autoRepeat 이 활성화된 경우에는 발생하지 않습니다.

pressed()

이 신호는 사용자가 터치, 마우스 또는 키보드를 통해 버튼을 대화형으로 누를 때 발생합니다.

released()

이 신호는 사용자가 터치, 마우스 또는 키보드를 통해 대화형으로 버튼을 놓을 때 발생합니다.

[since QtQuick.Controls 2.2 (Qt 5.9)] toggled()

이 신호는 사용자가 터치, 마우스 또는 키보드를 통해 확인 가능한 버튼을 대화형으로 토글할 때 발생합니다.

이 신호는 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()도 참조하세요 .