編輯:Android開發實例
正文
一、結構
public interface InputMethod extends Object
android.view.inputmethod.InputMethod
間接子類
AbstractInputMethodService.AbstractInputMethodImpl, InputMethodService.InputMethodImpl
二、類概述
InputMethod接口代表了輸入法,它可生成按鍵事件,生成文本,如數字,email地址,CJK字符,其它語言字符等等。在處理輸入事件時,將文本返回至需要文本輸入的應用程序。InputMethodManager
可得到更多關於架構的信息。
應用程序通常不使用這個接口本身,而是依靠TextView 和 EditText提供的標准交互。
輸入法實現通常為InputMethodService
及其子類的派生。在實現輸入法時,包含它的服務控件必須提供SERVICE_META_DATA
元數據字段,該元數據字段聯接至一包含輸入法細節的XML資源。所有輸入法也必定要求客戶端包含BIND_INPUT_METHOD
以便與服務控件交互。如果不這樣,系統將無法使用輸入法,因其無法確認是否完整。
createSession(android.view.inputmethod.InputMethod.SessionCallback)
可實例化InputMethodSession
副接口,用於與客戶端通訊。
三、內部類
interface InputMethod.SessionCallback
四、常量
public static final String SERVICE_INTERFACE
接口名字,實現輸入法的服務應說明它支持輸入法,也就是它將用於意向過濾器(intent filter)。服務還需要BIND_INPUT_METHOD
權限,這樣應用程序不會濫用它。
常量值: "android.view.InputMethod"
public static final String SERVICE_META_DATA
輸入法通過此名字發布其自身信息。此元數據必須引用一個包含< input-method
>標簽的XML資源。
常量值: "android.view.im"
public static final int SHOW_EXPLICIT
用於showSoftInput(int, ResultReceiver)
的標志:它表示用戶顯式地要求其(軟鍵盤)顯示。如果沒有設置,系統決定可能是一個好主意,顯示輸入法在用戶界面上的導航操作。
常量值: 1 (0x00000001)
public static final int SHOW_FORCED
標志用於showSoftInput(int, ResultReceiver)
:表明用戶強制其(軟鍵盤)顯示。如設置,輸入法保持可見直至用戶在UI上取消。
常量值: 2 (0x00000002)
五、公共方法
public abstract void attachToken (IBinder token)
輸入法創建後首先被調用,它提供一個與系統服務會話的唯一令牌。它需要通過服務識別輸入法從而驗證其操作。令牌不能傳遞給應用程序,因其取得了應用程序不應得到的特殊權限。
注意:為避免惡意客戶端傷害,你應只接收第一個令牌。其後可能來自客戶端。
public abstract void bindInput (InputBinding binding)
將輸入法與新的應用程序環境綁定,以便稍後啟動、停止輸入處理。通常在應用程序第一次啟用輸入法時調用此方法。
參數
binding 與輸入法綁定的應用程序窗口信息。
參見
InputBinding
unbindInput()
public abstract void createSession (InputMethod.SessionCallback callback)
創建一個新的InputMethodSession,它可處理客戶應用程序與輸入法的交互。你可以隨後用revokeSession(InputMethodSession)
銷毀會話,這樣就不會有任何客戶端使用它。
參數
callback 新創建會話調用的接口。
public abstract void hideSoftInput (int flags, ResultReceiver resultReceiver)
將輸入法的軟鍵盤(soft input)部分對用戶隱藏。
參數
flags 顯示要求的附加信息。當前總是0。
resultReceiver 向要求顯示的客戶端通知結果。其結果可能為InputMethodManager.RESULT_UNCHANGED_SHOWN, InputMethodManager.RESULT_UNCHANGED_HIDDEN,InputMethodManager.RESULT_SHOWN, 或 InputMethodManager.RESULT_HIDDEN
public abstract void restartInput (InputConnection inputConnection, EditorInfo attribute)
輸入法需重置時調用此方法。
通常輸入焦點從一個文本框移至另一個時調用此方法。
參數
inputConnection 可選,確定與文本框通訊的輸入通訊通道;如為空,你使用通常綁定的輸入通訊通道。
attribute 文本框(通常是EditText)需要輸入的屬性
參見
EditorInfo
public abstract void revokeSession (InputMethodSession session)
關閉並銷毀先前由createSession(android.view.inputmethod.InputMethod.SessionCallback)
創建的會話。調用後,會話不再有效,對其的調用將失敗。
參數
session 先前由SessionCallback.sessionCreated()提供的InputMethodSession將被吊銷。
public abstract void setSessionEnabled (InputMethodSession session, boolean enabled).
控制某特定輸入法會話是否激活。
參數
session 先前由SessionCallback.sessionCreated()提供的InputMethodSession將改變。
public abstract void showSoftInput (int flags, ResultReceiver resultReceiver)
將輸入法的軟鍵盤(soft input)部分對用戶顯示。
參數
flags 提供顯示要求的附加信息。當前為0或設置SHOW_EXPLICIT 位。
resultReceiver 向要求顯示的客戶端通知結果。其結果可能為InputMethodManager.RESULT_UNCHANGED_SHOWN, InputMethodManager.RESULT_UNCHANGED_HIDDEN,InputMethodManager.RESULT_SHOWN, 或 InputMethodManager.RESULT_HIDDEN
public abstract void startInput (InputConnection inputConnection, EditorInfo info)
應用程序開始接收文本,輸入法准備好為應用程序處理接收事件並返回文本時調用本方法。
參數
inputConnection 可選,確定與文本框通訊的輸入通訊通道;如為空,你使用通常綁定的輸入通訊通道。
info 需要輸入的文本框(通常是EditText)信息。
參見
EditorInfo
public abstract void unbindInput ()
解除與應用程序的綁定,先前由bindInput(InputBinding)
設定的信息對當前輸入法無效時調用。
相關文章android popwindow實現左側彈出菜單層http://www.jb51.net/article/33533.htm移動App設計的13大精髓h
登錄應用程序的屏幕,詢問憑據登錄到一些特定的應用。可能需要登錄到Facebook,微博等本章介紹了,如何創建一個登錄界面,以及如何管理安全問題和錯誤嘗試。首先,必須定義兩
可以顯示在的Android任務,通過加載進度條的進展。進度條有兩種形狀。加載欄和加載微調(spinner)。在本章中,我們將討論微調(spinner)。Spinner 用
在Android 中有一種服務說是服務其實倒不如說是一個接口,這個接口名為:Android Interface Definition Language ,這個接口