QWheelEvent Class

Documentation des fonctions membres

QWheelEvent::QWheelEvent(const QPointF &pos, const QPointF &globalPos, QPoint pixelDelta, QPoint angleDelta, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, Qt::ScrollPhase phase, bool inverted, Qt::MouseEventSource source = Qt::MouseEventNotSynthesized, const QPointingDevice *device = QPointingDevice::primaryPointingDevice())

Construit un objet d'événement de roue.

Le site pos indique l'emplacement du curseur de la souris dans la fenêtre. La position en coordonnées globales est spécifiée par globalPos.

pixelDelta contient la distance de défilement en pixels à l'écran, tandis que angleDelta contient l'angle de rotation de la roue. pixelDelta est facultatif et peut être nul.

Les états de la souris et du clavier au moment de l'événement sont spécifiés par buttons et modifiers.

La phase de défilement de l'événement est spécifiée par phase, et source indique s'il s'agit d'un événement authentique ou artificiel (synthétisé).

Si le système est configuré pour inverser les valeurs delta fournies avec l'événement (comme le défilement naturel du pavé tactile sur macOS), inverted doit être true. Sinon, inverted est false

Le dispositif à l'origine de l'événement de la roue est spécifié par device.

Voir également position(), globalPosition(), angleDelta(), pixelDelta(), phase(), inverted() et device().

QPoint QWheelEvent::angleDelta() const

Renvoie la valeur relative de la rotation de la molette, en huitièmes de degré. Une valeur positive indique que la roue a été tournée vers l'avant en s'éloignant de l'utilisateur ; une valeur négative indique que la roue a été tournée vers l'arrière en se rapprochant de l'utilisateur. angleDelta().y() indique l'angle de rotation de la roue verticale commune de la souris depuis l'événement précédent. angleDelta().x() indique l'angle de rotation de la roue horizontale de la souris, si la souris est dotée d'une roue horizontale ; dans le cas contraire, la valeur reste égale à zéro. Certaines souris permettent à l'utilisateur d'incliner la molette pour effectuer un défilement horizontal, et certains pavés tactiles prennent en charge un geste de défilement horizontal ; cela apparaîtra également dans angleDelta().x().

La plupart des souris fonctionnent par pas de 15 degrés, auquel cas la valeur du delta est un multiple de 120, c'est-à-dire 120 unités * 1/8 = 15 degrés.

Cependant, certaines souris ont des roues à résolution plus fine et envoient des valeurs delta inférieures à 120 unités (moins de 15 degrés). Pour prendre en charge cette possibilité, vous pouvez soit additionner les valeurs delta des événements jusqu'à ce que la valeur de 120 soit atteinte, puis faire défiler le widget, soit faire défiler partiellement le widget en réponse à chaque événement de roue. Mais pour obtenir une sensation plus native, vous devriez préférer pixelDelta() sur les plates-formes où il est disponible.

Exemple :

void MyWidget::wheelEvent(QWheelEvent *event)
{
    QPoint numPixels = event->pixelDelta();
    QPoint numDegrees = event->angleDelta() / 8;

    if (!numPixels.isNull()) {
        scrollWithPixels(numPixels);
    } else if (!numDegrees.isNull()) {
        QPoint numSteps = numDegrees / 15;
        scrollWithDegrees(numSteps);
    }

    event->accept();
}

• le défilement est sur le point de commencer, mais la distance n'a pas encore changé (Qt::ScrollBegin),
• ou que le défilement est terminé et que la distance n'a pas changé (Qt::ScrollEnd).

Voir également pixelDelta().

bool QWheelEvent::inverted() const

Indique si les valeurs delta fournies avec l'événement sont inversées.

Normalement, une roue verticale produira un QWheelEvent avec des valeurs delta positives si le haut de la roue tourne à l'opposé de la main qui l'actionne. De même, un mouvement horizontal de la roue produira un QWheelEvent avec des valeurs delta positives si le haut de la roue est déplacé vers la gauche.

Toutefois, sur certaines plateformes, cette propriété est configurable, de sorte que les mêmes opérations décrites ci-dessus produiront des valeurs delta négatives (mais avec la même ampleur). Avec la propriété inversée, un consommateur d'événements de roue peut choisir de toujours suivre la direction de la roue, quels que soient les paramètres du système, mais seulement pour des widgets spécifiques. (Un tel cas d'utilisation pourrait être que l'utilisateur fasse tourner la roue dans le même sens qu'un Tumbler visuel. Un autre cas d'utilisation consiste à faire en sorte que la poignée d'un curseur suive la direction du mouvement des doigts sur un pavé tactile, quelle que soit la configuration du système).

[override virtual] bool QWheelEvent::isBeginEvent() const

Réimplémente : QSinglePointEvent::isBeginEvent() const.

Renvoie true si l'événement phase() est Qt::ScrollBegin.

[override virtual] bool QWheelEvent::isEndEvent() const

Réimplémente : QSinglePointEvent::isEndEvent() const.

Renvoie true si l'événement phase() est Qt::ScrollEnd.

[override virtual] bool QWheelEvent::isUpdateEvent() const

Réimplémente : QSinglePointEvent::isUpdateEvent() const.

Renvoie true si l'événement phase() est Qt::ScrollUpdate ou Qt::ScrollMomentum.

Qt::ScrollPhase QWheelEvent::phase() const

Renvoie la phase de défilement de cet événement de roue.

QPoint QWheelEvent::pixelDelta() const

Renvoie la distance de défilement en pixels à l'écran. Cette valeur est fournie sur les plateformes qui prennent en charge les valeurs delta haute résolution basées sur les pixels, comme macOS. La valeur doit être utilisée directement pour faire défiler le contenu à l'écran.

Exemple :

void MyWidget::wheelEvent(QWheelEvent *event)
{
    QPoint numPixels = event->pixelDelta();
    QPoint numDegrees = event->angleDelta() / 8;

    if (!numPixels.isNull()) {
        scrollWithPixels(numPixels);
    } else if (!numDegrees.isNull()) {
        QPoint numSteps = numDegrees / 15;
        scrollWithDegrees(numSteps);
    }

    event->accept();
}

• le défilement est sur le point de commencer, mais la distance n'a pas encore changé (Qt::ScrollBegin),
• ou que le défilement est terminé et que la distance n'a pas changé (Qt::ScrollEnd).