Sur cette page

Qt3DInput::QMouseHandler Class

class Qt3DInput::QMouseHandler

Permet d'être averti des événements de souris lorsqu'il est associé à une instance de ` QMouseDevice `. En savoir plus...

En-tête : #include <Qt3DInput/QMouseHandler>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3dinput)
target_link_libraries(mytarget PRIVATE Qt6::3dinput)
qmake : QT += 3dinput
En QML : MouseHandler
Hérite de : Qt3DCore::QComponent
Statut : Obsolète

Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

Propriétés

Fonctions publiques

QMouseHandler(Qt3DCore::QNode *parent = nullptr)
bool containsMouse() const
Qt3DInput::QMouseDevice *sourceDevice() const

Emplacements publics

void setSourceDevice(Qt3DInput::QMouseDevice *mouseDevice)

Signaux

void clicked(Qt3DInput::QMouseEvent *mouse)
void containsMouseChanged(bool containsMouse)
void doubleClicked(Qt3DInput::QMouseEvent *mouse)
void entered()
void exited()
void positionChanged(Qt3DInput::QMouseEvent *mouse)
void pressAndHold(Qt3DInput::QMouseEvent *mouse)
void pressed(Qt3DInput::QMouseEvent *mouse)
void released(Qt3DInput::QMouseEvent *mouse)
void sourceDeviceChanged(Qt3DInput::QMouseDevice *mouseDevice)
void wheel(Qt3DInput::QWheelEvent *wheel)

Description détaillée

Remarque : les composantsQMouseHandler ne doivent pas être partagés ; le non-respect de cette condition entraînera très probablement des comportements indéfini.

Voir également QMouseDevice et QMouseEvent.

Documentation des propriétés

[read-only] containsMouse : bool

Renvoie une instance de ` true ` si l'QMouseHandler contient actuellement la souris.

Remarque : dans ce contexte, « contient » signifie que le rayon émis par la souris coupe l'entité Qt3DCore::QEntity qui agrège le composant d'instance QMouseHandler actuel.

Fonctions d'accès :

bool containsMouse() const

Signal de notification :

void containsMouseChanged(bool containsMouse)

sourceDevice : Qt3DInput::QMouseDevice*

Contient le périphérique source actuel de la souris de l'instance QMouseHandler.

Fonctions d'accès :

Qt3DInput::QMouseDevice *sourceDevice() const
void setSourceDevice(Qt3DInput::QMouseDevice *mouseDevice)

Signal de notification :

void sourceDeviceChanged(Qt3DInput::QMouseDevice *mouseDevice)

Documentation des fonctions membres

[explicit] QMouseHandler::QMouseHandler(Qt3DCore::QNode *parent = nullptr)

Crée une nouvelle instance de `QMouseHandler` dont le parent est ` parent`.

[signal] void QMouseHandler::clicked(Qt3DInput::QMouseEvent *mouse)

Ce signal est émis lorsqu'on clique sur un bouton de la souris ; les détails de l'événement sont contenus dans ` mouse`.

[signal] void QMouseHandler::doubleClicked(Qt3DInput::QMouseEvent *mouse)

Ce signal est émis lorsqu'on double-clique sur un bouton de la souris ; les détails de l'événement sont contenus dans ` mouse`.

[signal] void QMouseHandler::entered()

[signal] void QMouseHandler::exited()

[signal] void QMouseHandler::positionChanged(Qt3DInput::QMouseEvent *mouse)

Ce signal est émis lorsque la position de la souris change ; les détails de l'événement sont contenus dans mouse

[signal] void QMouseHandler::pressAndHold(Qt3DInput::QMouseEvent *mouse)

Ce signal est émis lorsqu'un bouton de la souris est enfoncé et maintenu enfoncé ; les détails de l'événement sont contenus dans mouse

[signal] void QMouseHandler::pressed(Qt3DInput::QMouseEvent *mouse)

Ce signal est émis lorsqu'un bouton de la souris est enfoncé ; les détails de l'événement sont contenus dans mouse

[signal] void QMouseHandler::released(Qt3DInput::QMouseEvent *mouse)

Ce signal est émis lorsqu'un bouton de la souris est relâché ; les détails de l'événement sont contenus dans mouse

[slot] void QMouseHandler::setSourceDevice(Qt3DInput::QMouseDevice *mouseDevice)

Définit le périphérique souris de l'instance QMouseHandler sur mouseDevice.

Remarque : fonctionde définition de la propriété sourceDevice.

Voir aussi sourceDevice().

[signal] void QMouseHandler::wheel(Qt3DInput::QWheelEvent *wheel)

Ce signal est émis lorsque la molette de la souris est utilisée ; les détails de l'événement sont contenus dans wheel

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.