Back to Qt.io
Contact Us Blog Download Qt
本页内容

Qt3DInput::QKeyboardHandler Class

class Qt3DInput::QKeyboardHandler

提供键盘事件通知。更多...

标题： #include <qkeyboardhandler.h>
CMake： find_package(Qt6 REQUIRED COMPONENTS 3dinput)
target_link_libraries(mytarget PRIVATE Qt6::3dinput)
qmake： QT += 3dinput
在 QML 中： KeyboardHandler
继承自： Qt3DCore::QComponent
状态： 已弃用

该类已弃用。我们强烈建议不要在新代码中使用它。

属性

公共函数

QKeyboardHandler(Qt3DCore::QNode *parent = nullptr)
bool focus() const
Qt3DInput::QKeyboardDevice *sourceDevice() const

公共槽位

void setFocus(bool focus)
void setSourceDevice(Qt3DInput::QKeyboardDevice *keyboardDevice)

信号

void asteriskPressed(Qt3DInput::QKeyEvent *event)
void backPressed(Qt3DInput::QKeyEvent *event)
void backtabPressed(Qt3DInput::QKeyEvent *event)
void callPressed(Qt3DInput::QKeyEvent *event)
void cancelPressed(Qt3DInput::QKeyEvent *event)
void context1Pressed(Qt3DInput::QKeyEvent *event)
void context2Pressed(Qt3DInput::QKeyEvent *event)
void context3Pressed(Qt3DInput::QKeyEvent *event)
void context4Pressed(Qt3DInput::QKeyEvent *event)
void deletePressed(Qt3DInput::QKeyEvent *event)
void digit0Pressed(Qt3DInput::QKeyEvent *event)
void digit1Pressed(Qt3DInput::QKeyEvent *event)
void digit2Pressed(Qt3DInput::QKeyEvent *event)
void digit3Pressed(Qt3DInput::QKeyEvent *event)
void digit4Pressed(Qt3DInput::QKeyEvent *event)
void digit5Pressed(Qt3DInput::QKeyEvent *event)
void digit6Pressed(Qt3DInput::QKeyEvent *event)
void digit7Pressed(Qt3DInput::QKeyEvent *event)
void digit8Pressed(Qt3DInput::QKeyEvent *event)
void digit9Pressed(Qt3DInput::QKeyEvent *event)
void downPressed(Qt3DInput::QKeyEvent *event)
void enterPressed(Qt3DInput::QKeyEvent *event)
void escapePressed(Qt3DInput::QKeyEvent *event)
void flipPressed(Qt3DInput::QKeyEvent *event)
void focusChanged(bool focus)
void hangupPressed(Qt3DInput::QKeyEvent *event)
void leftPressed(Qt3DInput::QKeyEvent *event)
void menuPressed(Qt3DInput::QKeyEvent *event)
void noPressed(Qt3DInput::QKeyEvent *event)
void numberSignPressed(Qt3DInput::QKeyEvent *event)
void pressed(Qt3DInput::QKeyEvent *event)
void released(Qt3DInput::QKeyEvent *event)
void returnPressed(Qt3DInput::QKeyEvent *event)
void rightPressed(Qt3DInput::QKeyEvent *event)
void selectPressed(Qt3DInput::QKeyEvent *event)
void sourceDeviceChanged(Qt3DInput::QKeyboardDevice *keyboardDevice)
void spacePressed(Qt3DInput::QKeyEvent *event)
void tabPressed(Qt3DInput::QKeyEvent *event)
void upPressed(Qt3DInput::QKeyEvent *event)
void volumeDownPressed(Qt3DInput::QKeyEvent *event)
void volumeUpPressed(Qt3DInput::QKeyEvent *event)
void yesPressed(Qt3DInput::QKeyEvent *event)

详细说明

属性文档

focus : bool

如果 QKeyboardHandlers 拥有焦点，则持有true 。

访问函数：

bool focus() const
void setFocus(bool focus)

通知信号：

void focusChanged(bool focus)

sourceDevice : Qt3DInput::QKeyboardDevice*

持有QKeyboardHandler 的键盘设备。如果没有有效的设备，QKeyboardHandler 将无法接收任何事件。

访问函数：

Qt3DInput::QKeyboardDevice *sourceDevice() const
void setSourceDevice(Qt3DInput::QKeyboardDevice *keyboardDevice)

通知信号：

void sourceDeviceChanged(Qt3DInput::QKeyboardDevice *keyboardDevice)

成员函数文档

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

创建一个新的 QKeyboardHandler 实例，其父对象为parent 。

[signal] void QKeyboardHandler::asteriskPressed(Qt3DInput::QKeyEvent *event)

按下 * 键时会触发此信号，相关事件详情包含在 `event` 中。

[signal] void QKeyboardHandler::backPressed(Qt3DInput::QKeyEvent *event)

按下“返回”键时会发出此信号，事件详情包含在event 中。

[signal] void QKeyboardHandler::backtabPressed(Qt3DInput::QKeyEvent *event)

当按下后退键时会发出此信号，事件详细信息包含在event 中。

[signal] void QKeyboardHandler::callPressed(Qt3DInput::QKeyEvent *event)

按下呼叫键时会发出此信号，事件详情包含在event 中。

[signal] void QKeyboardHandler::cancelPressed(Qt3DInput::QKeyEvent *event)

按下“取消”键时会发出此信号，事件详细信息包含在event 中。

[signal] void QKeyboardHandler::context1Pressed(Qt3DInput::QKeyEvent *event)

当按下上下文键 1 时，会发出此信号，事件详细信息包含在 `event` 中。

[signal] void QKeyboardHandler::context2Pressed(Qt3DInput::QKeyEvent *event)

当按下上下文键 2 时，会发出此信号，事件详细信息包含在 `event` 中。

[signal] void QKeyboardHandler::context3Pressed(Qt3DInput::QKeyEvent *event)

当按下上下文键 2 时，会发出此信号，事件详细信息包含在 `event` 中。

[signal] void QKeyboardHandler::context4Pressed(Qt3DInput::QKeyEvent *event)

当按下“上下文 4”键时会发出此信号，事件详细信息包含在event 中。

[signal] void QKeyboardHandler::deletePressed(Qt3DInput::QKeyEvent *event)

按下删除键时会触发此信号，事件详情包含在event 中。

[signal] void QKeyboardHandler::digit0Pressed(Qt3DInput::QKeyEvent *event)

按下 0 键时会发出此信号，事件详情包含在 `event` 中。

[signal] void QKeyboardHandler::digit1Pressed(Qt3DInput::QKeyEvent *event)

按下 1 键时会发出此信号，事件详情包含在event 中。

[signal] void QKeyboardHandler::digit2Pressed(Qt3DInput::QKeyEvent *event)

按下 2 键时会发出此信号，事件详情包含在 `event` 中。

[signal] void QKeyboardHandler::digit3Pressed(Qt3DInput::QKeyEvent *event)

按下 3 键时会发出此信号，事件详情包含在 `event` 中。

[signal] void QKeyboardHandler::digit4Pressed(Qt3DInput::QKeyEvent *event)

按下 4 键时会发出此信号，事件详细信息包含在 `event` 中。

[signal] void QKeyboardHandler::digit5Pressed(Qt3DInput::QKeyEvent *event)

按下 5 键时会发出此信号，事件详细信息包含在 `event` 中。

[signal] void QKeyboardHandler::digit6Pressed(Qt3DInput::QKeyEvent *event)

按下 6 键时会发出此信号，事件详情包含在 `event` 中。

[signal] void QKeyboardHandler::digit7Pressed(Qt3DInput::QKeyEvent *event)

按下 7 键时会触发此信号，事件详情包含在 `event` 中。

[signal] void QKeyboardHandler::digit8Pressed(Qt3DInput::QKeyEvent *event)

按下 8 键时会发出此信号，事件详细信息包含在 `event` 中。

[signal] void QKeyboardHandler::digit9Pressed(Qt3DInput::QKeyEvent *event)

按下 9 键时会发出此信号，事件详情包含在event

[signal] void QKeyboardHandler::downPressed(Qt3DInput::QKeyEvent *event)

按下向下键时会发出此信号，事件详情包含在event 中。

[signal] void QKeyboardHandler::enterPressed(Qt3DInput::QKeyEvent *event)

按下回车键时会触发此信号，事件详情包含在event 中。

[signal] void QKeyboardHandler::escapePressed(Qt3DInput::QKeyEvent *event)

按下Esc键时会发出此信号，事件详细信息包含在event 中。

[signal] void QKeyboardHandler::flipPressed(Qt3DInput::QKeyEvent *event)

按下翻页键时会发出此信号，事件详情包含在event 中。

[signal] void QKeyboardHandler::hangupPressed(Qt3DInput::QKeyEvent *event)

按下挂断键时会发出此信号，事件详细信息包含在event 中。

[signal] void QKeyboardHandler::leftPressed(Qt3DInput::QKeyEvent *event)

按下左键时会发出此信号，事件详细信息包含在event 中。

按下菜单键时会发出此信号，事件详情包含在event 中。

[signal] void QKeyboardHandler::noPressed(Qt3DInput::QKeyEvent *event)

按下“是”键时会发出此信号，事件详情包含在event 中。

[signal] void QKeyboardHandler::numberSignPressed(Qt3DInput::QKeyEvent *event)

按下井号键时会发出此信号，事件详情包含在event 中。

[signal] void QKeyboardHandler::pressed(Qt3DInput::QKeyEvent *event)

当按下某个键时会发出此信号，事件详情包含在event 中。

[signal] void QKeyboardHandler::released(Qt3DInput::QKeyEvent *event)

当按键被释放时会发出此信号，事件详细信息包含在event 中。

[signal] void QKeyboardHandler::returnPressed(Qt3DInput::QKeyEvent *event)

按下回车键时会发出此信号，事件详细信息包含在event 中。

[signal] void QKeyboardHandler::rightPressed(Qt3DInput::QKeyEvent *event)

当按下右键时会发出此信号，事件详细信息包含在event 中。

[signal] void QKeyboardHandler::selectPressed(Qt3DInput::QKeyEvent *event)

按下“选择”键时会触发此信号，事件详细信息包含在event 中。

[slot] void QKeyboardHandler::setFocus(bool focus)

将焦点设置为focus 。如果当前焦点未设置为true ，则该组件将获得键盘焦点。

注意： 这是属性focus 的设置 函数。

另请参阅 focus()。

Qt3DInput::QKeyboardDevice *QKeyboardHandler::sourceDevice() const

返回当前的键盘设备。

注意： 这是 sourceDevice 属性的获取 函数。

另请参阅 ` setSourceDevice()`。

[signal] void QKeyboardHandler::spacePressed(Qt3DInput::QKeyEvent *event)

按下空格键时会发出此信号，事件详情包含在event 中。

[signal] void QKeyboardHandler::tabPressed(Qt3DInput::QKeyEvent *event)

按下 Tab 键时会发出此信号，事件详情包含在 `event` 中。

[signal] void QKeyboardHandler::upPressed(Qt3DInput::QKeyEvent *event)

按下向上键时会发出此信号，事件详情包含在event 中。

[signal] void QKeyboardHandler::volumeDownPressed(Qt3DInput::QKeyEvent *event)

按下音量减键时会发出此信号，事件详情包含在event 中。

[signal] void QKeyboardHandler::volumeUpPressed(Qt3DInput::QKeyEvent *event)

按下音量增大键时会发出此信号，事件详情包含在event 中。

[signal] void QKeyboardHandler::yesPressed(Qt3DInput::QKeyEvent *event)

按下“是”键时会发出此信号，事件详情包含在event 中。

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