Most visited

Recently visited

Added in API level 1

KeyListener

public interface KeyListener

android.text.method.KeyListener
Known Indirect Subclasses


用于将文本键事件转换为Editable类上的编辑操作的界面。 请注意,在大多数情况下,此接口已被InputMethod定义的一般软输入方法取代; 它只能用于应用程序有自己的屏幕键盘并且还想处理硬键盘事件以匹配它的情况。

Key presses on soft input methods are not required to trigger the methods in this listener, and are in fact discouraged to do so. The default android keyboard will not trigger these for any key to any application targetting Jelly Bean or later, and will only deliver it for some key presses to applications targetting Ice Cream Sandwich or earlier.

Summary

Public methods

abstract void clearMetaKeyState(View view, Editable content, int states)

从编辑的文本中移除给定的移位状态。

abstract int getInputType()

按照 InputType返回此按键侦听器正在操作的文本类型。

abstract boolean onKeyDown(View view, Editable text, int keyCode, KeyEvent event)

如果键监听器想要处理这个键,则返回true,否则返回false,并且调用者(即小部件主机)将处理该键。

abstract boolean onKeyOther(View view, Editable text, KeyEvent event)

如果键监听器想要其他类型的键事件,则返回true,否则返回false,并且调用方(即小部件主机)将处理该键。

abstract boolean onKeyUp(View view, Editable text, int keyCode, KeyEvent event)

如果键监听器想要处理这个键释放,则返回true,否则返回false,并且调用者(即小部件主机)将处理该键。

Public methods

clearMetaKeyState

Added in API level 3
void clearMetaKeyState (View view, 
                Editable content, 
                int states)

从编辑的文本中移除给定的移位状态。

Parameters
view View
content Editable
states int

getInputType

Added in API level 3
int getInputType ()

按照InputType返回此键监听器正在操作的文本类型。 这用于确定为编辑器显示的软键盘的模式。

如果您返回TYPE_NULL 则不提供软键盘。 换句话说,您必须为屏幕输入提供您自己的小键盘,而按键监听器将用于处理来自硬键盘的输入。

如果您返回任何其他值,则在用户将焦点放在编辑器中时将创建一个软输入方法,该编辑器将提供一个小键盘并同时消耗硬键事件。 这意味着通常不会使用键监听器,而是根据此处返回的内容类型,软输入方法将负责管理键输入。

Returns
int

onKeyDown

Added in API level 1
boolean onKeyDown (View view, 
                Editable text, 
                int keyCode, 
                KeyEvent event)

如果键监听器想要处理这个键,则返回true,否则返回false,并且调用者(即小部件主机)将处理该键。

Parameters
view View
text Editable
keyCode int
event KeyEvent
Returns
boolean

onKeyOther

Added in API level 3
boolean onKeyOther (View view, 
                Editable text, 
                KeyEvent event)

如果键监听器想要其他类型的键事件,则返回true,否则返回false,并且调用方(即小部件主机)将处理该键。

Parameters
view View
text Editable
event KeyEvent
Returns
boolean

onKeyUp

Added in API level 1
boolean onKeyUp (View view, 
                Editable text, 
                int keyCode, 
                KeyEvent event)

如果键监听器想要处理这个键释放,则返回true,否则返回false,并且调用者(即小部件主机)将处理该键。

Parameters
view View
text Editable
keyCode int
event KeyEvent
Returns
boolean

Hooray!