Android弹窗_PopupWindow详解

我看网上对于PopupWindow的介绍非常的少就自己写一篇, 本文基本上分析了PopupWindow的所有方法.

PopupWindow是对于屏幕添加一个显示区域, 由于对位置和内容都非常自由所以常常在开发中用到.

看完后建议也看下PopupMenu详细使用

创建

一般用的构造方法.

1 2 3 4 5 6 7 8 9 10 11

PopupWindow () // 创建一个空的PopupWindow PopupWindow (View contentView) PopupWindow ( int width, int height) PopupWindow (View contentView, // PopupWindow的内容View, 相当于setContentView int width, // 宽, 相当于setwidth() int height, // 高, 相当于setHeight boolean focusable) // 是否可获取焦点, 相当于setFocusable()

通过上下文创建PopupWindow, 创建后默认有一个透明的背景.默认宽高(0,0), 没有内容和焦点的PopupWindow. 具体作用我也不知道, 估计是写自定义控件的吧. 但是PopupWindow并没有继承View.一般不使用该构造.

1 2 3 4 5 6 7 8 9 10 11 12 13

PopupWindow (Context context) PopupWindow (Context context, AttributeSet attrs) PopupWindow (Context context, AttributeSet attrs, int defStyleAttr) PopupWindow (Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes)

创建PopuWindow必要的三个条件:

1 2 3

void setHeight (int height) // 因为PopupWindow没有默认布局所以必须指定宽高 void setWidth (int width) void setContentView (View contentView) // 需要显示的内容

缺少一个就无法显示.

前面提到PopupWindow需要设置宽高, 那如果想用布局中的宽高怎么办呢?

可以用到LayoutParams.WRAP_CONTENT包裹布局. 布局多大就显示多大的PopupWindow

1	PopupWindow popupWindow = new PopupWindow(popupView, ViewGroup.LayoutParams.WRAP_CONTENT, ViewGroup.LayoutParams.WRAP_CONTENT, true);

显示

显示PopupWindow可以分为两种方式:

1. 附着某个控件showAsDropDown
2. 设置屏幕坐标showAtLocation

相对于当前控件

默认是PopupWindow的左上角对其控件的左下角

或者设置Gravity.RIGHT, PopupWindow的右上角对齐控件的右下角

不存在Gravity.TOP或Gravity.BOTTOM效果

1 2 3 4 5 6 7 8 9 10 11

void showAsDropDown (View anchor) // 弹窗显示在anchor控件左下方 void showAsDropDown (View anchor, int xoff, // 以控件左下角为原点的偏移坐标 int yoff) void showAsDropDown (View anchor, int xoff, int yoff, int gravity) // 弹窗显示在控件的左下方还是右下方, 参数Gravity.RIGHT/Gravity.LEFT. 默认是左下方

相对于当前窗口

当前窗口的任意位置(不包括状态栏)

1 2 3 4

void showAtLocation (View parent, // 该属性只要是屏幕上任意控件对象即可 int gravity, // 屏幕位置 int x, // 偏移坐标 int y)

parent:该属性只要是当前任意控件对象即可(View和ViewGroup都行), 官方文档介绍该对象参数主要是为了得到该对象的getWindowToken()方法.

需要注意的是多次调用show方法, 只会执行第一句

1 2 3 4

mPopupWindow.showAtLocation(popupwindow, Gravity.TOP, 100, 0); // 只有该行生效 mPopupWindow.showAtLocation(popupwindow, Gravity.LEFT, 100, 0); mPopupWindow.showAtLocation(popupwindow, Gravity.RIGHT, 100, 0); mPopupWindow.showAtLocation(popupwindow, Gravity.BOTTOM, 100, 0);

隐藏PopupWindow

该方法只能在show后才能执行否则crash

1	void dismiss ()

状态

可被点击

1 2	boolean isTouchable () // 判断是否可被点击 void setTouchable (boolean touchable) // 设置是否可被点击

多点触控

1 2	void setSplitTouchEnabled (boolean enabled) boolean isSplitTouchEnabled ()

忽略CheekPress事件

当物体触摸在屏幕上的尺寸超过手指尺寸范围, 将被判定为CheekPress事件(脸颊点击).

1	void setIgnoreCheekPress () // 默认为false, 即不忽略

弹窗外部被点击

如果为true点击PopupWindow外部区域可以取消PopupWindow

1 2	void setOutsideTouchable (boolean touchable) // 设置外部是否可被点击 boolean isOutsideTouchable ()

解决NavigationBar重叠

这是Android5.0(API22)后添加的方法, 默认为true. 为true时将不会与导航栏重叠.

1	void setAttachedInDecor (boolean enabled)

可获取焦点

一般控件都不需要焦点. 但是输入框EditText需要先获取焦点才能输入. 最重要的是当PopupWindow可获取焦点时按下手机返回键将不会销毁当前Activity而是关闭当前PopupWindow. 所以我们一般还是设置为true. 更加符合用户操作逻辑. 该方法为true时同时拥有setOutsideTouchable(true)的作用.

1 2	void setFocusable (boolean focusable) boolean isFocusable ()

设置背景

1 2	void setBackgroundDrawable (Drawable background) Drawable getBackground ()

阴影

该方法我测试无效

1 2	void setElevation (float elevation) float getElevation ()

附着View位置

该方法只在showAsDropDown()方法执行后才有效. 可以判断PopupWindow和附着View anchor谁的Y轴坐标小.

1	boolean isAboveAnchor ()

遮盖附着View

1 2	void setOverlapAnchor (boolean overlapAnchor) boolean getOverlapAnchor ()

可以从图中看到对齐方式从View anchor的左下角变成了左上角了.

设置PopupWindow宽高

该方法在API23后被废弃, 由setWidth(int) 和 setHeight(int)替代

1 2	void setWindowLayoutMode (int widthSpec, int heightSpec)

窗口裁剪

PopupWindow默认是不会超出屏幕边界的. 但是如果该方法为false时会采用精准位置, 能超出屏幕范围.

1 2	void setClippingEnabled (boolean enabled) boolean isClippingEnabled ()

演示超出屏幕:

1	mPopupWindow.showAtLocation(mBtnOpenPopup, Gravity.BOTTOM, 0, - 30);

动画效果

设置动画

可以设置popupWindow的显示和隐藏动画

1 2 3

void setAnimationStyle (int animationStyle) int getAnimationStyle ()

可以看到方法是传入一个Style的样式id

示例:

1 2 3 4

<style name="popupwindow_anim_style"> <item name="android:windowEnterAnimation">@anim/dialog_bottom_enter item> <item name="android:windowExitAnimation">@anim/dialog_bottom_exit item> style>

分别由两个属性组成. 两个属性各代表一个anim动画文件.

进入和退出动画

这是在Android6.0(API 23)后加入的方法. 配合Material Design的转场动画使用.

进入动画

1 2	void setEnterTransition (Transition enterTransition) Transition getEnterTransition ()

退出动画

1 2	void setExitTransition (Transition exitTransition) Transition getExitTransition ()

获取

获取最大高度

这是相当于传入的View对象可显示的最大高度. 即PopupWindow使用showAsDropDown()能够显示的最大高度

1 2 3 4 5 6 7 8

int getMaxAvailableHeight (View anchor) int getMaxAvailableHeight (View anchor, int yOffset) // 控件Y轴偏移后可显示的最大高度 int getMaxAvailableHeight (View anchor, // api24增加的方法, 由于我手上没有7.0设备就不说了. int yOffset, boolean ignoreBottomDecorations)

输入模式

针对PopupWindow中包含EditText控件.

输入模式

我使用该方法的三种模式我感觉并没有什么卵用

1 2	void setInputMethodMode (int mode) int getInputMethodMode ()

支持三种模式

1. INPUT_METHOD_FROM_FOCUSABLE 根据可否获取焦点判断是否可输入. 感觉鸡肋
2. INPUT_METHOD_NEEDED 允许输入
3. INPUT_METHOD_NOT_NEEDED 不允许输入

软键盘模式

1 2	void setSoftInputMode (int mode) // mode为WindowManager.LayoutParams的softInputMode常量 int getSoftInputMode ()

softInputMode

包含九种取值, 可组合使用,分为两类:

显示状态模式

1. SOFT_INPUT_STATE_UNSPECIFIED 默认模式
2. SOFT_INPUT_STATE_HIDDEN
3. SOFT_INPUT_STATE_ALWAYS_HIDDEN 总是隐藏
4. SOFT_INPUT_STATE_UNCHANGED
5. SOFT_INPUT_STATE_VISIBLE
6. SOFT_INPUT_STATE_ALWAYS_VISIBLE 自动弹出软键盘

调整模式

1. SOFT_INPUT_ADJUST_UNSPECIFIED 默认模式
2. SOFT_INPUT_ADJUST_RESIZE 软键盘弹出后PopupWindow会自动调整坐标,不被遮挡
3. SOFT_INPUT_ADJUST_PAN

监听事件

隐藏事件监听

即PopupWindow执行dismiss()后回调的方法.

1	void setOnDismissListener (PopupWindow.OnDismissListener onDismissListener)

触摸事件拦截

1	void setTouchInterceptor (View.OnTouchListener l)

更新

以下的更新PopupWindow都必须在PopupWindow处于以及被显示的状态下才行. 且PopupWindow的宽高设置都必须大于等于0. 如果想忽略PopupWindow的宽高设置就设为-1.

更新状态

该方法不能更新PopupWindow的宽高, 只能更新PopupWindow的状态. 例如更新Focusable和OutsideTouchable

1	void update ()

更新尺寸

上面说过update()不能更新PopupWindow的宽高, 但是提供更新宽高的update方法

1 2	void update (int width, // 更新PopupWindow的宽高 int height)

更新显示位置

该方法是相当于重新showAsDropDown, 所以这是相对于控件的位置更新

1 2 3 4 5 6 7 8 9

void update (View anchor, // 更新显示控件的位置 int width, int height) void update (View anchor, int xoff, // 相对于控件的偏移值 int yoff, int width, int height)

相对位置更新

是相对于当前的位置进行偏移. 不同的显示位置对于的相对原点也不同.

showAsDropDown的相对原点是整个屏幕左上角, 包括状态栏. 所以由于包括状态栏所以坐标偏移的时候一定要y轴偏移大于60超出状态栏的高度. 否则因为遮挡状态栏导致PopupWindow无法显示.

1	mPopupWindow.update( 50, 60, - 1,- 1); // x轴偏移50

showAtLocation的相对原点是自身位置.

1 2 3 4 5 6 7 8 9 10

void update (int x, // 坐标偏移 int y, int width, // PopupWindow宽高 int height) void update (int x, int y, int width, int height, boolean force) // 可获取焦点