Sur cette page

Qt3DInput::QMouseDevice Class

class Qt3DInput::QMouseDevice

Délègue les événements de souris aux objets ` MouseHandler ` associés. En savoir plus...

En-tête : #include <qmousedevice.h>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3dinput)
target_link_libraries(mytarget PRIVATE Qt6::3dinput)
qmake : QT += 3dinput
En QML : MouseDevice
Hérite de : Qt3DInput::QAbstractPhysicalDevice
Statut : Obsolète

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

Types publics

enum Axis { X, Y, WheelX, WheelY }

Propriétés

Fonctions publiques

QMouseDevice(Qt3DCore::QNode *parent = nullptr)
float sensitivity() const
bool updateAxesContinuously() const

Fonctions publiques réimplémentées

virtual int axisCount() const override
virtual int axisIdentifier(const QString &name) const override
virtual QStringList axisNames() const override
virtual int buttonCount() const override
virtual int buttonIdentifier(const QString &name) const override
virtual QStringList buttonNames() const override

Slots publics

void setSensitivity(float value)
void setUpdateAxesContinuously(bool updateAxesContinuously)

Signaux

void sensitivityChanged(float value)
void updateAxesContinuouslyChanged(bool updateAxesContinuously)

Description détaillée

Un objet QMouseDevice transmet les événements de souris provenant d’un périphérique physique vers des objets d’ QMouseHandler. La sensibilité de la souris peut être contrôlée à l’aide de la propriété QMouseDevice::sensitivity, qui spécifie la vitesse à laquelle les coordonnées logiques de la souris changent en réponse au mouvement physique de celle-ci.

Voir également QMouseHandler.

Documentation sur les types de membres

enum QMouseDevice::Axis

L'axe de la souris.

ConstanteValeur
Qt3DInput::QMouseDevice::X0
Qt3DInput::QMouseDevice::Y1
Qt3DInput::QMouseDevice::WheelX2
Qt3DInput::QMouseDevice::WheelY3

Voir aussi Qt3DInput::QAnalogAxisInput::setAxis.

Documentation sur les propriétés

sensitivity : float

Définit la sensibilité de la souris. La valeur par défaut est 0,1.

Fonctions d'accès :

float sensitivity() const
void setSensitivity(float value)

Signal de notification :

void sensitivityChanged(float value)

updateAxesContinuously : bool

Si true, les axes seront mis à jour dès qu'ils changent, que l'on appuie ou non sur un bouton de la souris. Sinon, les axes ne sont mis à jour que lorsqu'un des boutons de la souris est enfoncé.

La valeur par défaut est « false ».

Fonctions d'accès :

bool updateAxesContinuously() const
void setUpdateAxesContinuously(bool updateAxesContinuously)

Signal de notification :

void updateAxesContinuouslyChanged(bool updateAxesContinuously)

Documentation des fonctions membres

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

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

[override virtual] int QMouseDevice::axisCount() const

Réimplémente : ` QAbstractPhysicalDevice::axisCount()` const.

Renvoie le nombre d'axes.

Remarque : renvoieactuellement toujours 4.

[override virtual] int QMouseDevice::axisIdentifier(const QString &name) const

Réimplémente : ` QAbstractPhysicalDevice::axisIdentifier(const QString& name) const`.

Convertit l'name d'axe en identifiant d'axe.

[override virtual] QStringList QMouseDevice::axisNames() const

Réimplémentation de : QAbstractPhysicalDevice::axisNames() const.

Renvoie les noms des axes.

Remarque : renvoieactuellement toujours StringList["X", "Y"]

[override virtual] int QMouseDevice::buttonCount() const

Réimplémente : QAbstractPhysicalDevice::buttonCount() const.

Renvoie le nombre de boutons.

Remarque : renvoieactuellement toujours 3.

[override virtual] int QMouseDevice::buttonIdentifier(const QString &name) const

Réimplémente : QAbstractPhysicalDevice::buttonIdentifier(const QString &name) const.

Renvoie l'identifiant du bouton correspondant à l'name spécifié. Les valeurs de retour possibles sont documentées à l'adresse QMouseEvent::Buttons.

[override virtual] QStringList QMouseDevice::buttonNames() const

Réimplémente : QAbstractPhysicalDevice::buttonNames() const.

Renvoie les noms des boutons.

Remarque : renvoieactuellement toujours StringList["Left", "Right", "Center"]

© 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.