QVirtualKeyboardAbstractInputMethod 類

用於輸入法的基類。 更多...

頭：	#include <QVirtualKeyboardAbstractInputMethod>
qmake:	QT += virtualkeyboard
繼承：	QObject

• 所有成員列錶，包括繼承成員

公共函數

	QVirtualKeyboardAbstractInputMethod (QObject * parent = nullptr)
virtual	~QVirtualKeyboardAbstractInputMethod ()
virtual bool	clickPreeditText (int cursorPosition )
QVirtualKeyboardInputContext *	inputContext () const
QVirtualKeyboardInputEngine *	inputEngine () const
virtual QList<QVirtualKeyboardInputEngine::InputMode>	inputModes (const QString & locale ) = 0
virtual bool	keyEvent (Qt::Key key , const QString & text , Qt::KeyboardModifiers modifiers ) = 0
virtual QList<QVirtualKeyboardInputEngine::PatternRecognitionMode>	patternRecognitionModes () const
virtual bool	reselect (int cursorPosition , const QVirtualKeyboardInputEngine::ReselectFlags & reselectFlags )
virtual QVariant	selectionListData (QVirtualKeyboardSelectionListModel::Type type , int index , QVirtualKeyboardSelectionListModel::Role role )
virtual int	selectionListItemCount (QVirtualKeyboardSelectionListModel::Type type )
virtual void	selectionListItemSelected (QVirtualKeyboardSelectionListModel::Type type , int index )
virtual bool	selectionListRemoveItem (QVirtualKeyboardSelectionListModel::Type type , int index )
virtual QList<QVirtualKeyboardSelectionListModel::Type>	selectionLists ()
virtual bool	setInputMode (const QString & locale , QVirtualKeyboardInputEngine::InputMode inputMode ) = 0
virtual bool	setTextCase (QVirtualKeyboardInputEngine::TextCase textCase ) = 0
virtual QVirtualKeyboardTrace *	traceBegin (int traceId , QVirtualKeyboardInputEngine::PatternRecognitionMode patternRecognitionMode , const QVariantMap & traceCaptureDeviceInfo , const QVariantMap & traceScreenInfo )
virtual bool	traceEnd (QVirtualKeyboardTrace * trace )

公共槽

virtual void	reset ()
virtual void	update ()

信號

void	selectionListActiveItemChanged (QVirtualKeyboardSelectionListModel::Type type , int index )
void	selectionListChanged (QVirtualKeyboardSelectionListModel::Type type )
void	selectionListsChanged ()

詳細描述

使用此類，若想要使用 C/C++ 語言實現自定義輸入法。

成員函數文檔編製

QVirtualKeyboardAbstractInputMethod:: QVirtualKeyboardAbstractInputMethod ( QObject * parent = nullptr)

構造輸入法采用 parent .

[virtual slot] void QVirtualKeyboardAbstractInputMethod:: reset ()

This method is called by the input engine when the input method needs to be reset. The input method must reset its internal state only. The main difference to the update () method is that reset() modifies only the input method state, i.e. it must not modify the input context.

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

輸入法會發射此信號當當前 index 已改變在選定列錶標識通過 type .

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

The input method emits this signal when the contents of the selection list has changed. The type parameter specifies which selection list has changed.

[signal] void QVirtualKeyboardAbstractInputMethod:: selectionListsChanged ()

The input method emits this signal when the selection list types have changed. This signal will trigger a call to selectionLists () method, allowing the input method to update the selection list types.

該函數在 QtQuick.VirtualKeyboard 2.2 引入。

[virtual slot] void QVirtualKeyboardAbstractInputMethod:: update ()

This method is called by the input engine when the input method needs to be updated. The input method must close the current pre-edit text and restore its internal state to the default.

[虛擬] QVirtualKeyboardAbstractInputMethod:: ~QVirtualKeyboardAbstractInputMethod ()

銷毀輸入法並釋放所有分配資源。

[虛擬] bool QVirtualKeyboardAbstractInputMethod:: clickPreeditText ( int cursorPosition )

調用當用戶點擊預編輯文本在 cursorPosition .

函數應返迴 true 若它處理事件。否則輸入會迴退到 reselect () 為進一步處理。

該函數在 QtQuick.VirtualKeyboard 2.4 引入。

QVirtualKeyboardInputContext *QVirtualKeyboardAbstractInputMethod:: inputContext () const

返迴輸入法關聯的輸入上下文。此方法返迴 NULL 若輸入法不活動。

QVirtualKeyboardInputEngine *QVirtualKeyboardAbstractInputMethod:: inputEngine () const

返迴輸入法關聯的輸入引擎。此方法返迴 NULL 若輸入法不活動。

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

返迴輸入方式的列錶為 locale .

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

此方法的目的是, 處理由輸入引擎生成的鍵事件。

The key parameter specifies the code of the key to handle. The key code does not distinguish between capital and non-capital letters. The text parameter contains the Unicode text for the key. The modifiers parameter contains the key modifiers that apply to key.

此方法返迴 true if the key event was successfully handled. If the return value is false , the key event is redirected to the default input method for further processing.

[虛擬] QList < QVirtualKeyboardInputEngine::PatternRecognitionMode > QVirtualKeyboardAbstractInputMethod:: patternRecognitionModes () const

返迴支持模式識彆方式的列錶。

輸入引擎調用此方法，以查詢支持的模式識彆方式列錶。

該函數在 QtQuick.VirtualKeyboard 2.0 引入。

[虛擬] bool QVirtualKeyboardAbstractInputMethod:: reselect ( int cursorPosition , const QVirtualKeyboardInputEngine::ReselectFlags & reselectFlags )

此函數試圖重選的單詞位於 cursorPosition 。 reselectFlags 定義應如何選擇光標位置相關單詞的規則。

函數返迴 true 若單詞被成功重選。

該函數在 QtQuick.VirtualKeyboard 2.0 引入。

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

返迴選定列錶項數據標識通過 type 。 role 參數指定請求何種數據。 index 參數是列錶從 0 開始的索引。

[虛擬] int QVirtualKeyboardAbstractInputMethod:: selectionListItemCount ( QVirtualKeyboardSelectionListModel::Type type )

返迴選定列錶項數標識通過 type .

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

此方法被調用當項位於 index 被用戶選中。選定列錶的標識是通過 type 參數。

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

此方法被調用當項位於 index 必須被移除從字典。選定列錶的標識是通過 type 參數。函數返迴 true 若單詞被成功移除。

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

返迴用於此輸入法的選定列錶的列錶。

此方法由輸入引擎調用，當輸入法被激活且每次更新輸入法提示時。輸入法可以預留選定列錶，通過返迴期望的選定列錶類型。

輸入法可以請求輸入引擎隨時更新選定列錶通過發射 selectionListsChanged () 信號。此信號由此方法的調用所觸發，允許輸入法更新選定列錶類型。

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

設置 inputMode and locale 為此輸入法。返迴 true 若成功。

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

更新 textCase 為此輸入法。方法返迴 true 若成功。

[虛擬] QVirtualKeyboardTrace *QVirtualKeyboardAbstractInputMethod:: traceBegin ( int traceId , QVirtualKeyboardInputEngine::PatternRecognitionMode patternRecognitionMode , const QVariantMap & traceCaptureDeviceInfo , const QVariantMap & traceScreenInfo )

此方法被調用當開始跟蹤交互采用指定 patternRecognitionMode 。跟蹤的唯一標識是通過 traceId 。 traceCaptureDeviceInfo 提供源設備的有關信息和 traceScreenInfo 提供屏幕上下文的有關信息。

若輸入法接受事件且想要捕獲跟蹤輸入，它必須返迴新的 QVirtualKeyboardTrace 對象。此對象必須保持有效直到 traceEnd () 方法被調用。若 QVirtualKeyboardTrace 被渲染在屏幕中，它仍然在那裏直到 QVirtualKeyboardTrace 對象被銷毀。

該函數在 QtQuick.VirtualKeyboard 2.0 引入。

[虛擬] bool QVirtualKeyboardAbstractInputMethod:: traceEnd ( QVirtualKeyboardTrace * trace )

此方法被調用，當跟蹤交互結束時。輸入法應銷毀 trace 對象在某個時刻，在調用此函數後。見 用於輸入法的跟蹤 API 如何訪問聚閤數據。

方法返迴 true 若接受跟蹤交互。

該函數在 QtQuick.VirtualKeyboard 2.0 引入。

內容

1. 公共函數

2. 公共槽

3. 信號

4. 詳細描述