QAbstractButton Class

멤버 함수 설명서

[explicit] QAbstractButton::QAbstractButton(QWidget *parent = nullptr)

parent 를 가진 추상 버튼을 생성합니다.

[virtual noexcept] QAbstractButton::~QAbstractButton()

버튼을 파괴합니다.

[slot] void QAbstractButton::animateClick()

애니메이션 클릭을 수행합니다: 버튼을 즉시 눌렀다가 100ms 후에 놓습니다.

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

클릭과 관련된 모든 신호가 적절하게 발생합니다.

버튼이 disabled.

click()도 참조하십시오 .

[override virtual protected] void QAbstractButton::changeEvent(QEvent *e)

QWidget::changeEvent(QEvent *event)를 재구현합니다.

[virtual protected] void QAbstractButton::checkStateSet()

이 가상 핸들러는 setChecked()이 호출될 때, nextCheckState() 내부에서 호출된 경우는 제외하고 호출됩니다. 이를 통해 하위 클래스는 중간 버튼 상태를 재설정할 수 있습니다.

nextCheckState()도 참조하십시오 .

[slot] void QAbstractButton::click()

클릭을 수행합니다.

클릭과 관련된 모든 일반적인 신호가 적절하게 발생합니다. 버튼이 선택 가능한 경우, 버튼의 상태가 전환됩니다.

버튼이 disabled.

animateClick()함수도 참조하십시오 .

[signal] void QAbstractButton::clicked(bool checked = false)

이 신호는 버튼이 활성화될 때(즉, 마우스 커서가 버튼 내부에 있는 상태에서 버튼을 눌렀다가 놓았을 때), 단축키를 입력했을 때, 또는 ` click()` 또는 ` animateClick()`이 호출될 때 발생합니다. 특히, ` setDown()`, ` setChecked()` 또는 ` toggle()`을 호출할 경우에는 이 신호가 발생하지 않습니다.

버튼이 체크 가능한 경우, checked 는 버튼이 선택되어 있으면 true이고, 선택되어 있지 않으면 false입니다.

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

[override virtual protected] bool QAbstractButton::event(QEvent *e)

QWidget::event(QEvent *event)을 재구현합니다.

[override virtual protected] void QAbstractButton::focusInEvent(QFocusEvent *e)

QWidget::focusInEvent(QFocusEvent *event)를 재구현합니다.

[override virtual protected] void QAbstractButton::focusOutEvent(QFocusEvent *e)

QWidget::focusOutEvent(QFocusEvent *event)를 재구현합니다.

QButtonGroup *QAbstractButton::group() const

이 버튼이 속한 그룹을 반환합니다.

해당 버튼이 어떤 ' QButtonGroup'에도 속해 있지 않은 경우, 이 함수는 ' nullptr'를 반환합니다.

QButtonGroup도 참조하십시오 .

[virtual protected] bool QAbstractButton::hitButton(const QPoint &pos) const

pos 가 클릭 가능한 버튼 사각형 내에 있으면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.

기본적으로 클릭 가능한 영역은 위젯 전체입니다. 하위 클래스는 이 함수를 재구현하여 다양한 모양과 크기의 클릭 가능한 영역을 지원할 수 있습니다.

[override virtual protected] void QAbstractButton::keyPressEvent(QKeyEvent *e)

QWidget::keyPressEvent(QKeyEvent *event)를 재구현합니다.

[override virtual protected] void QAbstractButton::keyReleaseEvent(QKeyEvent *e)

QWidget::keyReleaseEvent(QKeyEvent *event)를 재구현합니다.

[override virtual protected] void QAbstractButton::mouseMoveEvent(QMouseEvent *e)

QWidget::mouseMoveEvent(QMouseEvent *event)를 재구현합니다.

[override virtual protected] void QAbstractButton::mousePressEvent(QMouseEvent *e)

QWidget::mousePressEvent(QMouseEvent *event)를 재구현합니다.

[override virtual protected] void QAbstractButton::mouseReleaseEvent(QMouseEvent *e)

QWidget::mouseReleaseEvent(QMouseEvent *event)를 재구현합니다.

[virtual protected] void QAbstractButton::nextCheckState()

이 가상 핸들러는 버튼이 클릭될 때 호출됩니다. 버튼이 isCheckable() 상태일 경우, 기본 구현은 setChecked(!isChecked())를 호출합니다. 이를 통해 하위 클래스에서 버튼의 중간 상태를 구현할 수 있습니다.

checkStateSet()도 참조하십시오 .

[override pure virtual protected] void QAbstractButton::paintEvent(QPaintEvent *e)

QWidget::paintEvent(QPaintEvent *event)를 재구현합니다.

[signal] void QAbstractButton::pressed()

이 신호는 버튼을 눌렀을 때 발생합니다.

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

[signal] void QAbstractButton::released()

이 신호는 버튼을 놓았을 때 발생합니다.

pressed(), clicked(), toggled()도 참조하십시오 .

[override virtual protected] void QAbstractButton::timerEvent(QTimerEvent *e)

QObject::timerEvent(QTimerEvent *event)를 재구현합니다.

[slot] void QAbstractButton::toggle()

체크 가능한 버튼의 상태를 전환합니다.

checked도 참조하십시오 .

[signal] void QAbstractButton::toggled(bool checked)

이 신호는 선택 가능한 버튼의 상태가 변경될 때마다 발생합니다. checked 는 버튼이 선택된 경우 true를, 선택 해제된 경우 false를 반환합니다.

이는 사용자 동작, ` click()` 슬롯 활성화, 또는 ` setChecked()` 호출의 결과일 수 있습니다.

배타적 버튼 그룹에 속한 버튼들의 상태는 이 신호가 발송되기 전에 업데이트됩니다. 즉, 슬롯은 상태가 변경된 그룹 내 버튼들이 발송하는 "off" 신호나 "on" 신호 중 하나에 반응할 수 있습니다.

예를 들어, 새로 선택된 버튼이 방출하는 신호에는 반응하지만 선택이 해제된 버튼의 신호는 무시하는 슬롯은 다음 패턴을 사용하여 구현할 수 있습니다:

void MyWidget::reactToToggle(bool checked)
{
   if (checked) {
      // Examine the new button states.
      ...
   }
}

버튼 그룹은 ` QButtonGroup ` 클래스를 사용하여 생성할 수 있으며, 버튼 상태의 업데이트는 ` QButtonGroup::buttonClicked()` 신호를 통해 모니터링할 수 있습니다.

checked 및 clicked()도 참조하십시오 .