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

このイベントが伝えるkey() とmodifiers() の両方を含むQKeyCombination オブジェクトを返します。

この関数は 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 コードポイントの印刷可能範囲に限定されず、制御文字や、QChar::Other_PrivateUse を含む他の Unicode カテゴリからの文字を含むことができます。

テ キ ス ト は、 た と え ば Shift ・ Control ・ Alt ・ Meta の よ う な修飾キーが押 さ れてい る と き は空にな る こ と も あ り ます （プ ラ ッ ト フ ォームによ っ て異な り ます）。key() 関数は常に有効な値を返します。

Qt::WA_KeyCompressionも参照してください 。