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)

Notifier 신호:

void sourceDeviceChanged(Qt3DInput::QKeyboardDevice *keyboardDevice)

멤버 함수 설명서

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

parent 를 부모로 하는 새로운 QKeyboardHandler 인스턴스를 생성합니다.

[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)

이 신호는 Delete 키를 누를 때 발생하며, 이벤트 세부 정보는 ` 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)

이 신호는 Enter 키를 누를 때 발생하며, 이벤트 세부 정보는 ` 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)

이 신호는 ‘yes’ 키가 눌렸을 때 발생하며, 이벤트 세부 정보는 ` 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)

이 신호는 ‘yes’ 키가 눌렸을 때 발생하며, 이벤트 세부 정보는 ` 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.