Android监听软键盘回车事件

最新推荐文章于 2025-04-19 00:15:00 发布

壹只很拽的猫

最新推荐文章于 2025-04-19 00:15:00 发布

阅读量2k

点赞数

分类专栏： android

android 专栏收录该内容

128 篇文章

订阅专栏

本文介绍了在Android开发中处理软键盘回车键事件的四种常见方法，并详细分析了每种方法的特点及适用场景，推荐使用setOnEditorActionListener进行监听。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

在 Android开发中，难免会碰到一些”意外“。比如输入法软按键监听问题，因为第三方输入法各有不同（对一些按键事件作了一些特殊的处理），所以有时有些代码会“失灵”。假设一个场景，EditText监听回车事件，回车后就发送输入的内容，一般有以下4种处理方式：

假设场景图：

1.setImeOptions

用代码设置：

mEditText.setImeOptions(EditorInfo.IME_ACTION_SEND);

或者在布局文件中设置：

    <EditText   
        ...  
            android:imeOptions="actionSend"  
            />

2. setOnKeyListener

mEditText.setOnKeyListener(new View.OnKeyListener() {  
              
            @Override  
            public boolean onKey(View v, int keyCode, KeyEvent event) {  
                //这里注意要作判断处理，ActionDown、ActionUp都会回调到这里，不作处理的话就会调用两次  
                if (KeyEvent.KEYCODE_ENTER == keyCode && KeyEvent.ACTION_DOWN == event.getAction()) {  
                    //处理事件  
                    return true;  
                }  
                return false;  
            }  
        });

但是，这个接口有可能会“失灵”，看说明文档：

Register a callback to be invoked when a hardware key is pressed in this view. Key presses in software input methods will generally not trigger the methods of this listener.
3.dispatchKeyEvent

也可以在Activity或者Dialog里覆写dispatchKeyEvent来达到目的：

    @Override  
        public boolean dispatchKeyEvent(KeyEvent event) {  
            //这里注意要作判断处理，ActionDown、ActionUp都会回调到这里，不作处理的话就会调用两次  
            if (KeyEvent.KEYCODE_ENTER == event.getKeyCode() && KeyEvent.ACTION_DOWN == event.getAction()) {  
                //处理事件  
                return true;  
            }  
            return super.dispatchKeyEvent(event);  
        }

4.setOnEditorActionListener

这个方法应该是最正统也最合适的，一般的做法：

    mEditText.setOnEditorActionListener(new TextView.OnEditorActionListener() {  
                  
                @Override  
                public boolean onEditorAction(TextView v, int actionId, KeyEvent event) {  
                    if (actionId == EditorInfo.IME_ACTION_SEND) {  
                        //处理事件  
                    }  
                    return false;  
                }  
            });

当然这个前提是要用1中的方法设置ImeOption，也就是改变软键盘上回车键的Action。但是，在实际使用中，发现在不同输入法上效果不同，某些输入法上根本不会改变回车键的Action，也就是actionId != EditorInfo.IME_ACTION_SEND，而是==EditorInfo.IME_ACTION_DONE。往往遇到如此问题时，可能第一反应就是选择2、3方法，但是2、3方法也有可能不奏效。那该怎么去适配软键盘呢？目光回到onEditorAction上，发现此回调接口带有3个参数，再看1、2、3方法，其实用到的就是IME_ACTION_XX和KeyEvent对象，而onEditorAction回调参数就有这两个。我们只需要在onEditorAction里再稍作处理就行了。比如：

mEditText.setOnEditorActionListener(new TextView.OnEditorActionListener() {  
              
            @Override  
            public boolean onEditorAction(TextView v, int actionId, KeyEvent event) {  
                //当actionId == XX_SEND 或者 XX_DONE时都触发  
                //或者event.getKeyCode == ENTER 且 event.getAction == ACTION_DOWN时也触发  
                //注意，这是一定要判断event != null。因为在某些输入法上会返回null。  
                if (actionId == EditorInfo.IME_ACTION_SEND  
                        || actionId == EditorInfo.IME_ACTION_DONE  
                        || (event != null && KeyEvent.KEYCODE_ENTER == event.getKeyCode() && KeyEvent.ACTION_DOWN == event.getAction())) {  
                    //处理事件  
                }  
                return false;  
            }  
        });

文档说明：
Set a special listener to be called when an action is performed on the text view. This will be called when the enter key is pressed, or when an action supplied to the IME is selected by the user. Setting this means that the normal hard key event will not insert a newline into the text view, even if it is multi-line; holding down the ALT modifier will, however, allow the user to insert a newline character.

总结：软键盘回车键事件只需要用方法4就可以轻松解决，也是最合适的方法。

希望对大家有所帮助，谢谢！

——《Android细节随笔》，于2014.4.24

http://blog.youkuaiyun.com/Iceshow0428/article/details/24428417