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())

Crée un objet d'événement « wheel ».

La propriété ` pos ` indique la position du curseur de la souris dans la fenêtre. La position en coordonnées globales est spécifiée par la propriété ` globalPos`.

pixelDelta contient la distance de défilement en pixels à l'écran, tandis que ` angleDelta ` contient l'angle de rotation de la molette. ` 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 réel 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 sous macOS), inverted doit être true. Sinon, inverted est false

Le périphérique à l’origine de l’événement de molette est spécifié par ` device`.

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

[protected delete] QWheelEvent::QWheelEvent(QWheelEvent &&)

Crée par « move » une instance de ` QWheelEvent`. Cette fonction est supprimée.

QPoint QWheelEvent::angleDelta() const

Renvoie l'angle de rotation relatif de la molette, exprimé en huitièmes de degré. Une valeur positive indique que la molette a été tournée vers l'avant, en s'éloignant de l'utilisateur ; une valeur négative indique qu'elle a été tournée vers l'arrière, en se rapprochant de l'utilisateur. angleDelta().y() fournit l'angle de rotation de la molette verticale standard depuis l'événement précédent. angleDelta().x() fournit l'angle de rotation de la molette horizontale, si la souris en est équipée ; sinon, elle reste à 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 paliers de 15 degrés ; dans ce cas, la valeur delta est un multiple de 120 ; c'est-à-dire 120 unités * 1/8 = 15 degrés.

Cependant, certaines souris disposent de molettes à 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 de manière cumulative 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 molette. Mais pour offrir une expérience plus naturelle, privilégiez la méthode pixelDelta() sur les plateformes où elle 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 que la distance n’a pas encore changé (Qt::ScrollBegin),
• ou lorsque le défilement est terminé et que la distance n’a plus évolué (Qt::ScrollEnd).

Voir également pixelDelta().

bool QWheelEvent::inverted() const

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

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

Cependant, sur certaines plateformes, ce comportement est configurable, de sorte que les mêmes opérations décrites ci-dessus produiront des valeurs delta négatives (mais de même amplitude). Grâce à la propriété « inverted », un consommateur d’événements de molette peut choisir de toujours suivre la direction de la molette, quels que soient les paramètres système, mais uniquement pour des widgets spécifiques. (Un cas d’utilisation possible serait que l’utilisateur fasse tourner la molette dans le même sens que la rotation d’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 la méthode phase() de cet événement est Qt::ScrollBegin.

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

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

Renvoie ` true ` si la méthode ` phase()` de cet événement est ` Qt::ScrollEnd`.

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

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

Renvoie true si la méthode phase() de cet événement est Qt::ScrollUpdate ou Qt::ScrollMomentum.

Qt::ScrollPhase QWheelEvent::phase() const

Renvoie la phase de défilement associée à cet événement de molette.

QPoint QWheelEvent::pixelDelta() const

Renvoie la distance de défilement en pixels à l'écran. Cette valeur est fournie sur les plateformes prenant en charge les valeurs delta en pixels à haute résolution, telles que macOS. Elle 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 que la distance n'a pas encore changé (Qt::ScrollBegin),
• ou lorsque le défilement est terminé et que la distance n’a plus changé (Qt::ScrollEnd).

[protected delete] QWheelEvent &QWheelEvent::operator=(QWheelEvent &&)

La commande « Move » attribue la classe « other » à cette instance « QWheelEvent ». Cette fonction est supprimée.

[noexcept protected default] QWheelEvent &QWheelEvent::operator=(const QWheelEvent &other)

Attribue par copie l'other à cette instance d'QWheelEvent.