內容

• 特性
• 信號
• 方法
• 詳細描述

InputEngine QML 類型

將用戶輸入映射到輸入法。 更多...

import 語句：	import QtQuick.VirtualKeyboard 2.4
實例化：	QVirtualKeyboardInputEngine

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

特性

• activeKey : int
• inputMethod : InputMethod
• inputMode : int
• inputModes : list<int>
• patternRecognitionModes : list<int>
• previousKey : int
• wordCandidateListModel : QVirtualKeyboardSelectionListModel
• wordCandidateListVisibleHint : bool

信號

• void activeKeyChanged (int key )
• void inputMethodChanged ()
• void inputMethodReset ()
• void inputMethodUpdate ()
• void inputModeChanged ()
• void inputModesChanged ()
• void patternRecognitionModesChanged ()
• void previousKeyChanged (int key )
• void virtualKeyClicked (int key , string text , int modifiers )

方法

• QVirtualKeyboardTrace traceBegin (int traceId , int patternRecognitionMode , var traceCaptureDeviceInfo , var traceScreenInfo )
• bool traceEnd (Trace trace )
• void virtualKeyCancel ()
• bool virtualKeyClick (int key , string text , int modifiers )
• bool virtualKeyPress (int key , string text , int modifiers , bool repeat )
• bool virtualKeyRelease (int key , string text , int modifiers )

詳細描述

輸入引擎負責把輸入事件路由到輸入法。實際輸入邏輯由輸入法實現。

輸入引擎還包括默認輸入法，負責默認處理若活動輸入法不處理事件。

特性文檔編製

activeKey : int

目前按下的鍵。

inputMethod : InputMethod

Use this property to set the active input method, or to monitor when the active input method changes.

inputMode : int

Use this property to get or set the current input mode. The InputEngine::inputModes property provides the list of valid input modes for the current input method and locale.

The predefined input modes are:

• InputEngine.InputMode.Latin 用於拉丁文本的默認輸入方式。
• InputEngine.InputMode.Numeric Only numeric input is allowed.
• InputEngine.InputMode.Dialable Only dialable input is allowed.
• InputEngine.InputMode.Pinyin Pinyin input mode for Chinese.
• InputEngine.InputMode.Cangjie Cangjie input mode for Chinese.
• InputEngine.InputMode.Zhuyin Zhuyin input mode for Chinese.
• InputEngine.InputMode.Hangul Hangul input mode for Korean.
• InputEngine.InputMode.Hiragana Hiragana input mode for Japanese.
• InputEngine.InputMode.Katakana Katakana input mode for Japanese.
• InputEngine.InputMode.FullwidthLatin Fullwidth latin input mode for East Asian languages.
• InputEngine.InputMode.Greek 希臘語輸入方式。
• InputEngine.InputMode.Cyrillic 西裏爾輸入方式。
• InputEngine.InputMode.Arabic 阿拉伯語輸入方式。
• InputEngine.InputMode.Hebrew 希伯來語輸入方式。
• InputEngine.InputMode.ChineseHandwriting Chinese handwriting.
• InputEngine.InputMode.JapaneseHandwriting Japanese handwriting.
• InputEngine.InputMode.KoreanHandwriting Korean handwriting.
• InputEngine.InputMode.Thai 泰語輸入方式。

inputModes : list < int >

The list of available input modes is dependent on the input method and locale. This property is updated when either of the dependencies change.

patternRecognitionModes : list < int >

The list of available pattern recognition modes.

可能的值：

常量	描述
InputEngine.PatternRecognitionMode.None	Pattern recognition is not available.
InputEngine.PatternRecognitionMode.PatternRecognitionDisabled	obsolete - Use None 代替。
InputEngine.PatternRecognitionMode.Handwriting	Pattern recognition mode for handwriting recognition.
InputEngine.PatternRecognitionMode.HandwritingRecoginition	obsolete - Use Handwriting 代替。

該特性在 QtQuick.VirtualKeyboard 2.0 引入。

previousKey : int

先前按下的鍵。

wordCandidateListModel : QVirtualKeyboardSelectionListModel

Use this property to access the list model for the word candidate list.

wordCandidateListVisibleHint : bool

Use this property to check if the word candidate list should be visible in the UI.

信號文檔編製

void activeKeyChanged ( int key )

指示活動 key 已改變。

void inputMethodChanged ()

指示輸入法已改變。

void inputMethodReset ()

發射當需要重置輸入法時。

注意： 此信號會被自動連接到 QVirtualKeyboardAbstractInputMethod::reset() and InputMethod::reset() when the input method is activated.

void inputMethodUpdate ()

注意： 此信號會被自動連接到 QVirtualKeyboardAbstractInputMethod::update() and InputMethod::update() when the input method is activated.

void inputModeChanged ()

指示輸入方式已改變。

void inputModesChanged ()

指示可用輸入方式已改變。

void patternRecognitionModesChanged ()

Indicates that the available pattern recognition modes have changed.

The predefined pattern recognition modes are:

• InputEngine.PatternRecognitionMode.None Pattern recognition is not available.
• InputEngine.PatternRecognitionMode.PatternRecognitionDisabled obsolete 使用 InputEngine .PatternRecognitionMode.None
• InputEngine.PatternRecognitionMode.Handwriting Pattern recognition mode for handwriting recognition.
• InputEngine.PatternRecognitionMode.HandwritingRecoginition obsolete 使用 InputEngine .PatternRecognitionMode.Handwriting

This signal was introduced in QtQuick.VirtualKeyboard 2.0.

void previousKeyChanged ( int key )

指示先前 key 已改變。

void virtualKeyClicked ( int key , string text , int modifiers )

指示虛擬 key was clicked with the given text and modifiers . This signal is emitted after the input method has processed the key event.

方法文檔編製

QVirtualKeyboardTrace traceBegin ( int traceId , int patternRecognitionMode , var traceCaptureDeviceInfo , var traceScreenInfo )

采用輸入引擎開始跟蹤交互。

The trace is uniquely identified by the traceId . The input engine will assign the id to the Trace object if the input method accepts the event.

The patternRecognitionMode specifies the recognition mode used for the pattern.

If the current input method accepts the event it returns a Trace object associated with this interaction. If the input method discards the event, it returns a null value.

The traceCaptureDeviceInfo 提供源設備的有關信息和 traceScreenInfo 提供屏幕上下文的有關信息。

By definition, the Trace object remains valid until the traceEnd() method is called.

The trace interaction is ended by calling the InputEngine.traceEnd() 方法。

This method was introduced in QtQuick.VirtualKeyboard 2.0.

bool traceEnd ( Trace trace )

Ends the trace interaction with the input engine.

The trace object may be discarded at any point after calling this function.

The function returns true if the trace interaction was accepted (i.e. the touch events should not be used for anything else).

void virtualKeyCancel ()

Reverts the active key state without emitting the key event. This method is useful when the user discards the current key and the key state needs to be restored.

bool virtualKeyClick ( int key , string text , int modifiers )

發射鍵點擊事件為給定 key , text and modifiers 。返迴 true 若輸入引擎接受鍵事件。

bool virtualKeyPress ( int key , string text , int modifiers , bool repeat )

Called by the keyboard layer to indicate that key was pressed, with the given text and modifiers .

The key is set as an active key (down key). The actual key event is triggered when the key is released by the virtualKeyRelease() method. The key press event can be discarded by calling virtualKeyCancel() .

The key press also initiates the key repeat timer if repeat is true .

返迴 true 若此輸入引擎接受鍵。

另請參閱 virtualKeyCancel() and virtualKeyRelease() .

bool virtualKeyRelease ( int key , string text , int modifiers )

釋放鍵如 key . The method emits a key event for the input method if the event has not been generated by a repeating timer. The text and modifiers are passed to the input method.

返迴 true 若輸入引擎接受鍵。