到顶部
Android API
公众的最终

输入设备

延伸对象
实施可包裹的
java.lang.Object(java.lang.对象)
   ↳ android.view。输入设备

课程概述

描述特定输入设备的功能。

每个输入设备可以支持多类输入。例如,多功能键盘可以组合标准键盘和轨迹板鼠标的功能或其他定点设备。

一些输入设备提供多个可区分的输入源。应用程序可以查询框架中每个不同源的特征。

此外,不同类型的输入源使用不同的坐标系以描述运动事件。请参阅有关的输入源常量的注释适当的解释。

总结

内部类
输入设备。运动范围 提供有关特定值范围的信息动议事件轴。 
常量
整数 键盘_类型_字母 键盘支持一组字母键。
整数 键盘_类型_无 没有键盘。
整数 键盘_类型_NON_ALPHABETIC 键盘不是全字母的。
整数 运动_角度_方向 此常量已弃用API 12级。使用AXIS_方位而不是。
整数 运动_范围_压力 此常量已弃用API 12级。使用轴_压力而不是。
整数 运动_范围_大小 此常量已弃用API 12级。使用AXIS_SIZE(轴_尺寸)而不是。
整数 运动_角度_工具_主要 此常量已弃用API 12级。使用AXIS_TOOL_MAJOR轴而不是。
整数 运动_角度_工具_最小 此常量已弃用API 12级。使用AXIS_TOOL_MINOR轴而不是。
整数 MOTION_RANGE_TOUCH_MAJOR运动 此常量已弃用API 12级。使用AXIS_TOUCH_MAJOR公司而不是。
整数 运动_角度_触摸_最小 此常量已弃用API 12级。使用AXIS_TOUCH_MINOR轴而不是。
整数 运动_角度_X 此常量已弃用API 12级。使用AXIS_X公司而不是。
整数 运动_角度_Y 此常量已弃用API 12级。使用轴_Y而不是。
整数 来源_纽约 过滤输入设备时使用的特殊输入源常数匹配提供任何类型输入源的设备。
整数 源_类_按钮 输入源具有按钮或键。
整数 源_类_操纵手柄 输入源为操纵杆。
整数 源_类别_掩码 输入源类的掩码。
整数 来源_类别_无 输入源没有类。
整数 源类别指针 输入源是与显示器关联的定点设备。
整数 源_类别_位置 输入源是与显示器无关的绝对定位装置(不同于源类别指针).
整数 来源_分类_追踪球 输入源是一个轨迹球导航设备。
整数 源_DPAD 输入源为DPad。
整数 来源_ GAMEPAD 输入源是一个游戏板。
整数 源_操纵手柄 输入源为操纵杆。
整数 来源_键盘 输入源是键盘。
整数 源_母 输入源是鼠标指向设备。
整数 SOURCE_STYLUS来源 输入源是手写笔指向设备。
整数 源_ OUCHPAD 输入源是触摸板或数字化仪平板电脑与显示器关联(不同于源_触摸屏).
整数 源_触摸屏 输入源是触摸屏指针设备。
整数 源_输出_导航 输入源是一个触摸设备,其运动应解释为导航事件。
整数 源跟踪球 输入源是轨迹球。
整数 来源_未知 输入源未知。
[展开]
继承的常量
来自接口android.os。可包裹的
领域
公众的静止的最终的造物主<输入设备> 造物主
公共方法
整数 describe目录()
描述此Parcelable中包含的特殊对象的种类编组表示。
整数 获取控制器编号()
给定输入设备的控制器编号。
字符串 获取描述符()
获取输入设备描述符,它是输入设备的稳定标识符。
静止的输入设备 获取设备(int id)
获取有关具有指定id的输入设备的信息。
静止的整数[] 获取设备ID()
获取系统中所有输入设备的ID。
整数 获取ID()
获取输入设备id。
关键点特征映射 获取KeyCharacterMap()
获取与此输入设备关联的键字符映射。
整数 获取键盘类型()
获取键盘类型。
输入设备。运动范围 获取运动范围(int轴,int源)
获取有关特定值范围的信息动议事件由设备上的特定源使用。
输入设备。运动范围 获取运动范围(int轴)
获取有关特定值范围的信息动议事件轴。
列表<输入设备。运动范围> 获取运动范围()
获取设备支持的所有轴的范围。
字符串 获取名称()
获取此输入设备的名称。
整数 获取产品ID()
获取给定设备的产品id(如果可用)。
整数 获取源()
获取此输入设备支持的作为组合位字段的输入源。
整数 获取供应商ID()
获取给定设备的供应商id(如果可用)。
振动器 获取可控震源()
获取与设备关联的可控震源服务(如果有)。
布尔值[] has键(内部…键)
获取设备是否能够生成密钥列表。
布尔值 是虚拟的()
如果设备是虚拟输入设备而不是真实输入设备,则返回true,例如虚拟键盘(请参见虚拟键盘).
字符串 toString(字符串)()
返回一个字符串,该字符串包含此对象。
无效 写入包裹(包裹out,int标志)
将此对象展平为地块。
[展开]
继承的方法
来自班级java.lang.Object(java.lang.对象)
来自接口android.os。可包裹的

常量

公众静态最终整数键盘_类型_字母

已在中添加API级别9

键盘支持一组字母键。

常量值: 2(0x00000002)

公众静态最终整数键盘_类型_无

已在中添加API级别9

没有键盘。

常量值: 0(0x00000000)

公众静态最终整数键盘_类型_NON_ALPHABETIC

已在中添加API级别9

键盘不是完全按字母顺序排列的。它可以是数字键盘或产品组合未映射为适合文本输入的字母键的按钮。

常量值: 1(0x00000001)

公众静态最终整数运动_角度_方向

此常量已弃用API 12级。
使用AXIS_方位而不是。

用于检索的值范围的常量AXIS_方位.

常量值: 8(0x00000008)

公众静态最终整数运动_范围_压力

已在中添加API级别9

此常量已弃用API 12级。
使用轴_压力而不是。

用于检索的值范围的常量轴压力.

常量值: 2(0x00000002)

公众静态最终整数运动_范围_尺寸

已在中添加API级别9

此常量已弃用API 12级。
使用AXIS_SIZE(轴_尺寸)而不是。

用于检索的值范围的常量轴_大小.

常量值: (0x00000003)

公众静态最终整数运动_角度_工具_主要

已在中添加API级别9

此常量已弃用API 12级。
使用AXIS_TOOL_MAJOR轴而不是。

用于检索的值范围的常量AXIS_TOOL_MAJOR轴.

常量值: 6(0x00000006)

公众静态最终整数运动_角度_工具_最小

已在中添加API级别9

此常量已弃用API 12级。
使用AXIS_TOOL_MINOR轴而不是。

用于检索的值范围的常量AXIS_TOOL_MINOR轴.

常量值: 7(0x00000007)

公众静态最终整数MOTION_RANGE_TOUCH_MAJOR运动

已在中添加API级别9

此常量已弃用API 12级。
使用AXIS_TOUCH_MAJOR公司而不是。

用于检索的值范围的常量AXIS_TOUCH_MAJOR公司.

常量值: 4(0x00000004)

公众静态最终整数运动_角度_触摸_最小

已在中添加API级别9

此常量已弃用API 12级。
使用AXIS_TOUCH_MINOR轴而不是。

用于检索的值范围的常量AXIS_TOUCH_MINOR轴.

常量值: 5(0x00000005)

公众静态最终整数运动_角度_X

此常量已弃用API 12级。
使用AXIS_X公司而不是。

用于检索的值范围的常量AXIS_X公司.

常量值: 0(0x00000000)

公众静态最终整数运动_范围_Y

已在中添加API级别9

此常量已弃用API 12级。
使用AXIS_Y轴而不是。

用于检索的值范围的常量AXIS_Y轴.

常量值: 1(0x00000001)

公众静态最终整数来源_纽约

已在中添加API级别9

过滤输入设备时使用的特殊输入源常数匹配提供任何类型输入源的设备。

常量值: -256(0xffffff00)

公众静态最终整数源_类_按钮

已在中添加API级别9

输入源具有按钮或键。示例:来源_键盘,源_DPAD.A类键盘事件应理解为按钮或按键。使用获取KeyCharacterMap()查询设备的按钮和键映射。

常量值: 1(0x00000001)

公众静态最终整数源类操纵杆

已在中添加API级别12

输入源为操纵杆。A类动议事件应理解为操纵杆的绝对移动。使用getMotionRange(int)查询位置范围。

常量值: 16(0x00000010)

公众静态最终整数源_类别_掩码

已在中添加API级别9

输入源类的掩码。每个不同的输入源常量都有一个或多个输入源类位设置为为其输入事件指定所需的解释。

常量值: 255(0x000000ff)

公众静态最终整数来源_类别_无

已在中添加API等级18

输入源没有类。由应用程序根据设备类型决定如何处理设备。

常量值: 0(0x00000000)

公众静态最终整数源类别指针

输入源是与显示器关联的定点设备。示例:源_触摸屏,源_母.A类动议事件应解释为绝对坐标根据查看等级制度。指针向下/向上指示当按下/松开选择按钮时,手指接触显示屏。使用getMotionRange(int)查询定点设备的范围。某些设备允许触摸显示区域外,因此有效范围可能会稍小或稍大比实际显示尺寸大。

常量值: 2(0x00000002)

公众静态最终整数源_类别_位置

已在中添加API级别9

输入源是与显示器无关的绝对定位装置(不同于源类别指针).A类动议事件应解释为绝对坐标特定于设备的表面单元。使用getMotionRange(int)(获取运动范围(int))查询位置范围。

常量值: 8(0x00000008)

公众静态最终整数来源_分类_追踪球

已在中添加API级别9

输入源是轨迹球导航设备。示例:源_跟踪球.A类动议事件应解释为特定于设备的相对运动用于导航目的的单位。指针向下/向上指示选择按钮按下/松开。使用getMotionRange(int)以查询运动范围。

常量值: 4(0x00000004)

公众静态最终整数源_DPAD

已在中添加API级别9

输入源为DPad。

另请参见
常量值: 513(0x00000201)

公众静态最终整数来源_ GAMEPAD

输入源是一个游戏板。(它也可以是源_操纵手柄).

另请参见
常量值: 1025(0x00000401)

公众静态最终整数源_操纵手柄

已在中添加API级别12

输入源为操纵杆。(它也可以是来源_ GAMEPAD).

另请参见
常量值: 16777232(0x01000010)

公众静态最终整数来源_键盘

已在中添加API级别9

输入源是键盘。这个源表示几乎所有有按钮的东西。使用获取键盘类型()确定键盘是否有字母键可用于输入文本。

另请参见
常量值: 257(0x00000101)

公众静态最终整数源_母

已在中添加API级别9

输入源是鼠标指向设备。此代码也用于其他类似鼠标的定点设备,如轨迹板和轨迹点。

另请参见
常量值: 8194(0x000002)

公众静态最终整数SOURCE_STYLUS来源

已在中添加API级别14

输入源是一个手写笔定点设备。

注意,该位仅表示输入设备能够获得从手写笔输入。确定是否生成了给定的触摸事件使用手写笔检查返回的工具类型获取工具类型(int)对于每个指针。

单个触摸事件可以是具有不同工具类型的多个指针,例如具有一个工具类型指针的事件工具_类型_手指和另一个具有工具类型的指针工具_TYPE_STYLUS。因此检查很重要每个指针的工具类型,与报告的源无关通过获取源代码().

另请参见
常量值: 16386(0x00004002)

公众静态最终整数源_ OUCHPAD

已在中添加API级别9

输入源是触摸板或数字化仪平板电脑与显示器关联(不同于源_触摸屏).

另请参见
常量值: 1048584(0x00100008)

公众静态最终整数源_触摸屏

输入源是触摸屏指针设备。

另请参见
常量值: 4098(0x0001002)

公众静态最终整数源_输出_导航

已在中添加API等级18

输入源是一个触摸设备,其运动应解释为导航事件。例如,向上滑动应该与向上焦点遍历的方式相同向上按压D-Pad将是。向左、向右和向下轻扫应在类似的方式。

另请参见
常量值: 2097152(0x00200000)

公众静态最终整数源跟踪球

已在中添加API级别9

输入源是轨迹球。

常量值: 65540(0x00010004)

公众静态最终整数来源_未知

已在中添加API级别9

输入源未知。

常量值: 0(0x00000000)

领域

公众静态最终的造物主<输入设备>造物主

已在中添加API级别9

公共方法

公众整数 describe目录 ()

已在中添加API级别9

描述此包裹中包含的特殊物品种类编组表示。

退换商品
  • 指示编组的特殊对象类型集的位掩码通过包裹。

公众整数 获取控制器编号 ()

已在中添加API等级19

给定输入设备的控制器编号。

最初,每个游戏板或游戏杆都有一个唯一的正控制器编号由系统配置。此数字可能会因设备断开连接等事件而更改/重新连接或用户发起的重新分配。数字的任何变化都会触发一个可以通过注册InputManager。输入设备侦听器.

所有非游戏板或游戏杆的输入设备都将被分配一个控制器编号第页,共页。

退换商品
  • 设备的控制器编号。

公众的字符串 获取描述符 ()

已在中添加API级别16

获取输入设备描述符,它是输入设备的稳定标识符。

输入设备描述符唯一标识输入设备。它的价值旨在在系统重新启动时保持不变,甚至不应更改如果输入设备断开连接,请随时重新连接或重新配置。

可能有多个输入设备具有相同的输入设备描述符。这种情况可能发生在人工输入设备注册多个输入设备实例(HID集合)描述设备的单独功能,例如键盘有一个触控板。或者,输入设备可能只是无法区分,例如同一制造商生产的两个键盘。

由返回的输入设备描述符获取描述符()应该只是当应用程序需要记住与特定输入设备。在引用逻辑输入设备实例在运行时使用获取ID().

退换商品
  • 输入设备描述符。

公众静止的输入设备 获取设备 (int id)

已在中添加API级别9

获取有关具有指定id的输入设备的信息。

参数
身份证件 设备id。
退换商品
  • 如果未找到输入设备,则返回null。

公众静态整数[] 获取设备ID ()

已在中添加API级别9

获取系统中所有输入设备的ID。

退换商品
  • 输入设备ID。

公众整数 获取ID ()

已在中添加API级别9

获取输入设备id。

首次配置时,每个输入设备都会收到一个唯一的id由系统决定。当系统重新启动时,或者如果输入设备随时断开、重新连接或重新配置。如果您需要一个持续存在于引导和重新配置,使用获取描述符().

退换商品
  • 输入设备id。

公众的关键点特征映射 获取KeyCharacterMap ()

已在中添加API级别9

获取与此输入设备关联的键字符映射。

退换商品
  • 关键字符映射。

公众整数 获取键盘类型 ()

已在中添加API级别9

获取键盘类型。

退换商品
  • 键盘类型。

公众的输入设备。运动范围 获取运动范围 (int轴,int源)

已在中添加API级别12

获取有关特定值范围的信息动议事件由设备上的特定源使用。如果设备支持多个源,则同一轴可能具有不同的含义对于每个源。

参数
轴常量。
来源 要返回信息的源。
退换商品
  • 值的范围,如果请求的轴不是受设备支持。
另请参见

公众的输入设备。运动范围 获取运动范围 (int轴)

已在中添加API级别9

获取有关特定值范围的信息动议事件轴。如果设备支持多个源,则同一轴可能具有不同的含义对于每个源。返回有关为任何源找到的第一个轴的信息。要获取有关特定源轴的信息,请使用getMotionRange(int,int).

参数
轴常量。
退换商品
  • 值的范围,如果请求的轴不是受设备支持。
另请参见

公众的列表<输入设备。运动范围> 获取运动范围 ()

已在中添加API级别12

获取设备支持的所有轴的范围。

退换商品
  • 设备的运动范围。

公众的字符串 获取名称 ()

已在中添加API级别9

获取此输入设备的名称。

退换商品
  • 输入设备名称。

公众整数 获取产品ID ()

已在中添加API等级19

获取给定设备的产品id(如果可用)。

产品id唯一地标识给定供应商的地址空间内的哪个产品,由设备的供应商id标识。如果产品id为无法使用的。

退换商品
  • 给定设备的产品id

公众整数 获取源 ()

已在中添加API级别9

获取此输入设备支持的作为组合位字段的输入源。

退换商品
  • 支持的输入源。

公众整数 获取供应商ID ()

已在中添加API等级19

获取给定设备的供应商id(如果可用)。

供应商id唯一标识制造设备的公司。值为0将在供应商id不可用的情况下分配。

退换商品
  • 给定设备的供应商id

公众的振动器 获取可控震源 ()

已在中添加API级别16

获取与设备关联的可控震源服务(如果有)。即使设备没有可控震源,结果也不会为空。使用has振动器()确定可控震源是否存在。请注意,与设备关联的可控震源可能与系统振动器。要获取系统可控震源的实例,请调用getSystemService(字符串)具有振动器_维修作为参数。

退换商品
  • 与设备关联的可控震源服务,从不为空。

公众布尔值[] has键 (内部…键)

已在中添加API等级19

获取设备是否能够生成密钥列表。

参数
钥匙 要检查的android密钥列表。
退换商品
  • 布尔数组,其中每个成员指定设备是否能够生成keys数组中相同索引处对应值所给定的keycode。

公众布尔值 是虚拟的 ()

已在中添加API级别16

如果设备是虚拟输入设备而不是真实输入设备,则返回true,例如虚拟键盘(请参见虚拟键盘).

提供虚拟输入设备以实现系统级功能用户不应看到或配置。

退换商品
  • 如果设备是虚拟的,则为True。
另请参见

公众的字符串 toString(字符串) ()

已在中添加API级别9

返回一个字符串,该字符串包含此对象。鼓励子类重写此方法并提供考虑对象类型和数据的实现。这个默认实现等效于以下表达式:

getClass().getName()+“@”+整数.toHexString(hashCode())

请参见编写有用的toString(字符串)方法如果你打算实现你自己的toString(字符串)方法。

退换商品
  • 此对象的可打印表示。

公众无效 写入包裹 (包裹out,int标志)

将此对象展平为地块。

参数
外面的 应在其中写入对象的地块。
旗帜 关于如何写入对象的其他标志。可以是0或可拆分_写入_返回_值.