QKeyEvent Class

Dokumentation zu den Member-Funktionen

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

Erstellt ein Schlüsselereignisobjekt.

Der Parameter „ type “ muss „ QEvent::KeyPress “, „ QEvent::KeyRelease “ oder „ QEvent::ShortcutOverride “ lauten.

„Int key “ ist der Code für den „ Qt::Key “, auf den die Ereignisschleife achten soll. Ist key gleich 0, ist das Ereignis nicht das Ergebnis einer bekannten Taste; es kann sich beispielsweise um das Ergebnis einer Kompositionssequenz oder eines Tastaturmakros handeln. modifiers enthält die Tastaturmodifikatoren, und der angegebene text ist der Unicode-Text, den die Taste erzeugt hat. Ist autorep wahr, ist isAutoRepeat() ebenfalls wahr. count ist die Anzahl der am Ereignis beteiligten Tasten.

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

Erstellt ein Schlüsselereignisobjekt.

Der Parameter „ type “ muss „ QEvent::KeyPress “, „ QEvent::KeyRelease “ oder „ QEvent::ShortcutOverride “ lauten.

„int key “ ist der Code für den „ Qt::Key “, auf den die Ereignisschleife achten soll. Ist key gleich 0, ist das Ereignis nicht das Ergebnis einer bekannten Taste; es kann beispielsweise das Ergebnis einer Kompositionssequenz oder eines Tastaturmakros sein. modifiers enthält die Tastaturmodifikatoren, und der angegebene text ist der Unicode-Text, den die Taste erzeugt hat. Ist autorep wahr, ist isAutoRepeat() wahr. count ist die Anzahl der am Ereignis beteiligten Tasten.

Zusätzlich zu den normalen Tastenereignisdaten enthält das Objekt auch „ nativeScanCode “, „ nativeVirtualKey “ und „ nativeModifiers “. Diese zusätzlichen Daten werden vom Tastenkürzelsystem verwendet, um zu bestimmen, welche Tastenkürzel ausgelöst werden sollen.

[protected delete] QKeyEvent::QKeyEvent(QKeyEvent &&)

Erstellt eine Instanz von „ QKeyEvent “. Diese Funktion ist gelöscht.

int QKeyEvent::count() const

Gibt die Anzahl der an diesem Ereignis beteiligten Schlüssel zurück. Wenn text() nicht leer ist, entspricht dies einfach der Länge der Zeichenfolge.

Siehe auch ` Qt::WA_KeyCompression`.

bool QKeyEvent::isAutoRepeat() const

Gibt „ true “ zurück, wenn dieses Ereignis von einer Taste mit automatischer Wiederholung stammt; gibt „ false “ zurück, wenn es von einem ersten Tastendruck stammt.

Beachten Sie, dass diese Funktion unbestimmt entweder „true“ oder „false“ zurückgeben könnte, wenn es sich bei dem Ereignis um ein komprimiertes Mehrtastenereignis handelt, das teilweise auf die automatische Wiederholung zurückzuführen ist.

int QKeyEvent::key() const

Gibt den Code der Taste zurück, die gedrückt oder losgelassen wurde.

Eine Liste der Tastaturcodes finden Sie unter Qt::Key. Diese Codes sind unabhängig vom zugrunde liegenden Fenstersystem. Beachten Sie, dass diese Funktion nicht zwischen Groß- und Kleinbuchstaben unterscheidet; verwenden Sie zu diesem Zweck die Funktion ` text()` (die den von der Taste erzeugten Unicode-Text zurückgibt).

Ein Wert von entweder 0 oder Qt::Key_unknown bedeutet, dass das Ereignis nicht von einer bekannten Taste stammt; es kann beispielsweise das Ergebnis einer Kompositionssequenz, eines Tastaturmakros oder einer Tastenereigniskomprimierung sein.

Siehe auch Qt::WA_KeyCompression.

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

Gibt ein ` QKeyCombination `-Objekt zurück, das sowohl die von diesem Ereignis übertragenen Werte ` key()` als auch ` modifiers()` enthält.

Diese Funktion wurde in Qt 6.0 eingeführt.

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

Gibt „ true “ zurück, wenn das Tastenereignis dem angegebenen Standard „ key “ entspricht; andernfalls wird „ false “ zurückgegeben.

Qt::KeyboardModifiers QKeyEvent::modifiers() const

Gibt die Tastatur-Modifikator-Flags zurück, die unmittelbar nach dem Auftreten des Ereignisses vorhanden waren.

Siehe auch ` QGuiApplication::keyboardModifiers()`.

quint32 QKeyEvent::nativeModifiers() const

Gibt die nativen Modifikatoren eines Tastenereignisses zurück. Enthält das Tastenereignis diese Daten nicht, wird 0 zurückgegeben.

quint32 QKeyEvent::nativeScanCode() const

Gibt den nativen Scan-Code des Tastenereignisses zurück. Enthält das Tastenereignis diese Daten nicht, wird 0 zurückgegeben.

quint32 QKeyEvent::nativeVirtualKey() const

Gibt den nativen virtuellen Schlüssel oder das Schlüsselsymbol des Tastenereignisses zurück. Enthält das Tastenereignis diese Daten nicht, wird 0 zurückgegeben.

QString QKeyEvent::text() const

Gibt den Unicode-Text zurück, der von diesem Schlüssel generiert wurde.

Der Text ist nicht auf den druckbaren Bereich der Unicode-Codepunkte beschränkt und kann Steuerzeichen oder Zeichen aus anderen Unicode-Kategorien enthalten, einschließlich „ QChar::Other_PrivateUse “.

Der Text kann auch leer sein, beispielsweise wenn Modifikatortasten wie Umschalt, Strg, Alt und Meta gedrückt werden (plattformabhängig). Die Funktion ` key()` gibt immer einen gültigen Wert zurück.

Siehe auch „ Qt::WA_KeyCompression “.

[protected delete] QKeyEvent &QKeyEvent::operator=(QKeyEvent &&)

Weist „ other “ dieser „ QKeyEvent “-Instanz zu. Diese Funktion wird gelöscht.

[noexcept protected default] QKeyEvent &QKeyEvent::operator=(const QKeyEvent &other)

other Weist dieser „ QKeyEvent “-Instanz „ “ zu. zu dieser „ “-Instanz.