Android中软键盘的设置与状态监听

发表于   |   分类于   |     |   阅读次数

很多界面都需要控制软键盘的打开与收起，有必要了解关于Android的软键盘的控制。

软键盘的显示原理

软键盘其实是一个Dialog。InputMethodService为我们的输入法创建了一个Dialog，并且对某些参数进行了设置，使之能够在底部或者全屏显示。当我们点击输入框时，系统会对当前的主窗口进行调整，以便留出相应的空间来显示该Dialog在底部，或者全屏。

Activity中软键盘的设置参数

  • 清单文件中对软键盘的一些配置
1
2
3
4
5
6
<activity 
	android:name=".Main"
    android:label="@string/app_name"
    android:windowSoftInputMode="adjustUnspecified|stateHidden"
    android:configChanges="orientation|keyboardHidden">
</activity>

  • 在代码中设置

    要设置软件盘属性，要在activity中的oncreate中的setContentView之前进行配置，举例如下：

1
getWindow().setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_PAN);

  • 关于windowSoftInputMode

    这个属性的意义有两点：

    （1）软键盘的状态——隐藏或显示。

    （2）活动的主窗口调整：是否减少活动主窗口大小以便腾出空间放软键盘或是否当活动窗口的部分被软键盘覆盖时它的内容的当前焦点是可见的。

    这个属性的可选属性值有以下几个：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
 
设置规则：
该属性的设置必须是下面列表中的一个值，或一个“state…”值加一个“adjust…”值的组合。
在任一组设置多个值，各个值之间用|分开。
state开头：
--------------------------------------------------------------------------------------------
"stateUnspecified"： 软键盘的状态(隐藏或可见)没有被指定。系统将选择一个合适的状态或依赖于主题的设置。这个是软件盘行为的默认设置。
"stateUnchanged"：软键盘被保持上次的状态。
"stateHidden"：当用户选择该Activity时，软键盘被隐藏。
"stateAlwaysHidden"： 软键盘总是被隐藏的。
"stateVisible"： 软键盘是可见的。
"stateAlwaysVisible"： 当用户选择这个Activity时，软键盘是可见的。
adjust开头：
----------------------------------------------------------------------------------------------
"adjustUnspecified"：默认设置，通常由系统自行决定是隐藏还是显示：决定因素在于内容是否可以滚动。
"adjustResize"：（压缩，上顶）当软键盘弹出时，对主窗口调整屏幕的大小以便留出软键盘的空间。
"adjustPan"：（平移）始终保持输入框为可见：当输入框不会被遮挡时，该模式不会对布局进行调整，而当输
入框将要被遮挡时，窗口就会进行平移（这里:输入框以下的布局内容依然会被遮挡）。当前窗口的内容会自动移动，从而保证当前焦点不被键盘覆盖
以及用户总能看到输入内容的部分。此模式下，用户只有关闭软键盘才能与被覆盖内容的交互操作。

软件盘的开关

  • 网上的方法很多，很乱。这里给出工具类。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
工具类
---------------------------------------------------------------------------------------------------
public class SoftInputUtil {
    /**
     * 关闭软件盘
     * @param activity
     * @param view 与软键盘相联系的View，这个View要可以获取和失去焦点，一般为EditText
     */
    public static void closeSoftInput(Activity activity, View view){
        InputMethodManager imm = (InputMethodManager) activity.getSystemService(Context.INPUT_METHOD_SERVICE);
        imm.hideSoftInputFromWindow(view.getWindowToken(), 0);
    }
    /**
     * 打开软件盘
     * @param activity
     * @param view 与软键盘相联系的View，这个View要可以获取和失去焦点，一般为EditText
     */
    public static void openSoftInput(Activity activity, View view){
        InputMethodManager imm = (InputMethodManager) activity.getSystemService(Context.INPUT_METHOD_SERVICE);
        imm.showSoftInput(view, InputMethodManager.SHOW_FORCED);
    }
    /**
     * 如果输入法在窗口上已经显示，则隐藏;反之则显示
     * @param activity
     */
    public static void toggleSoftInput(Activity activity){
        InputMethodManager imm = (InputMethodManager) activity.getSystemService(Context.INPUT_METHOD_SERVICE);
        imm.toggleSoftInput(0, InputMethodManager.HIDE_NOT_ALWAYS);
    }
}
---------------------------------------------------------------------------------------------------

软键盘开启与关闭状态的监听

  • 为什么要监听

    有的时候需要在软键盘打开后处理一些界面的控件的状态等，总之，有需求我们才去做这件事情。

  • 思路

    这里有多位大神给出了答案，下面的代码也是从里面简单修改得来的。非常推荐。

    How to check visibility of software keyboard in Android?

  • 代码与使用

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
package com.yue.maxwell.newsapp.utils;
import android.content.Context;
import android.graphics.Rect;
import android.util.DisplayMetrics;
import android.util.TypedValue;
import android.view.View;
import android.view.ViewTreeObserver;
import java.util.LinkedList;
import java.util.List;
public class SoftKeyboardStateWatcher implements ViewTreeObserver.OnGlobalLayoutListener {
    public interface SoftKeyboardStateListener {
        void onSoftKeyboardOpened(int keyboardHeightInPx);
        void onSoftKeyboardClosed();
    }
    private final List<SoftKeyboardStateListener> listeners = new LinkedList<SoftKeyboardStateListener>();
    private final View activityRootView;
    private int        lastSoftKeyboardHeightInPx;
    private boolean    isSoftKeyboardOpened;
    private Context mContext;
    //使用时用这个构造方法
    public SoftKeyboardStateWatcher(View activityRootView, Context context) {
        this(activityRootView, false);
        this.mContext = context;
    }
    
    private SoftKeyboardStateWatcher(View activityRootView) {
        this(activityRootView, false);
    }
    private SoftKeyboardStateWatcher(View activityRootView, boolean isSoftKeyboardOpened) {
        this.activityRootView     = activityRootView;
        this.isSoftKeyboardOpened = isSoftKeyboardOpened;
        activityRootView.getViewTreeObserver().addOnGlobalLayoutListener(this);
    }
    @Override
    public void onGlobalLayout() {
       /*
       如果是这种方式的话，软键盘必须设置为android:windowSoftInputMode=”adjustResize” 才有效
       int heightDiff = activityRootView.getRootView().getHeight() - activityRootView.getHeight();
        if (!isSoftKeyboardOpened && heightDiff > dpToPx(NewsApplication.getContext(), 200)) { // if more than 200 dp, it's probably a keyboard...
            isSoftKeyboardOpened = true;
            notifyOnSoftKeyboardOpened(heightDiff);
        }else if(isSoftKeyboardOpened && heightDiff < dpToPx(NewsApplication.getContext(), 200)){
            isSoftKeyboardOpened = false;
            notifyOnSoftKeyboardClosed();
        }*/
        //下面这种方式则对软键盘没有设置要求
       final Rect r = new Rect();
        //r will be populated with the coordinates of your view that area still visible.
        activityRootView.getWindowVisibleDisplayFrame(r);
        final int heightDiff = activityRootView.getRootView().getHeight() - (r.bottom - r.top);
        if (!isSoftKeyboardOpened && heightDiff > dpToPx(mContext, 200)) { // if more than 100 pixels, its probably a keyboard...
            isSoftKeyboardOpened = true;
            notifyOnSoftKeyboardOpened(heightDiff);
        } else if (isSoftKeyboardOpened && heightDiff < dpToPx(mContext, 200)) {
            isSoftKeyboardOpened = false;
            notifyOnSoftKeyboardClosed();
        }
    }
    public void setIsSoftKeyboardOpened(boolean isSoftKeyboardOpened) {
        this.isSoftKeyboardOpened = isSoftKeyboardOpened;
    }
    public boolean isSoftKeyboardOpened() {
        return isSoftKeyboardOpened;
    }
    /**
     * Default value is zero {@code 0}.
     *
     * @return last saved keyboard height in px
     */
    public int getLastSoftKeyboardHeightInPx() {
        return lastSoftKeyboardHeightInPx;
    }
    public void addSoftKeyboardStateListener(SoftKeyboardStateListener listener) {
        listeners.add(listener);
    }
    public void removeSoftKeyboardStateListener(SoftKeyboardStateListener listener) {
        listeners.remove(listener);
    }
    private void notifyOnSoftKeyboardOpened(int keyboardHeightInPx) {
        this.lastSoftKeyboardHeightInPx = keyboardHeightInPx;
        for (SoftKeyboardStateListener listener : listeners) {
            if (listener != null) {
                listener.onSoftKeyboardOpened(keyboardHeightInPx);
            }
        }
    }
    private void notifyOnSoftKeyboardClosed() {
        for (SoftKeyboardStateListener listener : listeners) {
            if (listener != null) {
                listener.onSoftKeyboardClosed();
            }
        }
    }
    private static float dpToPx(Context context, float valueInDp) {
        DisplayMetrics metrics = context.getResources().getDisplayMetrics();
        return TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP, valueInDp, metrics);
    }
}
使用的时候，在你的Activity或者Fragment中调用就可以了。而且，对软键盘的设置没有要求，不必要设置为某一特定模式。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
使用方式示例：
其中，mRootLayout为xml布局文件中的顶层布局（根布局）
this是上下文
----------------------------------------------------------------------------------------------------------
         final SoftKeyboardStateWatcher watcher = new SoftKeyboardStateWatcher(mRootLayout, this);
                watcher.addSoftKeyboardStateListener(
                        new SoftKeyboardStateWatcher.SoftKeyboardStateListener() {
                            @Override
                            public void onSoftKeyboardOpened(int keyboardHeightInPx) {
                                //处理一些键盘打开的事情
                            }
                            @Override
                            public void onSoftKeyboardClosed() {
								//处理一些键盘关闭的事情
                            }
                        }
                );
------------------------------------------------------------------------------------------------------------

关于windowToken

如果深入去看toggleSoftInput，showSoftInput、hideSoftInputFromWindow等方法的系统源码，
会发现windowToken这个对象经常出现，所以要理解windowToken这个对象的含义。
  • 待续

参考