QKeyEvent Class

成员函数文档

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 。

Intkey 是事件循环应监听的Qt::Key 的代码。如果key 为 0，则事件不是已知按键的结果；例如，可能是编译序列或键盘宏的结果。modifiers 保存键盘修饰符，给定的text 是按键产生的 Unicode 文本。如果autorep 为真，则isAutoRepeat() 为真。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 。

Intkey 是事件循环应监听的Qt::Key 的代码。如果key 为 0，则事件不是已知按键的结果；例如，可能是编译序列或键盘宏的结果。modifiers 保存键盘修饰符，给定的text 是按键产生的 Unicode 文本。如果autorep 为真，则isAutoRepeat() 为真。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 。