new popupwindow参数有哪些具体作用？

PopupWindow 的核心是它的构造函数，通过传入不同的参数，我们可以定制弹窗的样式、大小和背景行为。

核心构造函数 (Java / Kotlin)

PopupWindow 提供了多个构造函数重载，但最常用和最灵活的是下面这个，其他构造函数通常是它的简化版。

最常用的构造函数

这个构造函数允许你一次性设置弹窗的内容视图、宽度和高度。

// Java
public PopupWindow(View contentView, int width, int height)

// Kotlin
constructor(contentView: View?, width: Int, height: Int)

参数详解:

1. contentView: View?

   
   （图片来源网络，侵删）
   • 作用: 这是 PopupWindow 的核心，它决定了弹窗内部显示什么内容，你可以传入任何 View 对象，比如一个 TextView、Button，或者更常见的、通过 LayoutInflater 从 XML 布局文件中加载的 View。
   • 如何创建:

     // Java
     View contentView = LayoutInflater.from(context).inflate(R.layout.popup_layout, null);
     PopupWindow popupWindow = new PopupWindow(contentView, ViewGroup.LayoutParams.WRAP_CONTENT, ViewGroup.LayoutParams.WRAP_CONTENT);

     // Kotlin
     val contentView = LayoutInflater.from(context).inflate(R.layout.popup_layout, null)
     val popupWindow = PopupWindow(contentView, ViewGroup.LayoutParams.WRAP_CONTENT, ViewGroup.LayoutParams.WRAP_CONTENT)

2. width: Int

   • 作用: 设置弹窗的宽度。
   • 常用值:
     • ViewGroup.LayoutParams.WRAP_CONTENT: 让弹窗宽度自适应其内容（最常用）。
     • ViewGroup.LayoutParams.MATCH_PARENT: 让弹窗宽度填满其父容器（在 showAsDropDown 等场景下很有用）。
     • 一个具体的像素值 (500): 设置一个固定的宽度。
     • WindowManager.LayoutParams.MATCH_PARENT: 效果等同于 MATCH_PARENT。

3. height: Int

   • 作用: 设置弹窗的高度。
   • 常用值:
     • ViewGroup.LayoutParams.WRAP_CONTENT: 让弹窗高度自适应其内容（最常用）。
     • ViewGroup.LayoutParams.MATCH_PARENT: 让弹窗高度填满其父容器。
     • 一个具体的像素值 (300): 设置一个固定的高度。

其他构造函数

除了上面最常用的,还有几个简化版的构造函数：

构造函数 2: 只指定宽高，内容为空

// Java
public PopupWindow(int width, int height)

这个构造函数创建一个空的 PopupWindow，之后你必须调用 setContentView(View) 来设置内容。

构造函数 3: 从资源ID加载布局

// Java
public PopupWindow(Context context, AttributeSet attrs, int defStyleAttr)

这个构造函数主要用于在 XML 布局文件中直接定义 PopupWindow（不常用），通常我们不会在代码中直接使用它。

关键属性设置方法

除了构造函数,PopupWindow 还提供了大量的 set... 方法来配置其行为和外观，这些方法比构造函数参数更重要，因为它们定义了弹窗的交互逻辑。

A. 核心行为设置

1. setFocusable(boolean focusable)

   • 作用: 这是最重要的属性之一！它决定了 PopupWindow 是否可以获取焦点。
   • true (默认): 弹窗会获取焦点，这意味着：
     • 点击弹窗外部区域,弹窗会自动消失（需要配合 setBackgroundDrawable）。
     • 弹窗会拦截事件,导致后面的 View 无法响应点击。
     • 弹窗内的 EditText 可以正常输入。
   • false: 弹窗不会获取焦点，这意味着：
     • 点击弹窗外部,弹窗不会消失。
     • 点击事件会穿透弹窗,传递到后面的 View。
     • 弹窗内的 EditText 可能无法弹出软键盘。
   • 推荐做法: 通常设置为 true 以获得良好的用户体验。

2. setOutsideTouchable(boolean touchable)

   • 作用: 设置点击弹窗外部区域时是否触发事件。
   • 注意: 此方法必须在 setFocusable(true) 的前提下才有效。focusable 为 false，此设置无效。
   • true (默认): 点击弹窗外部，PopupWindow 会收到一个 onDismiss() 回调，但弹窗本身不会自动消失，你需要手动在 onDismiss 中关闭它，或者更简单的方式是配合 setBackgroundDrawable。
   • 最佳实践: 将 setFocusable(true) 和 setOutsideTouchable(true) 结合使用，并设置一个背景 Drawable，即可实现点击外部关闭弹窗的效果。

3. setBackgroundDrawable(Drawable background)

   • 作用: 设置弹窗的背景，这不仅仅是为了美观，更是为了处理触摸事件。
   • 关键点: 如果你希望点击弹窗外部区域能关闭弹窗，必须设置一个非空的背景 Drawable，哪怕是透明的也可以。
   • 示例:

     // 设置一个透明的背景，以支持点击外部关闭
     popupWindow.setBackground(new ColorDrawable(Color.TRANSPARENT));

B. 外观与动画设置

1. setAnimationStyle(int animationStyle)

   • 作用: 为弹窗的显示和隐藏设置动画效果。
   • 如何使用:
     1. 在 res/values/styles.xml 中定义一个动画样式：

        <resources>
            <style name="PopupAnimation" parent="android:Animation">
                <item name="android:windowEnterAnimation">@anim/popup_enter</item>
                <item name="android:windowExitAnimation">@anim/popup_exit</item>
            </style>
        </resources>

     2. 创建进入和退出动画文件 (res/anim/popup_enter.xml 和 res/anim/popup_exit.xml)。
     3. 在代码中应用：

        popupWindow.setAnimationStyle(R.style.PopupAnimation);

2. setElevation(float elevation) (API 21+)

   • 作用: 设置弹窗的阴影高度，可以产生类似 CardView 的悬浮效果，使其在视觉上与背景分离。

3. setContentView(View view)

   • 作用: 如果使用了只指定宽高的构造函数，或者想动态更换弹窗内容，可以使用此方法。

完整代码示例

下面是一个结合了上述参数和设置的完整示例。

布局文件 res/layout/popup_layout.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:background="@drawable/popup_background"
    android:orientation="vertical"
    android:padding="16dp">
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="这是一个PopupWindow"
        android:textSize="18sp" />
    <Button
        android:id="@+id/btn_popup_close"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginTop="16dp"
        android:text="关闭我" />
</LinearLayout>

弹窗背景 res/drawable/popup_background.xml

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android">
    <solid android:color="#FFFFFF" />
    <corners android:radius="8dp" />
    <stroke android:width="1dp" android:color="#CCCCCC" />
</shape>

Activity/Fragment 中的代码 (Java)

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Button showPopupButton = findViewById(R.id.btn_show_popup);
        showPopupButton.setOnClickListener(v -> showPopup());
    }
    private void showPopup() {
        // 1. 创建弹窗内容视图
        View contentView = LayoutInflater.from(this).inflate(R.layout.popup_layout, null);
        // 2. 创建 PopupWindow 实例
        // 参数：内容视图、宽度、高度
        PopupWindow popupWindow = new PopupWindow(
                contentView,
                ViewGroup.LayoutParams.WRAP_CONTENT, // 宽度自适应内容
                ViewGroup.LayoutParams.WRAP_CONTENT  // 高度自适应内容
        );
        // 3. 设置关键属性
        popupWindow.setFocusable(true); // 使其能够获取焦点，响应点击事件
        popupWindow.setOutsideTouchable(true); // 点击外部区域可响应
        popupWindow.setBackgroundDrawable(new ColorDrawable(Color.TRANSPARENT)); // 必须设置背景才能实现点击外部关闭
        // 4. 设置动画 (可选)
        // popupWindow.setAnimationStyle(R.style.PopupAnimation);
        // 5. 设置弹窗内容的点击事件
        Button closeButton = contentView.findViewById(R.id.btn_popup_close);
        closeButton.setOnClickListener(v -> {
            // 点击按钮关闭弹窗
            popupWindow.dismiss();
        });
        // 6. 显示弹窗
        // showAsDropDown(锚点视图, x偏移, y偏移)
        View anchorView = findViewById(R.id.btn_show_popup);
        popupWindow.showAsDropDown(anchorView, 0, 10); // 在按钮下方显示，向下偏移10像素
    }
}

总结表格

希望这份详细的解析能帮助你完全掌握 PopupWindow 的参数使用！