PopupWindow使用详解

概述

PopupWindow，顾名思义，就是弹窗.

基本用法

使用PopupWindow可以总结为三个步骤：

1. 创建PopupWindow对象实例；
2. 设置背景、注册事件监听器和添加动画；
3. 显示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);

image.png

屏幕右边下角,默认情况

mCreditPW.showAtLocation(view, Gravity.BOTTOM | Gravity.RIGHT, 0, 0);

image.png

在指定view的左上角

int[] outLocation = new int[2];
view.getLocationInWindow(outLocation);
mCreditPW.showAtLocation(view, Gravity.NO_GRAVITY, outLocation[0], outLocation[1]);

image.png

在指定view的左下角

int y = outLocation[1] + view.getHeight();
mCreditPW.showAtLocation(view, Gravity.NO_GRAVITY, outLocation[0], y);

image.png

在指定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);

image.png

在指定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);

image.png

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);

高级进阶

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)  

---

效果图

image.png