QVirtualKeyboardAbstractInputMethod Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert eine Eingabemethode mit parent.

[virtual noexcept] QVirtualKeyboardAbstractInputMethod::~QVirtualKeyboardAbstractInputMethod()

Zerstört die Eingabemethode und gibt alle zugewiesenen Ressourcen frei.

[virtual slot, since QtQuick.VirtualKeyboard 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 Operationen löschen, z. B. um die Signalhandler von der virtuellen Tastatur zu trennen oder Ressourcen freizugeben.

Der Eingabemodus kann durch den Aufruf von setInputMode() wieder aktiviert werden. Es ist jedoch zu beachten, dass die Aufrufe von setInputMethod() und clearInputMethod() nicht im Gleichgewicht sind. So kann zum Beispiel setInputMethod() mehrfach aufgerufen werden, ohne dass ein entsprechender Aufruf von clearInputMethod() erfolgt.

Die Standardimplementierung tut nichts.

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

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

Wird aufgerufen, wenn der Benutzer auf den Text vor der Bearbeitung unter cursorPosition klickt.

Die Funktion sollte true zurückgeben, wenn sie das Ereignis verarbeitet. Andernfalls fällt die Eingabe zurück zu reselect() zur weiteren Verarbeitung.

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

QVirtualKeyboardInputContext *QVirtualKeyboardAbstractInputMethod::inputContext() const

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

QVirtualKeyboardInputEngine *QVirtualKeyboardAbstractInputMethod::inputEngine() const

Gibt den mit der Eingabemethode verbundenen Eingabemotor 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 vom Eingabemodul erzeugten Tastenereignisse zu verarbeiten.

Der Parameter key gibt den Code des zu behandelnden Schlüssels an. Der Schlüsselcode unterscheidet nicht zwischen Groß- und Kleinbuchstaben. Der Parameter text enthält den Unicode-Text für den Schlüssel. Der Parameter modifiers enthält die Schlüsselmodifikatoren, die für den Schlüssel gelten.

Diese Methode gibt true zurück, wenn das Schlüsselereignis erfolgreich behandelt wurde. Wenn der Rückgabewert false lautet, wird das Schlüsselereignis zur weiteren Verarbeitung an die Standardeingabemethode weitergeleitet.

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

Gibt die 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)

Mit dieser Funktion wird versucht, ein Wort, das sich an der Adresse cursorPosition befindet, neu zu markieren. reselectFlags definiert die Regeln dafür, wie das Wort in Bezug auf die Cursorposition markiert werden soll.

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

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

[virtual slot] void QVirtualKeyboardAbstractInputMethod::reset()

Diese Methode wird von der Eingabemaschine aufgerufen, wenn die Eingabemethode zurückgesetzt werden muss. Die Eingabemethode muss nur ihren internen Zustand zurücksetzen. Der Hauptunterschied zur Methode update() besteht darin, dass reset() nur den Zustand der Eingabemethode ändert, d. h. der Eingabekontext darf nicht verändert werden.

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

Die Eingabemethode sendet dieses Signal, wenn sich die 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)

Liefert Positionsdaten für die durch type identifizierte Auswahlliste. Der Parameter role gibt an, welche Daten angefordert werden. Der Parameter index ist ein auf Null basierender 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 ein Element unter index vom Benutzer ausgewählt wurde. 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 muss. Die Auswahlliste wird durch den Parameter type identifiziert. 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 Eingabemaschine aufgerufen, wenn die Eingabemethode aktiviert wird und jedes Mal, wenn die Hinweise zur Eingabemethode aktualisiert werden. Die Eingabemethode kann Auswahllisten reservieren, indem sie die gewünschten Auswahllistentypen zurückgibt.

Die Eingabemethode kann die Eingabemaschine jederzeit auffordern, die Auswahllisten zu aktualisieren, indem sie das Signal selectionListsChanged() ausgibt. Dieses Signal löst einen Aufruf dieser Methode aus, so dass 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, so dass die Eingabemethode die Auswahllistentypen aktualisieren kann.

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

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

Setzt die inputMode und locale für diese Eingabemethode. Gibt bei Erfolg true zurück.

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

Aktualisiert die textCase für diese Eingabemethode. Bei Erfolg gibt die Methode 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 eindeutig durch traceId identifiziert. traceCaptureDeviceInfo liefert Informationen über das Quellgerät und traceScreenInfo liefert Informationen über den Bildschirmkontext.

Wenn die Eingabemethode das Ereignis annimmt und die Trace-Eingabe erfassen will, 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 gerendert 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 beendet ist. Die Eingabemethode sollte das trace Objekt irgendwann nach dem Aufruf dieser Funktion zerstören. Siehe die Trace-API für Eingabemethoden, wie man auf die gesammelten Daten zugreift.

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 Eingabemaschine aufgerufen, wenn die Eingabemethode aktualisiert werden muss. Die Eingabemethode muss den aktuellen Text vor der Bearbeitung schließen und ihren internen Zustand auf den Standardwert zurücksetzen.