SelectionListModel QML Type

Provides a data model for the selection lists. 更多...

导入语句: import QtQuick.VirtualKeyboard 2.15
实例化: QVirtualKeyboardSelectionListModel

信号

方法

详细描述

The SelectionListModel is a data model for word candidates provided by the input method.

An instance of a SelectionListModel cannot be created directly. Instead, the InputEngine manages the instances and provides access to the model by InputEngine::wordCandidateListModel 特性。

The model exposes the following data roles for the list delegate:

  • display Display text for item.
  • wordCompletionLength Word completion length for item.
  • dictionaryType Dictionary type of the word, see QVirtualKeyboardSelectionListModel::DictionaryType .
  • canRemoveSuggestion A boolean indicating if the word can be removed from the dictionary.

activeItemChanged signal indicates which item is currently highlighted by the input method. The view should respond to this signal by highlighting the corresponding item in the list.

The user selection is handled by the selectItem() method. The view should be invoke this method when the user selects an item from the list.

信号文档编制

void activeItemChanged ( int index )

This signal is emitted when the active item in the list changes. The UI should react to this signal by highlighting the item at index 在列表中。

注意: 相应处理程序是 onActiveItemChanged .


void itemSelected ( int index )

This signal is emitted when an item at index is selected by the user.

注意: 相应处理程序是 onItemSelected .


方法文档编制

void removeItem ( int index )

This method should be called when the user removes an item at position index from the list. The removal is forwarded to the input method for further processing.


void selectItem ( int index )

This method should be called when the user selects an item at position index from the list. The selection is forwarded to the input method for further processing.