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()も参照してください 。