QAbstractButton Class

Documentation sur les fonctions membres

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

Crée un bouton abstrait avec une propriété « parent ».

[virtual noexcept] QAbstractButton::~QAbstractButton()

Supprime le bouton.

[slot] void QAbstractButton::animateClick()

Effectue un clic animé : le bouton est enfoncé immédiatement, puis relâché 100 ms plus tard.

Appeler à nouveau cette fonction avant que le bouton ne soit relâché réinitialise le temporisateur 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 également 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 la méthode setChecked() est utilisée, sauf si celle-ci est appelée depuis l'intérieur de la méthode nextCheckState(). Il permet aux sous-classes de réinitialiser les états intermédiaires de leurs boutons.

Voir également nextCheckState().

[slot] void QAbstractButton::click()

Simule un clic.

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

Cette fonction ne fait rien si le bouton est disabled.

Voir également ` animateClick()`.

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

Ce signal est émis lorsque le bouton est activé (c'est-à-dire lorsqu'on appuie dessus puis qu'on le relâche alors que le curseur de la souris se trouve à l'intérieur du bouton), lorsque la touche de raccourci est enfoncée, ou lorsque les fonctions ` click()` ou ` animateClick()` sont appelées. Il est à noter que ce signal n' est pas émis si vous appelez les fonctions ` setDown()`, ` setChecked()` ou ` toggle()`.

Si le bouton est cochable, checked est vrai si le bouton est coché, ou faux s’il ne l’est pas.

Voir également 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'appartient à 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 correspond à l’intégralité du widget. Les sous-classes peuvent réimplémenter cette fonction afin de 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'on clique sur un bouton. L'implémentation par défaut appelle setChecked(!isChecked()) si le bouton isCheckable(). Cela permet aux sous-classes d'implémenter des états intermédiaires pour les boutons.

Voir également 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 l'on appuie sur le bouton.

Voir également released() et clicked().

[signal] void QAbstractButton::released()

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

Voir également pressed(), clicked() et toggled().

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

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

[slot] void QAbstractButton::toggle()

Active ou désactive l'état d'un bouton à cocher.

Voir aussi checked.

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

Ce signal est émis chaque fois qu'un bouton cochable change d'état. ` checked ` est vrai si le bouton est coché, et faux s'il ne l'est pas.

Cela peut résulter d’une action de l’utilisateur, de l’activation d’un slot click() ou de l’appel de la fonction setChecked().

Les états des boutons appartenant à des groupes de boutons exclusifs sont mis à jour avant l’émission de ce signal. Cela signifie que les slots peuvent réagir soit au signal « off », soit au signal « on » émis par les boutons du groupe dont les états ont changé.

Par exemple, un slot qui réagit aux signaux émis par les boutons nouvellement cochés mais qui ignore les signaux provenant des boutons qui ont été décochés peut être implémenté à l’aide du modèle suivant :

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

Les groupes de boutons peuvent être créés à l’aide de la classe ` QButtonGroup `, et les mises à jour des états des boutons sont surveillées via le signal ` QButtonGroup::buttonClicked()`.

Voir également checked et clicked().