QVirtualKeyboardInputContext Class
Bietet Zugriff auf einen Eingabekontext. Mehr...
| Header: | #include <QVirtualKeyboardInputContext> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard) target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard) |
| qmake: | QT += virtualkeyboard |
| In QML: | InputContext |
| Erbt von: | QObject |
Eigenschaften
|
|
Öffentliche Funktionen
| int | anchorPosition() const |
| bool | anchorRectIntersectsClipRect() const |
| QRectF | anchorRectangle() const |
| void | clear() |
| void | commit() |
| void | commit(const QString &text, int replaceFrom = 0, int replaceLength = 0) |
| int | cursorPosition() const |
| bool | cursorRectIntersectsClipRect() const |
| QRectF | cursorRectangle() const |
| QVirtualKeyboardInputEngine * | inputEngine() const |
| Qt::InputMethodHints | inputMethodHints() const |
| bool | isAnimating() const |
| bool | isCapsLockActive() const |
| bool | isSelectionControlVisible() const |
| bool | isShiftActive() const |
| bool | isUppercase() const |
| QVirtualKeyboardObserver * | keyboardObserver() const |
| QString | locale() const |
| QString | preeditText() const |
| QString | selectedText() const |
| void | sendKeyClick(int key, const QString &text, int modifiers = 0) |
| void | setAnimating(bool isAnimating) |
| void | setPreeditText(const QString &text, QList<QInputMethodEvent::Attribute> attributes = QList<QInputMethodEvent::Attribute>(), int replaceFrom = 0, int replaceLength = 0) |
| QString | surroundingText() const |
Signale
| void | anchorPositionChanged() |
| void | anchorRectIntersectsClipRectChanged() |
| void | anchorRectangleChanged() |
| void | animatingChanged() |
| void | capsLockActiveChanged() |
| void | cursorPositionChanged() |
| void | cursorRectIntersectsClipRectChanged() |
| void | cursorRectangleChanged() |
| void | inputMethodHintsChanged() |
| void | localeChanged() |
| void | preeditTextChanged() |
| void | selectedTextChanged() |
| void | selectionControlVisibleChanged() |
| void | shiftActiveChanged() |
| void | surroundingTextChanged() |
| void | uppercaseChanged() |
Dokumentation der Eigenschaften
[read-only] anchorPosition : int
Diese Eigenschaft enthält die Ankerposition.
Diese Eigenschaft ändert sich, wenn sich die Ankerposition ändert.
Zugriffsfunktionen:
| int | anchorPosition() const |
Benachrichtigungssignal:
| void | anchorPositionChanged() |
[read-only] anchorRectIntersectsClipRect : bool
Gibt „ true “ zurück, wenn sich das Begrenzungsrechteck des Auswahlankers mit dem Rechteck des sichtbaren Eingabeelements überschneidet.
Zugriffsfunktionen:
| bool | anchorRectIntersectsClipRect() const |
Benachrichtigungssignal:
| void | anchorRectIntersectsClipRectChanged() |
Siehe auch „ Qt::ImAnchorRectangle “ und „ Qt::ImInputItemClipRectangle “.
[read-only] anchorRectangle : QRectF
Diese Eigenschaft enthält das Ankerrechteck.
Diese Eigenschaft ändert sich, wenn sich das Ankerrechteck ändert.
Zugriffsfunktionen:
| QRectF | anchorRectangle() const |
Benachrichtigungssignal:
| void | anchorRectangleChanged() |
animating : bool
Diese Eigenschaft enthält den Animationsstatus.
Verwenden Sie diese Eigenschaft, um den Animationsstatus festzulegen, beispielsweise während Übergangsphasen der Benutzeroberfläche.
Zugriffsfunktionen:
| bool | isAnimating() const |
| void | setAnimating(bool isAnimating) |
Notifier-Signal:
| void | animatingChanged() |
[read-only] capsLockActive : bool
Diese Eigenschaft enthält den Status der Feststelltaste.
Diese Eigenschaft wird geändert, wenn sich der Status der Feststelltaste ändert.
Zugriffsfunktionen:
| bool | isCapsLockActive() const |
Benachrichtigungssignal:
| void | capsLockActiveChanged() |
[read-only] cursorPosition : int
Diese Eigenschaft enthält die Cursorposition.
Diese Eigenschaft ändert sich, wenn sich die Cursorposition ändert.
Zugriffsfunktionen:
| int | cursorPosition() const |
Benachrichtigungssignal:
| void | cursorPositionChanged() |
[read-only] cursorRectIntersectsClipRect : bool
Gibt „ true “ zurück, wenn sich das Begrenzungsrechteck des Eingabecursors mit dem Rechteck des angezeigten Eingabeelements schneidet.
Zugriffsfunktionen:
| bool | cursorRectIntersectsClipRect() const |
Benachrichtigungssignal:
| void | cursorRectIntersectsClipRectChanged() |
Siehe auch „ Qt::ImCursorRectangle “ und „ Qt::ImInputItemClipRectangle “.
[read-only] cursorRectangle : QRectF
Diese Eigenschaft enthält das Cursor-Rechteck.
Diese Eigenschaft wird geändert, wenn sich das Cursor-Rechteck ändert.
Zugriffsfunktionen:
| QRectF | cursorRectangle() const |
Benachrichtigungssignal:
| void | cursorRectangleChanged() |
[read-only] inputEngine : QVirtualKeyboardInputEngine* const
Diese Eigenschaft enthält die Eingabe-Engine.
Diese Eigenschaft speichert die Eingabe-Engine.
Zugriffsfunktionen:
| QVirtualKeyboardInputEngine * | inputEngine() const |
[read-only] inputMethodHints : Qt::InputMethodHints
Diese Eigenschaft enthält die Hinweise zur Eingabemethode.
Diese Eigenschaft wird geändert, wenn sich die Eingabemethode-Hinweise ändern.
Zugriffsfunktionen:
| Qt::InputMethodHints | inputMethodHints() const |
Benachrichtigungssignal:
| void | inputMethodHintsChanged() |
[read-only, since 6.1] keyboardObserver : QVirtualKeyboardObserver* const
Enthält das Tastatur-Beobachter-Objekt, mit dem Benachrichtigungen über Tastaturänderungsereignisse empfangen werden können.
Diese Aufzählung wurde in Qt 6.1 eingeführt.
Zugriffsfunktionen:
| QVirtualKeyboardObserver * | keyboardObserver() const |
[read-only] locale : QString
Diese Eigenschaft enthält die Sprachumgebung.
Diese Eigenschaft wird geändert, wenn sich die Eingabe-Lokalisierung ändert.
Zugriffsfunktionen:
| QString | locale() const |
Benachrichtigungssignal:
| void | localeChanged() |
preeditText : QString
Diese Eigenschaft enthält den Text vor der Bearbeitung.
Diese Eigenschaft legt den Text vor der Bearbeitung fest.
Zugriffsfunktionen:
| QString | preeditText() const |
| void | setPreeditText(const QString &text, QList<QInputMethodEvent::Attribute> attributes = QList<QInputMethodEvent::Attribute>(), int replaceFrom = 0, int replaceLength = 0) |
Benachrichtigungssignal:
| void | preeditTextChanged() |
[read-only] selectedText : QString
Diese Eigenschaft enthält den ausgewählten Text.
Diese Eigenschaft wird geändert, wenn sich der ausgewählte Text ändert.
Zugriffsfunktionen:
| QString | selectedText() const |
Benachrichtigungssignal:
| void | selectedTextChanged() |
[read-only] selectionControlVisible : bool
Enthält „ true “, wenn das Auswahlsteuerelement derzeit sichtbar ist.
Zugriffsfunktionen:
| bool | isSelectionControlVisible() const |
Benachrichtigungssignal:
| void | selectionControlVisibleChanged() |
[read-only] shiftActive : bool
Diese Eigenschaft enthält den Schichtstatus.
Diese Eigenschaft wird geändert, wenn sich der Schichtstatus ändert.
Zugriffsfunktionen:
| bool | isShiftActive() const |
Benachrichtigungssignal:
| void | shiftActiveChanged() |
[read-only] surroundingText : QString
Diese Eigenschaft enthält den Text, der den Cursor umgibt.
Diese Eigenschaft ändert sich, wenn sich der umgebende Text um den Cursor herum ändert.
Zugriffsfunktionen:
| QString | surroundingText() const |
Benachrichtigungssignal:
| void | surroundingTextChanged() |
[read-only] uppercase : bool
Diese Eigenschaft gibt den Großschreibungsstatus an.
Diese Eigenschaft ist „ true “, wenn entweder „ shiftActive “ oder „ capsLockActive “ den Wert „ true “ hat.
Zugriffsfunktionen:
| bool | isUppercase() const |
Benachrichtigungssignal:
| void | uppercaseChanged() |
Dokumentation der Member-Funktionen
[invokable] void QVirtualKeyboardInputContext::clear()
Löscht den Text vor der Bearbeitung.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QVirtualKeyboardInputContext::commit()
Übernimmt den aktuellen Text vor der Bearbeitung.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QVirtualKeyboardInputContext::commit(const QString &text, int replaceFrom = 0, int replaceLength = 0)
Überträgt die endgültige „ text “ auf das Eingabeelement und passt den Text optional relativ zum Anfang des vor der Bearbeitung vorhandenen Textes an. Ist „ replaceFrom “ ungleich Null, ersetzt die „ text “ den Inhalt relativ zu „ replaceFrom “ mit einer Länge von „ replaceLength “.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QVirtualKeyboardInputContext::sendKeyClick(int key, const QString &text, int modifiers = 0)
Sendet ein Tastenklick-Ereignis mit den angegebenen Werten für „ key “, „ text “ und „ modifiers “ an das Eingabeelement, das derzeit den Fokus hat.
Hinweis: Diese Funktion kann über das Metaobjekt-System und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
