Back to Qt.io
Contact Us Blog Download Qt

QVirtualKeyboardInputContext Class

Ermöglicht den Zugriff auf einen Eingabekontext. Mehr...

Kopfzeile: #include <QVirtualKeyboardInputContext>
CMake: find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard)
target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard)
qmake: QT += virtualkeyboard
In QML: InputContext
Vererbt: 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()

Detaillierte Beschreibung

Dokumentation der Eigenschaften

[read-only] anchorPosition : const int

Diese Eigenschaft enthält die Ankerposition.

Diese Eigenschaft wird geändert, wenn sich die Ankerposition ändert.

Zugriffsfunktionen:

int anchorPosition() const

Benachrichtigungssignal:

void anchorPositionChanged()

[read-only] anchorRectIntersectsClipRect : const bool

Hält true, wenn das Begrenzungsrechteck des Auswahlankers das freigelegte Rechteck des Eingabeelements schneidet.

Zugriffsfunktionen:

bool anchorRectIntersectsClipRect() const

Benachrichtigungssignal:

void anchorRectIntersectsClipRectChanged()

Siehe auch Qt::ImAnchorRectangle und Qt::ImInputItemClipRectangle.

[read-only] anchorRectangle : const QRectF

Diese Eigenschaft enthält das Ankerrechteck.

Diese Eigenschaft wird geändert, 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 zu setzen, z. B. bei UI-Übergangszuständen.

Zugriffsfunktionen:

bool isAnimating() const
void setAnimating(bool isAnimating)

Benachrichtigungssignal:

void animatingChanged()

[read-only] capsLockActive : const 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 : const int

Diese Eigenschaft enthält die Cursorposition.

Diese Eigenschaft wird geändert, wenn sich die Position des Cursors ändert.

Zugriffsfunktionen:

int cursorPosition() const

Melder-Signal:

void cursorPositionChanged()

[read-only] cursorRectIntersectsClipRect : const bool

Hält true, wenn das Begrenzungsrechteck des Eingabecursors das freiliegende Rechteck des Eingabeelements überschneidet.

Zugriffsfunktionen:

bool cursorRectIntersectsClipRect() const

Benachrichtigungssignal:

void cursorRectIntersectsClipRectChanged()

Siehe auch Qt::ImCursorRectangle und Qt::ImInputItemClipRectangle.

[read-only] cursorRectangle : const QRectF

Diese Eigenschaft enthält das Cursor-Rechteck.

Diese Eigenschaft wird geändert, wenn sich das Cursor-Rechteck ändert.

Zugriffsfunktionen:

QRectF cursorRectangle() const

Melder-Signal:

void cursorRectangleChanged()

[read-only] inputEngine : QVirtualKeyboardInputEngine* const

Diese Eigenschaft speichert den Eingabemotor.

Diese Eigenschaft speichert den Eingabemotor.

Zugriffsfunktionen:

QVirtualKeyboardInputEngine *inputEngine() const

[read-only] inputMethodHints : const Qt::InputMethodHints

Diese Eigenschaft enthält die Hinweise zur Eingabemethode.

Diese Eigenschaft wird geändert, wenn sich die Eingabemethoden-Hinweise ändern.

Zugriffsfunktionen:

Qt::InputMethodHints inputMethodHints() const

Benachrichtigungssignal:

void inputMethodHintsChanged()

[read-only, since QtQuick.VirtualKeyboard 6.1] keyboardObserver : QVirtualKeyboardObserver* const

Enthält das Keyboard Observer-Objekt, das verwendet werden kann, um Benachrichtigungen über Tastaturänderungsereignisse zu empfangen.

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

Zugriffsfunktionen:

QVirtualKeyboardObserver *keyboardObserver() const

[read-only] locale : const QString

Diese Eigenschaft enthält das Gebietsschema.

Diese Eigenschaft wird geändert, wenn sich das Eingabegebietsschema ändert.

Zugriffsfunktionen:

QString locale() const

Melder-Signal:

void localeChanged()

preeditText : QString

Diese Eigenschaft enthält den Text vor der Bearbeitung.

Diese Eigenschaft legt den Text für die Vorbearbeitung 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 : const QString

Diese Eigenschaft enthält den markierten Text.

Diese Eigenschaft wird geändert, wenn sich der markierte Text ändert.

Zugriffsfunktionen:

QString selectedText() const

Benachrichtigungssignal:

void selectedTextChanged()

[read-only] selectionControlVisible : const bool

Hält true, wenn die Auswahlsteuerung gerade sichtbar ist.

Zugriffsfunktionen:

bool isSelectionControlVisible() const

Melder-Signal:

void selectionControlVisibleChanged()

[read-only] shiftActive : const bool

Diese Eigenschaft enthält den Schichtstatus.

Diese Eigenschaft wird geändert, wenn sich der Schichtstatus ändert.

Zugriffsfunktionen:

bool isShiftActive() const

Melder-Signal:

void shiftActiveChanged()

[read-only] surroundingText : const QString

Diese Eigenschaft enthält den umgebenden Text um den Cursor.

Diese Eigenschaft wird geändert, wenn sich der umgebende Text um den Cursor ändert.

Zugriffsfunktionen:

QString surroundingText() const

Benachrichtigungssignal:

void surroundingTextChanged()

[read-only] uppercase : const bool

Diese Eigenschaft enthält den Großbuchstabenstatus.

Diese Eigenschaft ist true, wenn entweder shiftActive oder capsLockActive true ist.

Zugriffsfunktionen:

bool isUppercase() const

Benachrichtigungssignal:

void uppercaseChanged()

Member Function Dokumentation

[invokable] void QVirtualKeyboardInputContext::clear()

Löscht den Text vor dem Editieren.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QVirtualKeyboardInputContext::commit()

Bestätigt den aktuellen Text vor der Bearbeitung.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QVirtualKeyboardInputContext::commit(const QString &text, int replaceFrom = 0, int replaceLength = 0)

Überträgt den endgültigen text in das Eingabeelement und ändert optional den Text relativ zum Anfang des vor der Bearbeitung stehenden Textes. Wenn replaceFrom ungleich Null ist, ersetzt text den Inhalt relativ zu replaceFrom mit einer Länge von replaceLength.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] void QVirtualKeyboardInputContext::sendKeyClick(int key, const QString &text, int modifiers = 0)

Sendet ein Tastenklick-Ereignis mit den angegebenen key, text und modifiers an das Eingabeelement, das gerade den Fokus hat.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

© 2025 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.