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

key イベントのネイティブ仮想キーまたは key sym を返します。key イベントがこのデータを含まない場合、0 が返される。

QString QKeyEvent::text() const

このキーが生成した Unicode テキストを返します。

テ キ ス ト は、 Unicode コ ー ド ポ イ ン ト の印字可能範囲に限 ら れ る も のではあ り ません。 制御キ ャ ラ ク タ や、QChar::Other_PrivateUse を含む他の Unicode カ テ ゴ リ のキ ャ ラ ク タ を含む こ と も で き ます。

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

Qt::WA_KeyCompressionも参照 。