您的位置:

详解WindowSoftInputMode

一、WindowSoftInputMode是什么?

WindowSoftInputMode是Android平台提供的一种机制,用于处理输入框弹出时的UI变化。开发者可以通过设置WindowSoftInputMode来告知平台输入框弹起时Activity应该如何调整其界面。具体而言,WindowSoftInputMode可以决定输入框弹起时软键盘是否覆盖输入框、上移或下移布局、以及是否隐藏ActionBar等行为。

二、WindowSoftInputMode的属性

WindowSoftInputMode属性可以设置在AndroidManifest.xml文件的Activity节点或者Activity中的onCreate()方法中,表示当软键盘弹起时Activity应该执行何种操作,属性如下:

1. stateUnspecified

状态未指定。Activity的默认值,系统默认处理软键盘的弹起方式。

2. stateUnchanged

状态未改变。不管输入框是否被遮挡,Activity都不做任何响应。

3. stateHidden

状态隐藏。当软键盘弹起时,Activity的布局会向上移动软键盘的高度。输入框仍然会被软键盘遮挡,需要手动向上滚动才能看到输入框。

   <activity
        android:name=".MyActivity"
        android:windowSoftInputMode="stateHidden"/>

4. stateAlwaysHidden

状态始终隐藏。与stateHidden相似,当软键盘弹起时,Activity的布局会向上移动软键盘的高度。不同的是,输入框不会被遮挡,始终可见,但此时需要为输入框设置一个滚动条,以便用户查看所有文本内容。

   <activity
        android:name=".MyActivity"
        android:windowSoftInputMode="stateAlwaysHidden"/>

5. stateVisible

状态可见。当软键盘弹起时,Activity的布局不会向上移动,软键盘会覆盖输入框。需要手动向上滚动才能看到输入框。

   <activity
        android:name=".MyActivity"
        android:windowSoftInputMode="stateVisible"/>

6. stateAlwaysVisible

状态始终可见。当软键盘弹起时,Activity的布局不会向上移动,软键盘会覆盖输入框。输入框不会被遮挡,始终可见。

   <activity
        android:name=".MyActivity"
        android:windowSoftInputMode="stateAlwaysVisible"/>

7. adjustUnspecified

调整未指定。Activity的默认值,系统默认处理输入框弹起时UI的调整方式。

8. adjustResize

调整大小。当软键盘弹起时,Activity的布局会自动调整高度,以便显示完整的输入框。此时可以自动滚动查看输入框内的文本。

   <activity
        android:name=".MyActivity"
        android:windowSoftInputMode="adjustResize"/>

9. adjustPan

调整位置。当软键盘弹起时,Activity的布局会自动向上平移,以便显示完整的输入框。此时不能自动滚动查看输入框内的文本。

   <activity
        android:name=".MyActivity"
        android:windowSoftInputMode="adjustPan"/>

三、如何使用WindowSoftInputMode属性?

WindowSoftInputMode属性可以设置在AndroidManifest.xml文件的Activity节点或者Activity中的onCreate()方法中。如果在Activity节点中设置WindowSoftInputMode属性,表示该Activity的所有实例都执行该设置;如果在onCreate()方法中设置,表示当前Activity的实例执行该设置。

下面是一个在AndroidManifest.xml文件中设置stateVisible和adjustResize的例子:

   <activity
        android:name=".MyActivity"
        android:windowSoftInputMode="stateVisible|adjustResize"/>

下面是一个在Activity中设置stateHidden和adjustPan的例子:

   public class MyActivity extends Activity {
       protected void onCreate(Bundle savedInstanceState) {
           super.onCreate(savedInstanceState);
           getWindow().setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_STATE_HIDDEN | WindowManager.LayoutParams.SOFT_INPUT_ADJUST_PAN);
       }
   }

四、总结

WindowSoftInputMode是Android平台提供的一种机制,用于处理输入框弹出时的UI变化。通过设置WindowSoftInputMode属性,可以告知平台输入框弹起时Activity应该如何调整其界面。AndroidManifest.xml文件的Activity节点或者Activity中的onCreate()方法都可以设置WindowSoftInputMode属性,便于开发者灵活地控制界面的UI变化。