QVirtualKeyboardAbstractInputMethod Class

Dokumentation der Mitgliedsfunktionen

[explicit] QVirtualKeyboardAbstractInputMethod::QVirtualKeyboardAbstractInputMethod(QObject *parent = nullptr)

Erstellt eine Eingabemethode mit „ parent “.

[virtual noexcept] QVirtualKeyboardAbstractInputMethod::~QVirtualKeyboardAbstractInputMethod()

Löst die Eingabemethode auf und gibt alle zugewiesenen Ressourcen frei.

[virtual slot, since 6.1] void QVirtualKeyboardAbstractInputMethod::clearInputMode()

Löscht den Eingabemodus.

Diese Methode wird von der virtuellen Tastatur aufgerufen, wenn diese Eingabemethode durch eine andere Eingabemethode ersetzt wird. Sie sollte die von der Methode ` setInputMode()` durchgeführten Vorgänge rückgängig machen, beispielsweise um Signal-Handler von der virtuellen Tastatur zu trennen oder Ressourcen freizugeben.

Der Eingabemodus kann durch Aufruf von ` setInputMode()` wieder aktiviert werden. Beachten Sie jedoch, dass die Aufrufe von `setInputMethod()` und `clearInputMethod()` nicht symmetrisch sind. So kann beispielsweise `setInputMethod()` mehrfach aufgerufen werden, ohne dass ein entsprechender Aufruf von `clearInputMethod()` erfolgt.

Die Standardimplementierung führt keine Aktion aus.

Diese Funktion wurde in Qt 6.1 eingeführt.

[virtual, since QtQuick.VirtualKeyboard 2.4] bool QVirtualKeyboardAbstractInputMethod::clickPreeditText(int cursorPosition)

Wird aufgerufen, wenn der Benutzer auf den Vorbearbeitungstext unter cursorPosition klickt.

Die Funktion sollte ` true ` zurückgeben, wenn sie das Ereignis verarbeitet. Andernfalls wird die Eingabe zur weiteren Verarbeitung an ` reselect()` weitergeleitet.

Diese Funktion wurde in QtQuick.VirtualKeyboard 2.4 eingeführt.

QVirtualKeyboardInputContext *QVirtualKeyboardAbstractInputMethod::inputContext() const

Gibt den mit der Eingabemethode verknüpften Eingabekontext zurück. Diese Methode gibt „ NULL “ zurück, wenn die Eingabemethode nicht aktiv ist.

QVirtualKeyboardInputEngine *QVirtualKeyboardAbstractInputMethod::inputEngine() const

Gibt die mit der Eingabemethode verknüpfte Eingabe-Engine zurück. Diese Methode gibt „ NULL “ zurück, wenn die Eingabemethode nicht aktiv ist.

[pure virtual] QList<QVirtualKeyboardInputEngine::InputMode> QVirtualKeyboardAbstractInputMethod::inputModes(const QString &locale)

Gibt die Liste der Eingabemodi für „ locale “ zurück.

[pure virtual] bool QVirtualKeyboardAbstractInputMethod::keyEvent(Qt::Key key, const QString &text, Qt::KeyboardModifiers modifiers)

Der Zweck dieser Methode besteht darin, die von der Eingabe-Engine generierten Tastenereignisse zu verarbeiten.

Der Parameter „ key “ gibt den Code der zu verarbeitenden Taste an. Bei dem Tastencode wird nicht zwischen Groß- und Kleinbuchstaben unterschieden. Der Parameter „ text “ enthält den Unicode-Text für die Taste. Der Parameter „ modifiers “ enthält die Tastenmodifikatoren, die für die Taste gelten.

Diese Methode gibt „ true “ zurück, wenn das Tastenereignis erfolgreich verarbeitet wurde. Ist der Rückgabewert „ false “, wird das Tastenereignis zur weiteren Verarbeitung an die Standard-Eingabemethode weitergeleitet.

[virtual, since QtQuick.VirtualKeyboard 2.0] QList<QVirtualKeyboardInputEngine::PatternRecognitionMode> QVirtualKeyboardAbstractInputMethod::patternRecognitionModes() const

Gibt eine Liste der unterstützten Mustererkennungsmodi zurück.

Diese Methode wird von der Eingabe-Engine aufgerufen, um die Liste der unterstützten Mustererkennungsmodi abzufragen.

Diese Funktion wurde in QtQuick.VirtualKeyboard 2.0 eingeführt.

[virtual, since QtQuick.VirtualKeyboard 2.0] bool QVirtualKeyboardAbstractInputMethod::reselect(int cursorPosition, const QVirtualKeyboardInputEngine::ReselectFlags &reselectFlags)

Diese Funktion versucht, ein Wort an der Position cursorPosition erneut auszuwählen. Die Parameter reselectFlags legen fest, wie das Wort in Bezug auf die Cursorposition ausgewählt werden soll.

Die Funktion gibt „ true “ zurück, wenn das Wort erfolgreich erneut ausgewählt wurde.

Diese Funktion wurde in QtQuick.VirtualKeyboard 2.0 eingeführt.

[virtual slot] void QVirtualKeyboardAbstractInputMethod::reset()

Diese Methode wird von der Eingabe-Engine aufgerufen, wenn die Eingabemethode zurückgesetzt werden muss. Die Eingabemethode darf dabei ausschließlich ihren internen Zustand zurücksetzen. Der wesentliche Unterschied zur Methode ` update()` besteht darin, dass `reset()` lediglich den Zustand der Eingabemethode ändert, d. h., der Eingabekontext darf dabei nicht verändert werden.

[signal] void QVirtualKeyboardAbstractInputMethod::selectionListActiveItemChanged(QVirtualKeyboardSelectionListModel::Type type, int index)

Die Eingabemethode gibt dieses Signal aus, wenn sich der aktuelle „ index “ in der durch „ type “ identifizierten Auswahlliste geändert hat.

[signal] void QVirtualKeyboardAbstractInputMethod::selectionListChanged(QVirtualKeyboardSelectionListModel::Type type)

Die Eingabemethode gibt dieses Signal aus, wenn sich der Inhalt der Auswahlliste geändert hat. Der Parameter „ type “ gibt an, welche Auswahlliste sich geändert hat.

[virtual] QVariant QVirtualKeyboardAbstractInputMethod::selectionListData(QVirtualKeyboardSelectionListModel::Type type, int index, QVirtualKeyboardSelectionListModel::Role role)

Gibt die Artikeldaten für die durch ` type` identifizierte Auswahlliste zurück. Der Parameter ` role ` gibt an, welche Daten abgefragt werden sollen. Der Parameter ` index ` ist ein nullbasierter Index in der Liste.

[virtual] int QVirtualKeyboardAbstractInputMethod::selectionListItemCount(QVirtualKeyboardSelectionListModel::Type type)

Gibt die Anzahl der Elemente in der Auswahlliste zurück, die durch ` type` identifiziert wird.

[virtual] void QVirtualKeyboardAbstractInputMethod::selectionListItemSelected(QVirtualKeyboardSelectionListModel::Type type, int index)

Diese Methode wird aufgerufen, wenn der Benutzer einen Eintrag unter „ index “ ausgewählt hat. Die Auswahlliste wird durch den Parameter „ type “ identifiziert.

[virtual] bool QVirtualKeyboardAbstractInputMethod::selectionListRemoveItem(QVirtualKeyboardSelectionListModel::Type type, int index)

Diese Methode wird aufgerufen, wenn ein Eintrag unter „ index “ aus dem Wörterbuch entfernt werden soll. Die Auswahlliste wird durch den Parameter „ type “ angegeben. Die Funktion gibt „ true “ zurück, wenn das Wort erfolgreich entfernt wurde.

[virtual] QList<QVirtualKeyboardSelectionListModel::Type> QVirtualKeyboardAbstractInputMethod::selectionLists()

Gibt die Liste der von dieser Eingabemethode verwendeten Auswahllisten zurück.

Diese Methode wird von der Eingabe-Engine aufgerufen, wenn die Eingabemethode aktiviert wird und jedes Mal, wenn die Eingabehinweise aktualisiert werden. Die Eingabemethode kann Auswahllisten reservieren, indem sie die gewünschten Auswahllistentypen zurückgibt.

Die Eingabemethode kann die Eingabe-Engine jederzeit auffordern, die Auswahllisten zu aktualisieren, indem sie das Signal „ selectionListsChanged()“ aussendet. Dieses Signal löst einen Aufruf dieser Methode aus, wodurch die Eingabemethode die Auswahllistentypen aktualisieren kann.

[signal, since QtQuick.VirtualKeyboard 2.2] void QVirtualKeyboardAbstractInputMethod::selectionListsChanged()

Die Eingabemethode gibt dieses Signal aus, wenn sich die Typen der Auswahlliste geändert haben. Dieses Signal löst einen Aufruf der Methode ` selectionLists()` aus, wodurch die Eingabemethode die Typen der Auswahlliste aktualisieren kann.

Diese Funktion wurde in QtQuick.VirtualKeyboard 2.2 eingeführt.

[pure virtual] bool QVirtualKeyboardAbstractInputMethod::setInputMode(const QString &locale, QVirtualKeyboardInputEngine::InputMode inputMode)

Legt die Werte „ inputMode “ und „ locale “ für diese Eingabemethode fest. Gibt bei Erfolg „ true “ zurück.

[pure virtual] bool QVirtualKeyboardAbstractInputMethod::setTextCase(QVirtualKeyboardInputEngine::TextCase textCase)

Aktualisiert den „ textCase “ für diese Eingabemethode. Die Methode gibt bei Erfolg „ true “ zurück.

[virtual, since QtQuick.VirtualKeyboard 2.0] QVirtualKeyboardTrace *QVirtualKeyboardAbstractInputMethod::traceBegin(int traceId, QVirtualKeyboardInputEngine::PatternRecognitionMode patternRecognitionMode, const QVariantMap &traceCaptureDeviceInfo, const QVariantMap &traceScreenInfo)

Diese Methode wird aufgerufen, wenn eine Trace-Interaktion mit dem angegebenen ` patternRecognitionMode` beginnt. Der Trace wird durch den ` traceId` eindeutig identifiziert. Der ` traceCaptureDeviceInfo ` liefert Informationen zum Quellgerät, und der ` traceScreenInfo ` liefert Informationen zum Bildschirmkontext.

Wenn die Eingabemethode das Ereignis akzeptiert und die Trace-Eingabe erfassen möchte, muss sie ein neues ` QVirtualKeyboardTrace `-Objekt zurückgeben. Dieses Objekt muss gültig bleiben, bis die Methode ` traceEnd()` aufgerufen wird. Wenn das ` QVirtualKeyboardTrace ` auf dem Bildschirm dargestellt wird, bleibt es dort, bis das ` QVirtualKeyboardTrace `-Objekt zerstört wird.

Diese Funktion wurde in QtQuick.VirtualKeyboard 2.0 eingeführt.

[virtual, since QtQuick.VirtualKeyboard 2.0] bool QVirtualKeyboardAbstractInputMethod::traceEnd(QVirtualKeyboardTrace *trace)

Diese Methode wird aufgerufen, wenn die Trace-Interaktion endet. Die Eingabemethode sollte das trace -Objekt zu einem Zeitpunkt nach dem Aufruf dieser Funktion löschen. Informationen zum Zugriff auf die erfassten Daten finden Sie in der Trace-API für Eingabemethoden.

Die Methode gibt ` true ` zurück, wenn die Trace-Interaktion akzeptiert wurde.

Diese Funktion wurde in QtQuick.VirtualKeyboard 2.0 eingeführt.

[virtual slot] void QVirtualKeyboardAbstractInputMethod::update()

Diese Methode wird von der Eingabe-Engine aufgerufen, wenn die Eingabemethode aktualisiert werden muss. Die Eingabemethode muss den aktuellen Vorbearbeitungstext schließen und ihren internen Zustand auf die Standardeinstellung zurücksetzen.