Back to Qt.io
Contact Us Blog Download Qt
Auf dieser Seite

Qt3DInput::QMouseHandler Class

class Qt3DInput::QMouseHandler

Bietet die Möglichkeit, über Mausereignisse benachrichtigt zu werden, wenn die Komponente an eine „ QMouseDevice “-Instanz angehängt ist. Mehr...

Header: #include <Qt3DInput/QMouseHandler>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3dinput)
target_link_libraries(mytarget PRIVATE Qt6::3dinput)
qmake: QT += 3dinput
In QML: MouseHandler
Erbt von: Qt3DCore::QComponent
Status: Veraltet

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

Eigenschaften

Öffentliche Funktionen

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

Öffentliche Slots

void setSourceDevice(Qt3DInput::QMouseDevice *mouseDevice)

Signale

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)

Detaillierte Beschreibung

Hinweis: QMouseHandler-Komponenten sollten nicht gemeinsam genutzt werden; die Nichtbeachtung dieser Bedingung führt höchstwahrscheinlich zu undefiniertem Verhalten.

Siehe auch QMouseDevice und QMouseEvent.

Dokumentation zu den Eigenschaften

[read-only] containsMouse : bool

Enthält „ true “, wenn die „ QMouseHandler “ derzeit die Maus enthält.

Hinweis: In diesem Zusammenhang bedeutet „enthält“, dass sich der von der Maus ausgehende Strahl mit dem Qt3DCore::QEntity schneidet, das die aktuelle Instanzkomponente von QMouseHandler aggregiert.

Zugriffsfunktionen:

bool containsMouse() const

Notifier-Signal:

void containsMouseChanged(bool containsMouse)

sourceDevice : Qt3DInput::QMouseDevice*

Enthält das aktuell als Mausquelle verwendete Gerät der Instanz „ QMouseHandler “.

Zugriffsfunktionen:

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

Notifier-Signal:

void sourceDeviceChanged(Qt3DInput::QMouseDevice *mouseDevice)

Dokumentation der Mitgliedsfunktionen

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

Erstellt eine neue QMouseHandler-Instanz mit dem übergeordneten Objekt „ parent “.

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

Dieses Signal wird ausgelöst, wenn eine Maustaste angeklickt wird; die Details zum Ereignis sind in „ mouse “ enthalten.

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

Dieses Signal wird ausgelöst, wenn ein Maus-Doppelklick erfolgt; die Ereignisdetails sind in „ mouse “ enthalten.

[signal] void QMouseHandler::entered()

[signal] void QMouseHandler::exited()

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

Dieses Signal wird ausgelöst, wenn sich die Mausposition ändert; die Ereignisdetails sind darin enthalten mouse

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

Dieses Signal wird ausgelöst, wenn eine Maustaste gedrückt und gehalten wird; die Ereignisdetails sind darin enthalten mouse

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

Dieses Signal wird ausgelöst, wenn eine Maustaste gedrückt wird; die Details des Ereignisses sind darin enthalten mouse

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

Dieses Signal wird ausgelöst, wenn eine Maustaste losgelassen wird; die Ereignisdetails sind darin enthalten mouse

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

Setzt das Mausgerät der Instanz „ QMouseHandler “ auf „ mouseDevice “.

Hinweis: Setter -Funktion für die Eigenschaft „ sourceDevice “.

Siehe auch sourceDevice().

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

Dieses Signal wird ausgelöst, wenn das Mausrad betätigt wird; die Details zum Ereignis sind in 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.