android 中文 api （87） —— BaseInputConnection

前言

聲明

　　歡迎轉載，但請保留文章原始出處:) 

正文

　　一、結構

public class baseinputconnection extends object implements inputconnection

java.lang.object

android.view.inputmethod.baseinputconnection

　　二、概述

　　三、公共方法

public boolean beginbatchedit ()

預設實作什麼也不做。

public boolean clearmetakeystates (int states)

參數

傳回值

成功傳回true，輸入連接配接無效時傳回false。

public boolean commitcompletion (completioninfo text)

text          送出的完成。

                       成功傳回true，輸入連接配接無效時傳回false。

public boolean committext (charsequence text, int newcursorposition)

預設實作将用給出的文本替代正在建構的文本。另外在虛拟狀态時，将發送包含新文本的按鍵事件并清空可編輯控件的緩存。

text          送出的文本。

newcursorposition          文本範圍内新光标位置。如> 0，從文本未尾－1起計算；如<= 0，從文本起始處計算。是以是1時總是在剛插入文本之後。注意這意味着你不能将位置定義在文本中，因為編輯器可以修改你送出的文本，是以無必要将光标定位在文本中。

public boolean deletesurroundingtext (int leftlength, int rightlength)

預設實作将删除目前光标位置附近的可編輯文本。

leftlength       删除文本在目前光标位置前的字元數

rightlength     删除文本在目前光标位置後的字元數。

成功傳回true，輸入連接配接無效時傳回false。。

public boolean endbatchedit ()

public boolean finishcomposingtext ()

預設實作将用給定的文本替代正在建構的文本。另外在虛拟狀态時，将發送包含新文本的按鍵事件并清空可編輯控件的緩存。

public static int getcomposingspanend (spannable text)

public static int getcomposingspanstart (spannable text)

public int getcursorcapsmode (int reqmodes)

預設實作時，由textutils.getcapsmode傳回目前可編輯文本的標明文本的光标大小寫狀态，虛拟狀态時總是傳回0。

傳回目前有效的大小寫狀态。

public editable geteditable ()

傳回編輯操作的目标。預設的實作是傳回自己的虛拟可編輯控件，子類須重載一個可編輯控件并提供給它自己。

public extractedtext getextractedtext (extractedtextrequest request, int flags)

預設實作總是傳回空。

request  描述如何傳回文本。

傳回extractedtext對象描述文本視窗的狀态并包含提取文本的本身。

public charsequence getselectedtext (int flags)

預設實作是傳回目前選擇文本，沒有選取則為空。

傳回目前選擇文本，沒有選取則為空。

public charsequence gettextaftercursor (int length, int flags)

預設的實作是傳回緩存中目前光标位置後給定數量的文本。

length     期望的文本長度。

傳回光标位置後的文本，傳回文本的長度可能小于n。

public charsequence gettextbeforecursor (int length, int flags)

預設的實作是傳回緩存中目前光标位置前給定數量的文本。

傳回光标位置前的文本，傳回文本的長度可能小于n。

public boolean performcontextmenuaction (int id)

預設實作是什麼也不做。

public boolean performeditoraction (int actioncode)

預設實作将其發送至傳回鍵(enter key)。

public boolean performprivatecommand (string action, bundle data)

action      執行的指令名稱。必須是作用域的名稱（譯者注：帶包名，如”com.test.command”），如以你自己的包名稱字首，這樣不同的開發者就不會建立産生沖突的指令。

data         指令中的資料。

指令發送傳回true（無論相關的編輯器是否了解它），如輸入連接配接無效傳回false。

public static final void removecomposingspans (spannable text)

public boolean reportfullscreenmode (boolean enabled)

以目前的全屏模式更新inputmethodmanager。

public boolean sendkeyevent (keyevent event)

提供視窗附屬輸入連接配接視窗的發送按鍵事件的标準實作。

event       按鍵事件。

public boolean setcomposingregion (int start, int end)

将特定區域标記為正在建構文本。任何以前設定的正在建構文本自動清除。正在建構文本應用預設樣式。

start        文本中正在建構區域開始位置。

end          文本中正在建構區域結束位置。

public static void setcomposingspans (spannable text)

public boolean setcomposingtext (charsequence text, int newcursorposition).

預設實作是将給定文本置入可編輯文本，替代任何正在建構文本。新文本标記為正在建構文本并應用建構樣式。

text          正在建構文本，如必要應用樣式。如文本無附屬樣式，将正在建構文本應用預設樣式。參見how to attach style object to the text。{#link android.text.spannablestring} 和{#link android.text.spannablestringbuilder}是實作的接口。

public boolean setselection (int start, int end)

預設實作是在目前可編輯文本中改變選取的位置。

轉自：http://www.cnblogs.com/over140/archive/2011/01/12/1933468.html