QKeyEvent 类

成员函数文档

QKeyEvent::QKeyEvent(QEvent::Type type, int key, Qt::KeyboardModifiers modifiers, const QString &text = QString(), bool autorep = false, quint16 count = 1)

构建一个按键事件对象。

type 参数必须是 QEvent::KeyPress、QEvent::KeyRelease 或 QEvent::ShortcutOverride。

key 是事件循环应监听的 Qt::Key 代码。如果 key 为 0，事件不是已知按键的结果；例如，它可能是组合序列或键盘宏的结果。《i translate="no">modifiers 存储键盘修饰符，而给定的 text 是按键生成的 Unicode 文本。如果 autorep 为 true，isAutoRepeat() 将为 true。 count 是事件中涉及的字节数。

QKeyEvent::QKeyEvent(QEvent::Type type, int key, Qt::KeyboardModifiers modifiers, quint32 nativeScanCode, quint32 nativeVirtualKey, quint32 nativeModifiers, const QString &text = QString(), bool autorep = false, quint16 count = 1, const QInputDevice *device = QInputDevice::primaryKeyboard())

构建一个按键事件对象。

type 参数必须是 QEvent::KeyPress、QEvent::KeyRelease 或 QEvent::ShortcutOverride。

key 是事件循环应监听的 Qt::Key 代码。如果 key 为 0，事件不是已知按键的结果；例如，它可能是组合序列或键盘宏的结果。《i translate="no">modifiers 存储键盘修饰符，而给定的 text 是按键生成的 Unicode 文本。如果 autorep 为 true，isAutoRepeat() 将为 true。 count 是事件中涉及的字节数。

除了正常按键事件数据外，还包含 nativeScanCode、nativeVirtualKey 和 nativeModifiers。这些额外数据用于快捷键系统，以确定要触发的快捷键。

int QKeyEvent::count() const

返回此事件中涉及的字节数。如果 text() 不为空，则这是字符串的长度。

另请参阅 Qt::WA_KeyCompression。

bool QKeyEvent::isAutoRepeat() const

如果此事件来自自动复制的按键，则返回 true；如果它来自初始按键按下，则返回 false。

注意，如果事件是一个部分由自动重复导致的多个按键压缩事件，则此函数可能不确定地返回 true 或 false。

int QKeyEvent::key() const

返回被按下或释放的按键的代码。

查看Qt::Key以获取键盘码列表。这些码与底层窗口系统无关。请注意，此函数区分大小写，使用text()函数（返回按键生成的Unicode文本）来区分。

值为0或Qt::Key_unknown表示事件不是已知按键的结果；例如，它可能是组合序列、键盘宏的结果，或者由于按键事件压缩引起的。

另请参阅 Qt::WA_KeyCompression。

[since 6.0] QKeyCombination QKeyEvent::keyCombination() const

返回一个QKeyCombination对象，包含该事件携带的key()和modifiers()。

此函数在Qt 6.0版本中被引入。

bool QKeyEvent::matches(QKeySequence::StandardKey key) const

如果按键事件与给定的标准key匹配，则返回true，否则返回false。

Qt::KeyboardModifiers QKeyEvent::modifiers() const

返回事件发生后立即存在的键盘修饰符标志。

另请参阅：QGuiApplication::keyboardModifiers。

quint32 QKeyEvent::nativeModifiers() const

返回按键事件的本地修饰符。如果没有包含此数据，则返回0。

quint32 QKeyEvent::nativeScanCode() const

返回按键事件的本地扫描码。如果没有包含此数据，则返回0。

quint32 QKeyEvent::nativeVirtualKey() const

返回本地虚拟键，或按键事件的键符号。如果没有包含此数据，则返回0。

QString QKeyEvent::text() const

返回此按键生成的Unicode文本。

文本不仅限于可打印的Unicode代码点范围，还可以包括控制字符或其他Unicode类别中的字符，包括QChar::Other_PrivateUse。

文本也可能是空的，例如当按下Shift、Control、Alt和Meta等修饰键时（取决于平台）。key()函数将始终返回有效值。

另请参阅 Qt::WA_KeyCompression。