一、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变化。