Auf dieser Seite

Qt3DInput::QMouseDevice Class

class Qt3DInput::QMouseDevice

Leitet Mausereignisse an die zugehörigen „ MouseHandler “-Objekte weiter. Mehr dazu...

Überschrift: #include <qmousedevice.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3dinput)
target_link_libraries(mytarget PRIVATE Qt6::3dinput)
qmake: QT += 3dinput
In QML: MouseDevice
Erbt von: Qt3DInput::QAbstractPhysicalDevice
Status: Veraltet

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Öffentliche Typen

enum Axis { X, Y, WheelX, WheelY }

Eigenschaften

Öffentliche Funktionen

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

Neu implementierte öffentliche Funktionen

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

Öffentliche Slots

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

Signale

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

Ausführliche Beschreibung

Ein `QMouseDevice` leitet Mausereignisse vom physischen Mausgerät an ` QMouseHandler `-Objekte weiter. Die Empfindlichkeit der Maus lässt sich über die Eigenschaft ` QMouseDevice::sensitivity ` steuern, die die Rate angibt, mit der sich die logischen Mauskoordinaten als Reaktion auf die physische Bewegung der Maus ändern.

Siehe auch „ QMouseHandler “.

Dokumentation zum Mitgliedstyp

enum QMouseDevice::Axis

Die Mausachse.

KonstanteWert
Qt3DInput::QMouseDevice::X0
Qt3DInput::QMouseDevice::Y1
Qt3DInput::QMouseDevice::WheelX2
Qt3DInput::QMouseDevice::WheelY3

Siehe auch Qt3DInput::QAnalogAxisInput::setAxis.

Eigenschaftsdokumentation

sensitivity : float

Speichert die Empfindlichkeit des Mausgeräts. Der Standardwert ist 0,1.

Zugriffsfunktionen:

float sensitivity() const
void setSensitivity(float value)

Benachrichtigungssignal:

void sensitivityChanged(float value)

updateAxesContinuously : bool

Wenn „ true “ gesetzt ist, werden die Achsen bei jeder Änderung aktualisiert, unabhängig davon, ob eine Maustaste gedrückt ist oder nicht. Andernfalls werden die Achsen nur aktualisiert, wenn eine der Maustasten gedrückt ist.

Der Standardwert ist „ false “.

Zugriffsfunktionen:

bool updateAxesContinuously() const
void setUpdateAxesContinuously(bool updateAxesContinuously)

Notifier-Signal:

void updateAxesContinuouslyChanged(bool updateAxesContinuously)

Dokumentation der Mitgliedsfunktionen

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

Erstellt eine neue QMouseDevice-Instanz mit dem übergeordneten Element „ parent “.

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

Implementiert neu: ` QAbstractPhysicalDevice::axisCount()` const.

Gibt die Anzahl der Achsen zurück.

Hinweis: Gibtderzeit immer 4 zurück.

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

Implementiert neu: ` QAbstractPhysicalDevice::axisIdentifier(const QString &name) const`.

Konvertiert die Achse „ name “ in einen Achsenbezeichner.

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

Implementiert neu: ` QAbstractPhysicalDevice::axisNames()` const.

Gibt die Namen der Achsen zurück.

Hinweis: Gibtderzeit immer `StringList["X", "Y"]` zurück.

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

Implementiert neu: ` QAbstractPhysicalDevice::buttonCount()` const.

Gibt die Anzahl der Schaltflächen zurück.

Hinweis: Gibtderzeit immer 3 zurück.

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

Implementiert: ` QAbstractPhysicalDevice::buttonIdentifier(const QString &name) const`.

Gibt die Schaltflächen-ID zurück, die dem angegebenen ` name` entspricht. Die möglichen Rückgabewerte sind unter QMouseEvent::Buttons dokumentiert.

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

Implementiert neu: ` QAbstractPhysicalDevice::buttonNames()` const.

Gibt die Namen der Schaltflächen zurück.

Hinweis: Gibtderzeit immer StringList["Links", "Rechts", "Mitte"] zurück.

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