Back to Qt.io
Contact Us Blog Download Qt

Qt3DInput::QKeyboardHandler Class

class Qt3DInput::QKeyboardHandler

提供键盘事件通知。更多

头文件： #include <QKeyboardHandler>
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)

Notifier 信号：

void focusChanged(bool focus)

sourceDevice : Qt3DInput::QKeyboardDevice*

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

访问功能：

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

Notifier 信号：

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)

按下 backtab 键时发出该信号，事件详情包含在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)

按下转义键时会发出该信号，事件详情包含在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)

按下制表符键时发出该信号，事件详情包含在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 中。

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