在 Android 开发中，`AlertDialog.Builder` 是一个非常常用的工具类，用于创建和管理对话框（Dialog）。它可以帮助开发者快速实现提示框、确认框等功能，同时支持高度定制化的设计。本文将详细介绍 `AlertDialog.Builder` 的基本用法以及一些高级技巧，帮助你更好地掌握这一功能。
一、基本用法
1. 创建 Builder 对象
首先需要通过 `AlertDialog.Builder` 创建一个实例对象。通常我们会传入当前的上下文（Context）作为参数。
```java
AlertDialog.Builder builder = new AlertDialog.Builder(context);
```
2. 设置对话框标题
使用 `setTitle()` 方法可以为对话框设置标题。
```java
builder.setTitle("提示");
```
3. 设置对话框内容
通过 `setMessage()` 方法可以定义对话框的主要信息或提示文字。
```java
builder.setMessage("您确定要继续吗？");
```
4. 添加按钮
使用 `setPositiveButton()` 和 `setNegativeButton()` 分别添加正面按钮和负面按钮，并为其绑定点击事件。
```java
builder.setPositiveButton("确定", new DialogInterface.OnClickListener() {
@Override
public void onClick(DialogInterface dialog, int which) {
// 点击确定后的操作
}
});
builder.setNegativeButton("取消", new DialogInterface.OnClickListener() {
@Override
public void onClick(DialogInterface dialog, int which) {
// 点击取消后的操作
}
});
```
5. 显示对话框
最后调用 `create()` 或 `show()` 方法来生成并展示对话框。
```java
AlertDialog dialog = builder.create();
dialog.show();
```
二、高级用法
除了上述基础功能外，`AlertDialog.Builder` 还提供了许多扩展选项，让开发者能够实现更复杂的需求。
1. 自定义布局
如果默认样式无法满足需求，可以通过 `setView()` 方法加载自定义的 XML 布局文件。
```xml
android:orientation="vertical" android:padding="16dp" android:layout_width="match_parent" android:layout_height="wrap_content"> android:id="@+id/custom_message" android:text="这是一个自定义消息" android:textSize="18sp" android:layout_width="wrap_content" android:layout_height="wrap_content"/> android:id="@+id/custom_button" android:text="点击我" android:layout_width="wrap_content" android:layout_height="wrap_content"/>
```
```java
View customView = LayoutInflater.from(context).inflate(R.layout.dialog_custom, null);
builder.setView(customView);
Button customButton = customView.findViewById(R.id.custom_button);
customButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Toast.makeText(context, "按钮被点击了！", Toast.LENGTH_SHORT).show();
}
});
```
2. 多选列表
利用 `setMultiChoiceItems()` 可以创建一个多选列表对话框。
```java
final String[] items = {"选项A", "选项B", "选项C"};
boolean[] checkedItems = {false, true, false};
builder.setMultiChoiceItems(items, checkedItems, new DialogInterface.OnMultiChoiceClickListener() {
@Override
public void onClick(DialogInterface dialog, int which, boolean isChecked) {
// 用户选择某一项时触发
}
});
```
3. 单选列表
类似地，`setSingleChoiceItems()` 可以用来创建单选列表对话框。
```java
builder.setSingleChoiceItems(items, 0, new DialogInterface.OnClickListener() {
@Override
public void onClick(DialogInterface dialog, int which) {
// 用户选择了某个选项
}
});
```
三、注意事项
- 在 Activity 中使用时，请确保 Dialog 的生命周期与 Activity 保持一致，避免内存泄漏。
- 如果需要动态更新对话框的内容，可以在每次调用 `show()` 前重新配置 Builder。
- 尽量减少不必要的资源占用，比如过大的图片或者复杂的动画效果。
通过以上介绍，相信你已经对 `AlertDialog.Builder` 的使用有了全面了解。无论是简单的提示框还是复杂的交互界面，都可以借助这个强大的工具轻松实现。希望本文对你有所帮助！
