QAbstractButton Class

Documentation sur les fonctions membres

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

Construit un bouton abstrait avec parent.

[virtual noexcept] QAbstractButton::~QAbstractButton()

Détruit le bouton.

[slot] void QAbstractButton::animateClick()

Effectue un clic animé : le bouton est pressé immédiatement et relâché 100 ms plus tard.

Le fait de rappeler cette fonction avant que le bouton ne soit relâché réinitialise la minuterie de relâchement.

Tous les signaux associés à un clic sont émis comme il se doit.

Cette fonction ne fait rien si le bouton est disabled.

Voir aussi click().

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

Réimplémente : QWidget::changeEvent(QEvent *event).

[virtual protected] void QAbstractButton::checkStateSet()

Ce gestionnaire virtuel est appelé lorsque setChecked() est utilisé, à moins qu'il ne soit appelé à partir de nextCheckState(). Il permet aux sous-classes de réinitialiser l'état de leurs boutons intermédiaires.

Voir aussi nextCheckState().

[slot] void QAbstractButton::click()

Effectue un clic.

Tous les signaux habituels associés à un clic sont émis comme il se doit. Si le bouton est contrôlable, son état est modifié.

Cette fonction ne fait rien si le bouton est disabled.

Voir aussi animateClick().

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

Ce signal est émis lorsque le bouton est activé (c'est-à-dire lorsqu'il est enfoncé puis relâché alors que le curseur de la souris se trouve à l'intérieur du bouton), lorsque la touche de raccourci est tapée ou lorsque click() ou animateClick() est appelé. Notamment, ce signal n'est pas émis si vous appelez setDown(), setChecked() ou toggle().

Si le bouton est vérifiable, checked est vrai si le bouton est vérifié, ou faux si le bouton n'est pas vérifié.

Voir aussi pressed(), released() et toggled().

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

Réimplémente : QWidget::event(QEvent *event).

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

Réimplémente : QWidget::focusInEvent(QFocusEvent *event).

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

Réimplémente : QWidget::focusOutEvent(QFocusEvent *event).

QButtonGroup *QAbstractButton::group() const

Renvoie le groupe auquel appartient ce bouton.

Si le bouton n'est membre d'aucun groupe QButtonGroup, cette fonction renvoie nullptr.

Voir également QButtonGroup.

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

Renvoie true si pos se trouve à l'intérieur du rectangle du bouton cliquable ; sinon, renvoie false.

Par défaut, la zone cliquable est l'ensemble du widget. Les sous-classes peuvent réimplémenter cette fonction pour prendre en charge des zones cliquables de formes et de tailles différentes.

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

Réimplémente : QWidget::keyPressEvent(QKeyEvent *event).

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

Réimplémente : QWidget::keyReleaseEvent(QKeyEvent *event).

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

Réimplémente : QWidget::mouseMoveEvent(QMouseEvent *event).

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

Réimplémente : QWidget::mousePressEvent(QMouseEvent *event).

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

Réimplémente : QWidget::mouseReleaseEvent(QMouseEvent *event).

[virtual protected] void QAbstractButton::nextCheckState()

Ce gestionnaire virtuel est appelé lorsqu'un bouton est cliqué. L'implémentation par défaut appelle setChecked( !isChecked()) si le bouton isCheckable(). Elle permet aux sous-classes d'implémenter des états intermédiaires du bouton.

Voir aussi checkStateSet().

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

Réimplémente : QWidget::paintEvent(QPaintEvent *event).

[signal] void QAbstractButton::pressed()

Ce signal est émis lorsque le bouton est enfoncé.

Voir aussi released() et clicked().

[signal] void QAbstractButton::released()

Ce signal est émis lorsque le bouton est relâché.

Voir aussi pressed(), clicked() et toggled().

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

Réimplémente : QObject::timerEvent(QTimerEvent *event).

[slot] void QAbstractButton::toggle()

Bascule l'état d'un bouton à cocher.

Voir aussi checked.

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

Ce signal est émis chaque fois qu'un bouton à cocher change d'état. checked est vrai si le bouton est coché, ou faux s'il est décoché.

Ce changement peut résulter d'une action de l'utilisateur, de l'activation de l'emplacement click() ou de l'appel à setChecked().

Les états des boutons dans les groupes de boutons exclusifs sont mis à jour avant que ce signal ne soit émis. Cela signifie que les slots peuvent agir soit sur le signal "off", soit sur le signal "on" émis par les boutons du groupe dont l'état a changé.

Par exemple, un slot qui réagit aux signaux émis par les boutons nouvellement cochés mais qui ignore les signaux émis par les boutons qui ont été décochés peut être mis en œuvre à l'aide du modèle suivant :

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

Des groupes de boutons peuvent être créés à l'aide de la classe QButtonGroup, et les mises à jour de l'état des boutons peuvent être surveillées à l'aide du signal QButtonGroup::buttonClicked().

Voir également checked et clicked().