QVirtualKeyboardInputContext Class

Provides access to an input context. More...

Header:	`#include <QVirtualKeyboardInputContext>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard)` `target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard)`
qmake:	`QT += virtualkeyboard`
In QML:	InputContext
Inherits:	QObject

Properties

anchorPosition : const int
anchorRectIntersectsClipRect : const bool
anchorRectangle : const QRectF
animating : bool
capsLockActive : const bool
cursorPosition : const int
cursorRectIntersectsClipRect : const bool
cursorRectangle : const QRectF
inputEngine : QVirtualKeyboardInputEngine* const

inputMethodHints : const Qt::InputMethodHints
(since QtQuick.VirtualKeyboard 6.1) keyboardObserver : QVirtualKeyboardObserver* const
locale : const QString
preeditText : QString
selectedText : const QString
selectionControlVisible : const bool
shiftActive : const bool
surroundingText : const QString
uppercase : const bool

Public Functions

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

Signals

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

Detailed Description

Property Documentation

`[read-only]` anchorPosition : const int

This property holds the anchor position.

This property is changed when the anchor position changes.

Access functions:

int	anchorPosition() const

Notifier signal:

void	anchorPositionChanged()

`[read-only]` anchorRectIntersectsClipRect : const bool

Holds true if the bounding rectangle of the selection anchor intersects the exposed input item rectangle.

Access functions:

bool	anchorRectIntersectsClipRect() const

Notifier signal:

void	anchorRectIntersectsClipRectChanged()

`[read-only]` anchorRectangle : const QRectF

This property holds the anchor rectangle.

This property is changed when the anchor rectangle changes.

Access functions:

QRectF anchorRectangle() const

Notifier signal:

void	anchorRectangleChanged()

animating : bool

This property holds the animating status.

Use this property to set the animating status, for example during UI transitioning states.

Access functions:

bool	isAnimating() const
void	setAnimating(bool isAnimating)

Notifier signal:

void	animatingChanged()

`[read-only]` capsLockActive : const bool

This property holds the caps lock status.

This property is changed when the caps lock status changes.

Access functions:

bool	isCapsLockActive() const

Notifier signal:

void	capsLockActiveChanged()

`[read-only]` cursorPosition : const int

This property holds the cursor position.

This property is changed when the cursor position changes.

Access functions:

int	cursorPosition() const

Notifier signal:

void	cursorPositionChanged()

`[read-only]` cursorRectIntersectsClipRect : const bool

Holds true if the bounding rectangle of the input cursor intersects the exposed input item rectangle.

Access functions:

bool	cursorRectIntersectsClipRect() const

Notifier signal:

void	cursorRectIntersectsClipRectChanged()

`[read-only]` cursorRectangle : const QRectF

This property holds the cursor rectangle.

This property is changed when the cursor rectangle changes.

Access functions:

QRectF cursorRectangle() const

Notifier signal:

void	cursorRectangleChanged()

`[read-only]` inputEngine : QVirtualKeyboardInputEngine* const

This property holds the input engine.

This property stores the input engine.

Access functions:

QVirtualKeyboardInputEngine * inputEngine() const

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

This property holds the input method hints.

This property is changed when the input method hints changes.

Access functions:

Qt::InputMethodHints inputMethodHints() const

Notifier signal:

void	inputMethodHintsChanged()

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

Holds the keyboard observer object, which can be used to receive notifications of keyboard change events.

This property was introduced in QtQuick.VirtualKeyboard 6.1.

Access functions:

QVirtualKeyboardObserver * keyboardObserver() const

`[read-only]` locale : const QString

This property holds the locale.

This property is changed when the input locale changes.

Access functions:

QString locale() const

Notifier signal:

void	localeChanged()

preeditText : QString

This property holds the pre-edit text.

This property sets the pre-edit text.

Access functions:

QString	preeditText() const
void	setPreeditText(const QString &text, QList<QInputMethodEvent::Attribute> attributes = QList<QInputMethodEvent::Attribute>(), int replaceFrom = 0, int replaceLength = 0)

Notifier signal:

void	preeditTextChanged()

`[read-only]` selectedText : const QString

This property holds the selected text.

This property is changed when the selected text changes.

Access functions:

QString selectedText() const

Notifier signal:

void	selectedTextChanged()

`[read-only]` selectionControlVisible : const bool

Holds true if the selection control is currently visible.

Access functions:

bool	isSelectionControlVisible() const

Notifier signal:

void	selectionControlVisibleChanged()

`[read-only]` shiftActive : const bool

This property holds the shift status.

This property is changed when the shift status changes.

Access functions:

bool	isShiftActive() const

Notifier signal:

void	shiftActiveChanged()

`[read-only]` surroundingText : const QString

This property holds the surrounding text around cursor.

This property is changed when the surrounding text around the cursor changes.

Access functions:

QString surroundingText() const

Notifier signal:

void	surroundingTextChanged()

`[read-only]` uppercase : const bool

This property holds the uppercase status.

This property is true when either shiftActive or capsLockActive is true.

Access functions:

bool	isUppercase() const

Notifier signal:

void	uppercaseChanged()

Member Function Documentation

`[invokable]` void QVirtualKeyboardInputContext::clear()

Clears the pre-edit text.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

`[invokable]` void QVirtualKeyboardInputContext::commit()

Commits the current pre-edit text.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

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

Commits the final text to the input item and optionally modifies the text relative to the start of the pre-edit text. If replaceFrom is non-zero, the text replaces the contents relative to replaceFrom with a length of replaceLength.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

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

Sends a key click event with the given key, text and modifiers to the input item that currently has focus.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

Contents

QVirtualKeyboardInputContext Class

Properties

Public Functions

Signals

Detailed Description

Property Documentation

[read-only] anchorPosition : const int

[read-only] anchorRectIntersectsClipRect : const bool

[read-only] anchorRectangle : const QRectF

animating : bool

[read-only] capsLockActive : const bool

[read-only] cursorPosition : const int

[read-only] cursorRectIntersectsClipRect : const bool

[read-only] cursorRectangle : const QRectF

[read-only] inputEngine : QVirtualKeyboardInputEngine* const

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

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

[read-only] locale : const QString

preeditText : QString

[read-only] selectedText : const QString

[read-only] selectionControlVisible : const bool

[read-only] shiftActive : const bool

[read-only] surroundingText : const QString

[read-only] uppercase : const bool

Member Function Documentation

[invokable] void QVirtualKeyboardInputContext::clear()

[invokable] void QVirtualKeyboardInputContext::commit()

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

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

`[read-only]` anchorPosition : const int

`[read-only]` anchorRectIntersectsClipRect : const bool

`[read-only]` anchorRectangle : const QRectF

`[read-only]` capsLockActive : const bool

`[read-only]` cursorPosition : const int

`[read-only]` cursorRectIntersectsClipRect : const bool

`[read-only]` cursorRectangle : const QRectF

`[read-only]` inputEngine : QVirtualKeyboardInputEngine* const

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

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

`[read-only]` locale : const QString

`[read-only]` selectedText : const QString

`[read-only]` selectionControlVisible : const bool

`[read-only]` shiftActive : const bool

`[read-only]` surroundingText : const QString

`[read-only]` uppercase : const bool

`[invokable]` void QVirtualKeyboardInputContext::clear()

`[invokable]` void QVirtualKeyboardInputContext::commit()

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

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