android api (83) —— InputMethodSession [输入法]

简介:

正文

  一、结构

public interface InputMethodSession

        

android.view.inputmethod. InputMethodSession


间接子类

AbstractInputMethodService.AbstractInputMethodSessionImpl,InputMethodService.InputMethodSessionImpl

 

  二、概述

  InputMethodSession接口提供给每个客户端的InputMethod可安全地暴露在应用程序中。

  应用程序通常不自己使用本接口,而是依靠TextViewEditText提供的标准交互。

 

  三、内部类

     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       按键事件

  返回值

  输入法是否处理本事件。

  参见

                       ERROR(/#dispatchKeyUp)

                       KeyEvent

 

  public abstract void dispatchTrackballEvent (int seq, MotionEvent event, InputMethodSession.EventCallback callback)

  发生轨迹球事件时调用此方法。

  如果输入法处理此事件返回true,否则返回false,调用者(如应用程序)将处理事件。

             参数

  event       移动事件

  返回值

  输入法是否处理本事件。

  参见

                       MotionEvent

 

  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         当前坐标系下文本文本结束位置的文本偏移。

 


本文转自over140 51CTO博客,原文链接:http://blog.51cto.com/over140/582428,如需转载请自行联系原作者

相关文章
|
XML Android开发 数据格式
Android Keyboard(自定义输入法)
Keyboard的xml文件配置 软键盘的布局 自定义软键盘工具类 package com.
1989 0
|
7月前
|
存储 安全 文件存储
Android OTA升级后输入法异常和应用丢失的分析
Android OTA升级后输入法异常和应用丢失的分析
115 1
|
XML Android开发 数据格式
Android输入法挤乱布局问题
Android输入法挤乱布局问题
|
Shell Android开发
Android8.1 MTK平台 修改系统默认语言和默认输入法
Android8.1 MTK平台 修改系统默认语言和默认输入法
587 0
|
编解码 Android开发
android 输入法不全屏
android 输入法不全屏
201 0
|
Android开发
android 检测外接键盘并设置输入法布局
android 检测外接键盘并设置输入法布局
429 0
|
Android开发
android 修改输入法中拼写检测默认值
android 修改输入法中拼写检测默认值
74 0
|
Android开发
Android点击空白区域,隐藏输入法软键盘
Android点击空白区域,隐藏输入法软键盘
667 0
|
Android开发 数据安全/隐私保护
Android Studio 3.0输入法问题解决方案
Android Studio 3.0输入法问题解决方案
173 0
|
Android开发
Android 的输入法适配设置windowSoftInputMode方式
用户评论开发过程中通常需要和EditText控件打交道,编辑框通常编程过程中最常见的就是和软键盘做交互操作。在用户最初进入编辑评论时有时希望直接展示软键盘,减少用户选中输入框操作,最好是保证输入框不被软件盘覆盖住。android:windowSoftInputMode属性就包含了实现这些交互方式的属性,主要分成两个部分,一个是控制软件盘展示或隐藏的state开头属性值,一个是控制展示输入框的Window适配效果的adjust开头属性值,通常都是两个使用或(|)指定键盘盘和Windwo适配效果,最常见的Adjust属性值解释如下:
308 0
Android 的输入法适配设置windowSoftInputMode方式