Sur cette page

Qt3DInput::QMouseDevice Class

class Qt3DInput::QMouseDevice

Délègue les événements liés à la souris aux objets MouseHandler qui y sont attachés. Plus...

En-tête : #include <QMouseDevice>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3dinput)
target_link_libraries(mytarget PRIVATE Qt6::3dinput)
qmake : QT += 3dinput
En QML : MouseDevice
Hérite : Qt3DInput::QAbstractPhysicalDevice
Statut : Déclassé

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

Emplacements publics

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

Signaux

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

Description détaillée

Un QMouseDevice délègue les événements de souris du dispositif de souris physique aux objets 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 la souris.

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

Indique 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 à chaque fois qu'ils changent, qu'un bouton de la souris soit enfoncé ou non. Sinon, les axes sont mis à jour uniquement lorsque l'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 Notificateur :

void updateAxesContinuouslyChanged(bool updateAxesContinuously)

Fonction membre Documentation

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

Construit une nouvelle instance de QMouseDevice avec le parent parent.

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

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

Renvoie le nombre d'axes.

Note : Actuellement, la valeur retournée est toujours 4.

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

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

Convertit l'axe name en identifiant d'axe.

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

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

Renvoie les noms des axes.

Remarque : Actuellement, cette fonction renvoie toujours StringList["X", "Y"].

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

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

Renvoie le nombre de boutons.

Note : Actuellement, le nombre de boutons est toujours égal à 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'adresse name. Les valeurs de retour possibles sont documentées dans QMouseEvent::Buttons.

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

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

Renvoie les noms des boutons.

Remarque : Actuellement, cette fonction renvoie 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.