您的位置:首页 > 移动开发 > Android开发

Android 3.0 r1中文API文档(103) —— InputMethodManager [输入法]

2014-07-08 09:02 543 查看
前言

  本章内容是android.view.inputmethod.InputMethodManager,为输入法相关章节,版本为Android 3.0 r1,翻译来自"六必治",欢迎大家访问他的博客:http://www.cnblogs.com/zcmky/,再次感谢"六必治"
!期待你加入Android API 中文的翻译,联系我over140@gmail.com。

声明

  欢迎转载,但请保留文章原始出处:)

    博客园:http://www.cnblogs.com/

    Android中文翻译组:http://goo.gl/6vJQl

正文

  一、结构

public final class
InputMethodManager extends
Object


java.lang.Object
android.view.inputmethod.InputMethodManager

  二、类概述

  整个输入法框架(IMF)结构的核心API,应用程序之间进行调度和当前输入法交互。你可以用
Context.getSystemService()
取得这一接口的实例。
  架构总述(Architecture Overview)
  输入法框架(IMF)共有三个主要部分:
  *
输入法管理器,管理各部分的交互。它是一个客户端API,存在于各个应用程序的context中,用来沟通管理所有进程间交互的全局系统服务。
  *
输入法(IME)
,实现一个允许用户生成文本的独立交互模块。系统绑定一个当前的输入法。使其创建和生成,决定输入法何时隐藏或者显示它的UI。同一时间只能有一个IME运行。
  *
客户应用程序,通过输入法管理器控制输入焦点和IME的状态。一次只能有一个客户端使用IME。
  应用程序(Applications)
  大多数情况下,使用标准TextView或其子类的应用程序只要做少量工作就可以让软键盘(soft input methods)正常工作。你要注意的是:
  *
正确设置你的可编辑文本视图
inputType
,这样输入法有足够的上下文帮助用户向其输入文本。
  *
当输入法显示时妥善处理隐藏屏幕空间。理想的情况下应用程序应处理窗口变小,如必要你可以利用系统执行平移窗口。你应在活动(activity)中设置
windowSoftInputMode
属性或调整创建窗口的相应值,以便系统决定平移或缩放(它会尝试自动调整但可能出错)。
  *
你还可以通过相同的
windowSoftInputMode
控制窗口的首选软键盘状态(打开、关闭等)。
  通过API可以与IMF及其IME交互实现更细致的控制,如显示或输入区域,用户选取某输入法等。
  当你编写自己的文本编辑器的时候,你要实现
onCreateInputConnection(EditorInfo)
以返回你的
InputConnection
的接口实例,用来允许IME和你的文本编辑域来交互。
    输入法(Input Methods)

  一个输入法(IME)是
Service
(服务)的实现,通常继承自
InputMethodService
。IME提供核心的
InputMethod
接口,尽管提供
InputMethod
通常是由
InputMethodService
来处理,而IME的实现只需要处理更高层的API。
更多信息参阅
InputMethodService


    安全(Security)

  输入法关系到许多安全问题,因其基本不受约束地驱动UI并监视用户输入。Android输入法框架还允许调度第三方IME,所必须小心以限制他们的选择和相互作用。
  以下是IMF背后安全架构的要点:
*
只允许系统访问经
BIND_INPUT_METHOD
权限
许可访问IME的
InputMethod
接口。通过绑定到要求这个权限的服务来强制实现这一点。所以系统可以保证没有不被信任的客户端在它的控制之外访问到当前的输入法。
*
IMF中可能有许多客户进程,但在同一时间只有一个是激活的。未激活客户端不能与IMF核心交互通过下述机制实现。
*
输入法客户端只可访问
InputMethodSession
接口。每个客户端创建一个接口实例,只有与激活客户相关联的会话的调用才会被IME处理。这点通过普通IME的
AbstractInputMethodService执行,必须由IME显式的处理,而IME正是
InputMethodSession
的自定义实现。
*
只有激活的
InputConnection
接受操作。IMF通知每个客户进程是否激活,IMF忽略非激活进程对当前输入联接的调用。这确保了当前IME只将事件和文本编辑交付用户可见焦点的UI。
*
一个IME永远不能在屏幕关闭时与
InputConnection
交互。这是通过当屏幕关闭时所有客户端无效,并防止不良IME在用户无法关注其行为时驱动UI。
*
客户应用程序可以要求系统选取一个新的IME,但不能编程式选择之一。这是避免恶意程序在用户导航到其它应用程序时,选择自己的IME并保持运行。也就是说,IME可以编程式的要求系统选择其它IME,因它完全控制了用户输入。
    用户在可切换至一个新的IME前必须显式的启用它,以确认系统了解它,使其处于可用状态。

  三、常量

    public static final int
HIDE_IMPLICIT_ONLY

hideSoftInputFromWindow(IBinder,
int)
中的标志,表示如果用户未显式地显示软键盘窗口,则隐藏窗口。

  常量值: 1 (0x00000001)

    public static final int
HIDE_NOT_ALWAYS

    
hideSoftInputFromWindow(IBinder,
int)
中的标志,表示软键盘窗口总是隐藏,除非开始时以
SHOW_FORCED
显示。

    常量值: 2 (0x00000002)

    public static final int
RESULT_HIDDEN

    
showSoftInput(View,
int, ResultReceiver)
hideSoftInputFromWindow(IBinder,
int, ResultReceiver)
ResultReceiver
结果代码标志:软键盘窗口从显示切换到隐藏时的状态。

    常量值: 3 (0x00000003)

    public static final int
RESULT_SHOWN

    
showSoftInput(View,
int, ResultReceiver)
hideSoftInputFromWindow(IBinder,
int, ResultReceiver)
ResultReceiver
结果代码标志:软键盘窗口从隐藏切换到显示时的状态。

    常量值: 2 (0x00000002)

    public static final int
RESULT_UNCHANGED_HIDDEN

    
showSoftInput(View,
int, ResultReceiver)
hideSoftInputFromWindow(IBinder,
int, ResultReceiver)
ResultReceiver
结果代码标志:软键盘窗口不变保持隐藏时的状态。

    常量值: 1 (0x00000001)

    public static final int
RESULT_UNCHANGED_SHOWN

    
showSoftInput(View,
int, ResultReceiver)
hideSoftInputFromWindow(IBinder,
int, ResultReceiver)
ResultReceiver
结果代码标志:软键盘窗口不变保持显示时的状态。

    常量值: 0 (0x00000000)

    public static final int
SHOW_FORCED

    
showSoftInput(View,
int)
标志,表示用户强制打开输入法(如长按菜单键),一直保持打开直至只有显式关闭。

    常量值: 2 (0x00000002)

    public static final int
SHOW_IMPLICIT

   
showSoftInput(View,
int)
标志,表示隐式显示输入窗口,非用户直接要求。窗口可能不显示。

      常量值: 1 (0x00000001)

  四、公共方法

    public void
displayCompletions (View view, CompletionInfo[] completions)

    (译者注:输入法自动完成)

    public InputMethodSubtype
getCurrentInputMethodSubtype ()

    (译者注:获取当前输入法类型?)

    public List<InputMethodInfo>
getEnabledInputMethodList ()

    (译者注:获取已启用输入法列表?)

    public List<InputMethodSubtype> getEnabledInputMethodSubtypeList (InputMethodInfo imi, boolean allowsImplicitlySelectedSubtypes)

    public List<InputMethodInfo>
getInputMethodList ()

    (译者注:获取输入法列表)

    public Map<InputMethodInfo, List<InputMethodSubtype>>
getShortcutInputMethodsAndSubtypes ()

    public void
hideSoftInputFromInputMethod (IBinder token, int flags)

    关闭/隐藏输入法软键盘区域,用户不再看到或与其交互。只能由当前激活输入法调用,因需令牌(token)验证。

    参数
    token
在输入法启动时提供令牌验证,验证后可对其进行操作。
    flags
提供额外的操作标志。当前可以为0或
HIDE_IMPLICIT_ONLY
,
HIDE_NOT_ALWAYS
等位设置。

    public boolean
hideSoftInputFromWindow (IBinder windowToken, int flags)

   
hideSoftInputFromWindow(IBinder,
int, ResultReceiver)
的无返回值版:从窗口上下文中确定当前接收输入的窗口,隐藏其输入法窗口

    参数
    windowToken
由窗口请求
View.getWindowToken()
返回得到的令牌(token)。
    flags
提供额外的操作标志。当前可以为0或
HIDE_IMPLICIT_ONLY
位设置。

    public boolean
hideSoftInputFromWindow (IBinder windowToken, int flags, ResultReceiver resultReceiver)

    从窗口上下文中确定当前接收输入的窗口,要求隐藏其软键盘窗口。它可由用户调用并得到结果而不仅仅是显式要求输入法窗口隐藏。

    参数
    windowToken
由窗口请求
View.getWindowToken()
返回得到的令牌(token)。
    flags
提供额外的操作标志。当前可以为0或
HIDE_IMPLICIT_ONLY
位设置。
        resultReceiver 如不为空,当IME处理请求告诉你完成时调用。你收到的结果码可以是
RESULT_UNCHANGED_SHOWN
,
RESULT_UNCHANGED_HIDDEN
,
RESULT_SHOWN
,
RESULT_HIDDEN


    public void
hideStatusIcon (IBinder imeToken)

    (译者注:隐藏状态栏图标?)

    public boolean
isAcceptingText ()

    当前服务视图接受全文编辑返回真。没有输入法联接为false,这时其只能处理原始按键事件。

    public boolean
isActive (View view)

    视图为当前输入的激活视图时返回真。

    public boolean
isActive ()

    输入法中的任意视图激活时返回真。

    public boolean
isFullscreenMode ()

    判断相关输入法是否以全屏模式运行。全屏时,完全覆盖你的UI时,返回真,否则返回假。

    public boolean
isWatchingCursor (View view)

    如当前输入法要看到输入编辑者的光标位置时返回真。

    public void
restartInput (View view)

    如有输入法联接至视图,重启输入以显示新的内容。可在以下情况时调用此方法:视图的文字导致输入法外观变化或有按键输入流,如应用程序调用TextView.setText()时。

  
参数

    view
文字发生变化的视图。

    public void
sendAppPrivateCommand (View view, String action, Bundle data)

    对当前输入法调用
InputMethodSession.appPrivateCommand()


  参数

    view
可选的发送命令的视图,如你要发送命令而不考虑视图附加到输入法,此项可以为空。
    action
执行的命令名称。必须是作用域的名称,如前缀包名称,这样不同的开发者就不会创建冲突的命令。
    data
命令中包含的任何数据。

    public boolean
setCurrentInputMethodSubtype (InputMethodSubtype subtype)

    (译者注:此方法为3.0中新增的方法)

    public void
setInputMethod (IBinder token, String id)

    强制切换到新输入法部件。只能由持有token的应用程序(application)或服务(service)
调用当前激活输入法。

  
参数

    token
在输入法启动时提供令牌验证,验证后可对其进行操作。
    id
切换到新输入法的唯一标识。

    public void
setInputMethodAndSubtype (IBinder token, String id, InputMethodSubtype subtype)

    强制切换到一个新的输入法和指定的类型。只能由持有token的应用程序(application)或服务(service)
调用当前激活输入法。(译者注:此方法为3.0中新增的方法)

  
参数

    token
在输入法启动时提供令牌验证,验证后可对其进行操作。
    id
切换到新输入法的唯一标识。
    subtype
切换到新输入法的新类型。

    public void
showInputMethodAndSubtypeEnabler (String topId)

    (译者注:此方法为3.0中新增的方法)

    public void
showInputMethodPicker ()

    (译者注:显示输入法菜单列表)

    public boolean
showSoftInput (View view, int flags, ResultReceiver resultReceiver)

    如需要,显式要求当前输入法的软键盘区域向用户显示。当用户与视图交互,用户表示要开始执行输入操作时,可以调用此方法。

  参数

    view
当前焦点视图,可接受软键盘输入。
    flags
提供额外的操作标志。当前可以是0或
SHOW_IMPLICIT

位设置。
    resultReceiver
如不为空,当IME处理请求告诉你完成时调用。你收到的结果码可以是
RESULT_UNCHANGED_SHOWN
,
RESULT_UNCHANGED_HIDDEN
,
RESULT_SHOWN
,
RESULT_HIDDEN



    public boolean
showSoftInput (View view, int flags)

showSoftInput(View,
int, ResultReceiver)
的无返回值版:如需要,显式要求当前输入法的软键盘区域向用户显示。

  参数

    view
当前焦点视图,可接受软键盘输入。
    flags
提供额外的操作标志。当前可以是0或
SHOW_IMPLICIT

位设置。

    public void
showSoftInputFromInputMethod (IBinder token, int flags)

    显示输入法的软键盘区域,这样用户可以到看到输入法窗口并能与其交互。只能由当前激活输入法调用,因需令牌(token)验证。

  参数

    token
在输入法启动时提供令牌验证,验证后可对其进行操作。
    flags
提供额外的操作标志。可以是0或
SHOW_IMPLICIT
,
SHOW_FORCED
位设置。

    public void
showStatusIcon (IBinder imeToken, String packageName, int iconId)

    (译者注:显示状态栏图标?)

    public boolean
switchToLastInputMethod (IBinder imeToken)

    public void
toggleSoftInput (int showFlags, int hideFlags)

    (译者注:切换软键盘)

    public void
toggleSoftInputFromWindow (IBinder windowToken, int showFlags, int hideFlags)

    本方法切换输入法的窗口显示。如输入窗口已显示,它隐藏。如无输入窗口则显示。

  参数

    windowToken 由窗口请求
View.getWindowToken()
返回得到的令牌(token)。
    showFlags
提供额外的操作标志。当前可以为0或
HIDE_IMPLICIT_ONLY
位设置。
    hideFlags
提供额外的操作标志。可以是0或
HIDE_IMPLICIT_ONLY
,
HIDE_NOT_ALWAYS
位设置。

    public void
updateCursor (View view, int left, int top, int right, int bottom)

    返回窗口的当前光标位置。

    public void
updateExtractedText (View view, int token, ExtractedText text)

    (译者注:当内容变化时文本编辑器调用此方法,通知其新提取文本。)

    public void
updateSelection (View view, int selStart, int selEnd, int candidatesStart, int candidatesEnd)

    返回当前选择区域。

  五、补充

文章精选
android
软键盘 InputMethodManager
Android输入法框的梳理
[推荐]android
输入法框架简介
开源拼音输入法社区的大融合(libpinyin)
android中文输入法实现

结束

  越忙越需要坚持。
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: