Android EditText 的Enter键监听及其Enter键显示功能

EditText 是 Android 中的一个常用视图控件，用于接收和显示用户输入的文本。它允许用户通过软键盘或其他输入方法输入文本，并且可以用于各种场景，例如登录表单、搜索框、评论输入等。

1. EditText 的Enter键监听

要在 Android 中监听 Enter 键按下EditText，可以使用该setOnEditorActionListener()方法，您可以有效地监听 Enter 键按下的情况EditText，并在用户输入文本时执行您想要的操作。此方法允许您指定一个侦听器，当用户在EditText获得焦点时按下 Enter 键时将通知该侦听器。以下是如何在中监听 Enter 键按下的示例EditText：

EditText editText = findViewById(R.id.editText);

editText.setOnEditorActionListener(new TextView.OnEditorActionListener() {
    @Override
    public boolean onEditorAction(TextView v, int actionId, KeyEvent event) {
        if (actionId == EditorInfo.IME_ACTION_DONE) {
            // The user pressed the Enter key.
            // Perform your desired action here, such as submitting the text.
            String text = editText.getText().toString();
            System.out.println("Entered text: " + text);
            return true; // Consume the event
        }
        return false; // Don't consume the event
    }
});

onEditorAction()当用户在EditText获得焦点时按下任意键时，将调用该方法。该actionId参数指示按下的键的类型。在本例中，我们只对EditorInfo.IME_ACTION_DONE操作感兴趣，即 Enter 键。如果EditorInfo.IME_ACTION_DONE检测到该操作，该onEditorAction()方法将返回true以使用该事件并防止其传播到其他侦听器。这意味着 Enter 键的默认行为（例如插入换行符）不会发生。在该onEditorAction()方法内，按下 Enter 键即可执行所需的操作。在此示例中，我们只是将输入的文本打印到控制台。

EditorInfo 类

EditorInfo 类中定义了一些常量，用于描述输入法编辑器的行为和特性。

1. IME_ACTION_DONE：用户完成输入操作时的动作常量。
2. IME_ACTION_GO：用户点击“前往”按钮时的动作常量。
3. IME_ACTION_NEXT：用户点击“下一个”按钮时的动作常量。
4. IME_ACTION_PREVIOUS：用户点击“上一个”按钮时的动作常量。
5. IME_ACTION_SEARCH：用户点击“搜索”按钮时的动作常量。
6. IME_ACTION_SEND：用户点击“发送”按钮时的动作常量。
7. IME_ACTION_UNSPECIFIED：未指定输入操作时的动作常量。
8. IME_FLAG_FORCE_ASCII：强制使用 ASCII 字符集的标志常量。
9. IME_FLAG_NO_ENTER_ACTION：取消“回车”按钮的标志常量。
10. IME_NULL：无操作常量。

这些常量可以在与输入法交互的过程中使用，以指定所需的动作和行为。例如，在设置 EditorInfo 对象时，可以使用这些常量来设置 imeOptions 和 inputType 属性，以告知输入法编辑器相应的行为。

2. EditText 的Enter键功能显示

输入法的软键盘的Enter键默认显示的是“完成”文本，但是在一些其他场景中我们需要改变Enter键的显示内容更加符合其使用场景，比如搜索框输入，此时Enter键显示“搜索”更好。Android也为我们提供的这样的功能。通过设置android:imeOptions来改变默认的“完成”文本。

注意：设置EdiText的属性imeOptions为“actionNext”，即android:imeOptions="actionNext"，需要同时将文本框的属性设置为单行模式，即android:singleLine="true"才可以生效。

Android:imeOptions 常用值及其含义

imeOptions 属性用于指定输入法在编辑文本框时提供的功能。它通常在 XML 布局文件中设置，并应用于 <EditText> 控件。

常用值及其含义：

值	含义
actionNone	不执行任何操作。
actionDone	在软键盘上显示 “完成” 按钮，点击后关闭软键盘，但不执行任何其他操作。
actionGo	在软键盘上显示 “转到” 按钮，点击后执行与该文本框关联的操作，例如搜索或提交表单。
actionSearch	在软键盘上显示 “搜索” 按钮，点击后触发搜索操作。
actionSend	在软键盘上显示 “发送” 按钮，点击后触发发送操作，例如发送短信或电子邮件。
actionNext	在软键盘上显示 “下一个” 按钮，点击后切换到下一个输入框。
actionPrevious	在软键盘上显示 “上一个” 按钮，点击后切换到上一个输入框。
flagNoExtractUi	防止输入法提取文本框中的文本用于建议或自动更正。
flagNoAccessoryAction	隐藏输入法提供的辅助按键，例如表情符号键盘或语音输入。

示例用法：

<EditText
    android:id="@+id/editText"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:imeOptions="actionDone|flagNoExtractUI" />

在这个示例中，imeOptions 属性设置为 “actionDone|flagNoExtractUi”，这意味着：

• 点击软键盘上的 “完成” 按钮时，会关闭软键盘，但不会执行任何其他操作。
• 输入法不会提取文本框中的文本用于建议或自动更正。