android api (83) —— InputMethodSession [输入法]
前言
本章内容是android.view.inputmethod.InputMethodSession,为输入法相关章节,版本为Android 2.3 r1,翻译来自"六必治",欢迎大家访问他的博客:http://www.cnblogs.com/zcmky/,再次感谢"六必治" !期待你加入Android API 中文的翻译,联系我over140@gmail.com。
声明
欢迎转载,但请保留文章原始出处:)
Android中文翻译组:http://code.taobao.org/project/view/404/
正文
一、结构
public interface InputMethodSession
android.view.inputmethod. InputMethodSession
间接子类
AbstractInputMethodService.AbstractInputMethodSessionImpl,InputMethodService.InputMethodSessionImpl
二、概述
InputMethodSession接口提供给每个客户端的InputMethod可安全地暴露在应用程序中。
应用程序通常不自己使用本接口,而是依靠TextView和EditText提供的标准交互。
三、内部类
interface InputMethodSession.EventCallback
四、公共方法
public abstract void appPrivateCommand (String action, Bundle data)
执行由应用程序发往输入法的私有命令。它可用于提供专属域功能,仅专属于特定的输入法及其客户端
参数
action 执行命名的名称。它必须是一个域名称,如前缀你自己的包名称,这样不同的开发者就不产生命令冲突。
data 随命令包括的任何数据。
public abstract void dispatchKeyEvent (int seq, KeyEvent event, InputMethodSession.EventCallback callback)
当按键按下时调用此方法。完成事件时,本方法的实现方法必须调用callback回调函数并返回结果。
如果输入法处理此事件返回true,否则返回false,调用者(如应用程序)将处理事件。
参数
event 按键事件
返回值
输入法是否处理本事件。
参见
public abstract void dispatchTrackballEvent (int seq, MotionEvent event, InputMethodSession.EventCallback callback)
发生轨迹球事件时调用此方法。
如果输入法处理此事件返回true,否则返回false,调用者(如应用程序)将处理事件。
参数
event 移动事件
返回值
输入法是否处理本事件。
参见
public abstract void displayCompletions (CompletionInfo[] completions)
由文本编辑器调用自动补全,完成后通知输入法补全有效。可被用于输入法向用户显示备选文本以备插入。
参数
completions 补充文本数组有效,并以最佳结果开头。如果数组为空,存在的补充将被移除。
public abstract void finishInput ()
当应用程序要停止接收文字输入时调用此方法。
public abstract void toggleSoftInput (int showFlags, int hideFlags)
切换软键盘(soft input)窗口。应用程序能切换软键盘(soft input)窗口
参数
showFlags 提供附加的操作标志。可能为0或设置SHOW_IMPLICIT, SHOW_FORCED位。
hideFlags 提供附加的操作标志。可能为0或设置HIDE_IMPLICIT_ONLY, HIDE_NOT_ALWAYS位。
public abstract void updateCursor (Rect newCursor)
当目标输入域的光标位置在自身窗口内移动时调用此方法。本方法通常不被调用,但输入法要求更新时可被调用。
参数
newCursor 当前输入区域窗口坐标系下光标显示的矩阵区域。
public abstract void updateExtractedText (int token, ExtractedText text)
当内容变化时文本编辑器调用此方法,通知其新提取文本。本方法仅在输入法调用InputConnection.getExtractedText()并带有通报更新选项时才被调用。
参数
token 输入法提供了分辨要求的令牌。
text 新的提取文本。
public abstract void updateSelection (int oldSelStart, int oldSelEnd, int newSelStart, int newSelEnd, int candidatesStart, int candidatesEnd)
当目标输入域的光标或选定变化时,调用此方法。
参数
oldSelStart 之前的选择开始位置相对于光标的文本偏移。
oldSelEnd 之前的选择结束位置相对于光标的文本偏移。
newSelStart 新的选择初始位置相对于光标的文本偏移。
newSelEnd 新的选择结束位置相对于光标的文本偏移。
candidatesStart 当前坐标系下文本文本开始位置的文本偏移。
candidatesEnd 当前坐标系下文本文本结束位置的文本偏移。 转载:http://www.cnblogs.com/over140/archive/2011/01/06/1927082.html相关文章
- 聚焦 Android 11: 大功告成
- 天气预报api免费接口_天气API
- android进阶之了解Android系统与开机过程
- Android listview 实现列表多选
- Android 加载串口通信读取信息时 AndroidStudio loadLibrary失败「建议收藏」
- oracle soap api,Web API与SOAP API的区别
- android反编译apk_apk反编译找不到
- Android angle_android 界面悬停
- android attrs获取_关于Android attrs 自定义属性的说明
- 抖音API接口_抖音榜单数据api接口
- Android Services Library_android freeware
- Android学习(简单使用Bottom Navigation Activity来实现底部导航栏)
- android studio 图片资源的放置位置,你中枪了吗?
- Android studio更新后出现警告:Warning:The `android.dexOptions.incremental` property is deprecated and it has
- 【Android 应用开发】Android 平台 HTTP网速测试 案例 API 分析
- 【Android 系统开发】Android JNI 之 JNIEnv 解析
- 【Android 应用开发】 Application 使用分析
- 【Android 逆向】修改 Android 系统文件 ( 重新挂载文件分区 | 在 /system/lib/ 只读目录下创建文件 | 修改 Android 系统文件的意义 )
- 【Android Gradle 插件】自定义 Gradle 任务 ④ ( Task#doLast 函数用法 | 自定义 Gradle 任务代码示例 )
- 【Android Gradle 插件】Gradle 构建机制 ④ ( Gradle 构建生命周期 | 初始阶段 | 配置阶段 | 执行阶段 )
- 解决android studio 创建新项目后假死详解手机开发
- Linux编程API探索之旅(linux编程api)
- API实现MySQL数据库备份(api备份mysql)
- android计算pad或手机的分辨率/像素/密度/屏幕尺寸/DPI值的方法
- Android中父View和子view的点击事件处理问题探讨
- Android中的android:layout_weight使用详解