概述
PopupWindow,顾名思义,就是弹窗.
基本用法
使用PopupWindow可以总结为三个步骤:
- 创建PopupWindow对象实例;
- 设置背景、注册事件监听器和添加动画;
- 显示PopupWindow。
常用方法介绍
-
void dismiss()
Disposes of the popup window.
This method can be invoked only after {@link #showAsDropDown(android.view.View)} has been executed.
Failing that, calling this method will have no effect.
处理弹出窗口,只能在showAsDropDown
执行后调用,不然的话 ,调用此方法没有任何作用. boolean isAboveAnchor()
-
void setAttachedInDecor(boolean enabled)
Indicates whether the popup is showing above (the y coordinate of the popup's bottom
is less than the y coordinate of the anchor) or below the anchor view (the y coordinate
of the popup is greater than y coordinate of the anchor's bottom).
指示弹出窗口是显示在锚View上方还是下面(判断弹窗是否依附于View) -
boolean isAttachedInDecor()
Indicates whether the popup window will be attached in the decor frame of its parent window.
指示弹出窗口是否将附加到其父窗口的装饰框架中。 boolean isClippingEnabled()
-
void setClippingEnabled(boolean enabled)
Indicates whether clipping of the popup window is enabled.
指示是否启用了弹出窗口的裁剪 -
boolean isFocusable()
Indicate whether the popup window can grab the focus.
指示弹出窗口是否可以捕获焦点。 -
boolean isLayoutInScreenEnabled()
Indicates whether the popup window will be forced into using absolute screen coordinates
for positioning.
指示弹出窗口是否强制使用绝对屏幕坐标进行定位。 -
boolean isOutsideTouchable()
Indicates whether the popup window will be informed of touch events
outside of its window.
指示弹出窗口是否会被告知其窗口之外的触摸事件。 -
boolean isShowing()
Indicate whether this popup window is showing on screen.
是否正在屏幕上显示 -
boolean isSplitTouchEnabled()
Indicates whether the popup window supports splitting touches.
指示弹出窗口是否支持分割触摸。 -
boolean isTouchable()
Indicates whether the popup window receives touch events.
指示弹出窗口是否接收触摸事件。 -
void setAnimationStyle(int animationStyle)
Change the animation style resource for this popup. -
void setBackgroundDrawable(Drawable background)
Specifies the background drawable for this popup window. The background can be set to {@code null}. -
void setClipToScreenEnabled(boolean enabled)
Clip this popup window to the screen, but not to the containing window.
将此弹出窗口剪辑到屏幕,但不夹到包含的窗口。 -
void setContentView(View contentView)
Change the popup's content. The content is represented by an instance of {@link android.view.View}. -
void setElevation(float elevation)
Specifies the elevation for this popup window.
指定此弹出窗口的高程 void setOnDismissListener(OnDismissListener onDismissListener)
void setOutsideTouchable(boolean touchable)
void setTouchable(boolean touchable)
void setTouchInterceptor(OnTouchListener l)
void setTouchModal(boolean touchModal)
-
void showAsDropDown(View anchor)
在锚定到锚点视图左下角的弹出窗口中显示内容视图。
相对某个控件的位置(正左下方),无偏移 void showAsDropDown(View anchor, int xoff, int yoff)
-
void showAsDropDown(View anchor, int xoff, int yoff, int gravity)
在弹出窗口中显示内容视图,该窗口锚定到锚点视图的左下角,偏移指定的x和y坐标 void showAtLocation(IBinder token, int gravity, int x, int y)
-
void showAtLocation(View parent, int gravity, int x, int y)
在指定位置的弹出窗口中显示内容视图
parent是PopupWindow的父View,gravity是PopupWindow相对父View的位置,
x和y分别是PopupWindow相对parent的x、y偏移
注意:parent如果传入的是view,会获取其父布局做为parent void update()
-
void update(int width, int height)
更新弹出窗口的位置和尺寸
实战
showAtLocation函数的使用
这个的坐标是相对于整个屏幕的,所以需要我们自己计算位置。
屏幕左上角,View是根布局
mCreditPW.showAtLocation(view, Gravity.NO_GRAVITY, 0, 0);
屏幕右边下角,默认情况
mCreditPW.showAtLocation(view, Gravity.BOTTOM | Gravity.RIGHT, 0, 0);
在指定view的左上角
int[] outLocation = new int[2];
view.getLocationInWindow(outLocation);
mCreditPW.showAtLocation(view, Gravity.NO_GRAVITY, outLocation[0], outLocation[1]);
在指定view的左下角
int y = outLocation[1] + view.getHeight();
mCreditPW.showAtLocation(view, Gravity.NO_GRAVITY, outLocation[0], y);
在指定view的偏移处
int xOffset = outLocation[0] + view.getWidth();
int yOffset = outLocation[1] + (int) UIUtils.dp2px(this, 30);
mCreditPW.showAtLocation(view, Gravity.NO_GRAVITY, outLocation[0], yOffset);
在指定view的上面和左侧指定偏移距离处展示
int xOffset0 = outLocation[0] - (int)UIUtils.dp2px(this,109);
int yOffset0 = outLocation[1] - (int) UIUtils.dp2px(this, 30);
mCreditPW.showAtLocation(view, Gravity.NO_GRAVITY, xOffset0, yOffset0);
showAsDropDown函数的使用
通常情况下,调用showAsDropDown方法后PopupWindow将会在锚点的左下方显示(drop down)。但是,有时想让PopupWindow在锚点的上方显示,或者在锚点的中间位置显示,此时就需要用到showAsDropDown方法的xoff和yoff参数了。
这里我们的目的不仅包括上面提到的两种情况(锚点上方或锚点中部),而是囊括了水平和垂直方向各5种显示方式:
- 水平方向:
- ALIGN_LEFT:在锚点内部的左边;
- ALIGN_RIGHT:在锚点内部的右边;
- CENTER_HORI:在锚点水平中部;
- TO_RIGHT:在锚点外部的右边;
- TO_LEFT:在锚点外部的左边。
- 垂直方向:
- ALIGN_ABOVE:在锚点内部的上方;
- ALIGN_BOTTOM:在锚点内部的下方;
- CENTER_VERT:在锚点垂直中部;
- TO_BOTTOM:在锚点外部的下方;
- TO_ABOVE:在锚点外部的上方。
//指定view下方弹框2
mCreditPW.showAsDropDown(view);
//指定view下方的最后面弹框
int xOffset8 = view.getWidth();
int yOffset8 = 0;
mCreditPW.showAsDropDown(view, xOffset8, yOffset8);
int xOffset9 = view.getWidth();
int yOffset9 = -(3 * view.getHeight());
mCreditPW.showAsDropDown(view, xOffset9, yOffset9);
int xOffset10 = -view.getWidth();
int yOffset10 = -(3 * view.getHeight());
mCreditPW.showAsDropDown(view, xOffset10, yOffset10);
-注意事项-
如果要使得PopupWindow在指定View的下方显示,则在指定PopupWindow高度的时候需要使用ViewGroup.LayoutParams.WRAP_CONTENT,否则会在屏幕顶部弹出来
高级进阶
popuawindow中弹框位置,合理弹出.
普通的View上方弹框
已知条件:
View的中心线坐标
PopupWindow宽度
屏幕的宽度
弹出位置:
左对齐(PopupWindow左侧和View横向中心线对齐)
右对齐(PopupWindow右侧和View横向中心线对齐)
场景分析:
当View横向中心线距离屏幕左侧距离(leftDistance)小于PopupWindow宽度(pwWidth)的时候
(leftDistance < pwWidth)-->左对齐
当View横向中心线距离屏幕右侧距离(rightDistance)小于PopupWindow宽度的时候
(rightDistance < pwWidth)-->右对齐
当View横向中心线距离屏幕左侧距离(leftDistance)和右侧距离(rightDistance),
都不小于PopupWindow宽度的时候
(leftDistance >= pwWidth || rightDistance >= pwWidth)
-->如何选择对齐方式:
距离左侧近,或者左右距离相等
(leftDistance <= rightDistance)-->左对齐
距离右侧近
(leftDistance > rightDistance)-->右对齐
普通的TextView左侧图标或者右侧图标上方弹框:
已知条件:
TextView的左侧或者右侧图标的中心线坐标:
PopupWindow宽度:pwWidth
屏幕的宽度:mScreenWidth
弹出位置:
TextView右图:
左对齐,左侧-->右图(PopupWindow左侧和TextView右图横向中心线对齐)
右对齐,右侧-->右图(PopupWindow右侧和TextView右图横向中心线对齐)
TextView左图:
右对齐,右侧-->左图(PopupWindow右侧和TextView左图横向中心线对齐)
左对齐,左侧-->左图(PopupWindow左侧和TextView左图横向中心线对齐)
场景分析:
TextView右图-->[3]
(左对齐,左侧-->右图)
TextView右图横向中心线距离屏幕右边的距离(rightDis) >= PopupWindow宽度
-->(rightDis >= pwWidth)
反之(右对齐,右侧-->右图)
-->(rightDis < pwWidth)
TextView左图-->[0]
(右对齐,右侧-->左图)
TextView左图横向中心线距离屏幕左边的距离(leftDis) >= PopupWindow宽度
-->(leftDis >= pwWidth)
反之(左对齐,左侧-->左图)
-->(leftDis < pwWidth)
效果图