SpellCheckerService.Session


public static abstract class SpellCheckerService.Session
extends Object

java.lang.Object
   ↳ android.service.textservice.SpellCheckerService.Session


This abstract class should be overridden by a concrete implementation of a spell checker.

Summary

Public constructors

Session()

Public methods

Bundle getBundle()
String getLocale()
int getSupportedAttributes()

Returns result attributes supported for this session.

void onCancel()

Request to abort all tasks executed in SpellChecker.

void onClose()

Request to close this session.

abstract void onCreate()

This is called after the class is initialized, at which point it knows it can call getLocale() etc...

SentenceSuggestionsInfo[] onGetSentenceSuggestionsMultiple(TextInfo[] textInfos, int suggestionsLimit)

Get sentence suggestions for specified texts in an array of TextInfo.

abstract SuggestionsInfo onGetSuggestions(TextInfo textInfo, int suggestionsLimit)

Get suggestions for specified text in TextInfo.

SuggestionsInfo[] onGetSuggestionsMultiple(TextInfo[] textInfos, int suggestionsLimit, boolean sequentialWords)

A batch process of onGetSuggestions.

Inherited methods

Public constructors

Session

public Session ()

Public methods

getBundle

Added in API level 14
public Bundle getBundle ()

Returns
Bundle Bundle for this session

getLocale

Added in API level 14
public String getLocale ()

Returns
String Locale for this session

getSupportedAttributes

Added in API level 31
public int getSupportedAttributes ()

Returns result attributes supported for this session.

The session implementation should not set attributes that are not included in the return value of getSupportedAttributes() when creating SuggestionsInfo.

Returns
int The supported result attributes for this session Value is either 0 or a combination of SuggestionsInfo.RESULT_ATTR_IN_THE_DICTIONARY, SuggestionsInfo.RESULT_ATTR_LOOKS_LIKE_TYPO, SuggestionsInfo.RESULT_ATTR_HAS_RECOMMENDED_SUGGESTIONS, SuggestionsInfo.RESULT_ATTR_LOOKS_LIKE_GRAMMAR_ERROR, and SuggestionsInfo.RESULT_ATTR_DONT_SHOW_UI_FOR_SUGGESTIONS

onCancel

Added in API level 14
public void onCancel ()

Request to abort all tasks executed in SpellChecker. This function will run on the incoming IPC thread. So, this is not called on the main thread, but will be called in series on another thread.

onClose

Added in API level 15
public void onClose ()

Request to close this session. This function will run on the incoming IPC thread. So, this is not called on the main thread, but will be called in series on another thread.

onCreate

Added in API level 14
public abstract void onCreate ()

This is called after the class is initialized, at which point it knows it can call getLocale() etc...

onGetSentenceSuggestionsMultiple

Added in API level 16
public SentenceSuggestionsInfo[] onGetSentenceSuggestionsMultiple (TextInfo[] textInfos, 
                int suggestionsLimit)

Get sentence suggestions for specified texts in an array of TextInfo. The default implementation splits the input text to words and returns SentenceSuggestionsInfo which contains suggestions for each word. This function will run on the incoming IPC thread. So, this is not called on the main thread, but will be called in series on another thread. When you override this method, make sure that suggestionsLimit is applied to suggestions that share the same start position and length.

Parameters
textInfos TextInfo: an array of the text metadata

suggestionsLimit int: the maximum number of suggestions to be returned

Returns
SentenceSuggestionsInfo[] an array of SentenceSuggestionsInfo returned by SpellCheckerService.Session#onGetSuggestions(TextInfo, int)

onGetSuggestions

Added in API level 14
public abstract SuggestionsInfo onGetSuggestions (TextInfo textInfo, 
                int suggestionsLimit)

Get suggestions for specified text in TextInfo. This function will run on the incoming IPC thread. So, this is not called on the main thread, but will be called in series on another thread.

Parameters
textInfo TextInfo: the text metadata

suggestionsLimit int: the maximum number of suggestions to be returned

Returns
SuggestionsInfo SuggestionsInfo which contains suggestions for textInfo

onGetSuggestionsMultiple

Added in API level 14
public SuggestionsInfo[] onGetSuggestionsMultiple (TextInfo[] textInfos, 
                int suggestionsLimit, 
                boolean sequentialWords)

A batch process of onGetSuggestions. This function will run on the incoming IPC thread. So, this is not called on the main thread, but will be called in series on another thread.

Parameters
textInfos TextInfo: an array of the text metadata

suggestionsLimit int: the maximum number of suggestions to be returned

sequentialWords boolean: true if textInfos can be treated as sequential words.

Returns
SuggestionsInfo[] an array of SentenceSuggestionsInfo returned by SpellCheckerService.Session#onGetSuggestions(TextInfo, int)