本章节翻译自《Beginning-Android-4-Application-Development》,如有翻译不当的地方,敬请指出。
原书购买地址http://www.amazon.com/Beginning-Android-4-Application-Development/dp/1118199545/
我们也可以创建另外一种碎片——DialogFragment。顾名思义,DialogFragment就是一个浮动在Activity上面的Fragment。当需要用户的反馈时,DialogFragment就会派上用场。与使用ListFragment类似,需要继承DialogFragment基类。
下面将会展示如何使用DialogFragment。
1. 创建一个工程:DialogFragmentExample。
2. 在包路径下面新建一个类,Fragment1。
- public class Fragment1 extends DialogFragment {
- static Fragment1 newInstance(String title) {
- Fragment1 fragment = new Fragment1();
- Bundle args = new Bundle();
- args.putString("title", title);
- fragment.setArguments(args);
- return fragment;
- }
- @Override
- public Dialog onCreateDialog(Bundle savedInstanceState) {
- String title = getArguments().getString("title");
- return new AlertDialog.Builder(getActivity())
- .setIcon(R.drawable.ic_launcher)
- .setTitle(title)
- .setPositiveButton("OK",
- new DialogInterface.OnClickListener() {
- public void onClick(DialogInterface dialog,
- int whichButton) {
- ((DialogFragmentExampleActivity)
- getActivity()).doPositiveClick();
- }
- })
- .setNegativeButton("Cancel",
- new DialogInterface.OnClickListener() {
- public void onClick(DialogInterface dialog,
- int whichButton) {
- ((DialogFragmentExampleActivity)
- getActivity()).doNegativeClick();
- }
- }).create();
- }
- }
public class Fragment1 extends DialogFragment {
static Fragment1 newInstance(String title) {
Fragment1 fragment = new Fragment1();
Bundle args = new Bundle();
args.putString("title", title);
fragment.setArguments(args);
return fragment;
}
@Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
String title = getArguments().getString("title");
return new AlertDialog.Builder(getActivity())
.setIcon(R.drawable.ic_launcher)
.setTitle(title)
.setPositiveButton("OK",
new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog,
int whichButton) {
((DialogFragmentExampleActivity)
getActivity()).doPositiveClick();
}
})
.setNegativeButton("Cancel",
new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog,
int whichButton) {
((DialogFragmentExampleActivity)
getActivity()).doNegativeClick();
}
}).create();
}
}
3. DialogFragmentExampleActivity.java中的代码。
- public class DialogFragmentExampleActivity extends Activity {
- /** Called when the activity is first created. */
- @Override
- public void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- setContentView(R.layout.main);
- Fragment1 dialogFragment = Fragment1.newInstance(
- "Are you sure you want to do this?");
- dialogFragment.show(getFragmentManager(), "dialog");
- }
- public void doPositiveClick() {
- //---perform steps when user clicks on OK---
- Log.d("DialogFragmentExample", "User clicks on OK");
- }
- public void doNegativeClick() {
- //---perform steps when user clicks on Cancel---
- Log.d("DialogFragmentExample", "User clicks on Cancel");
- }
- }
public class DialogFragmentExampleActivity extends Activity {
/** Called when the activity is first created. */
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
Fragment1 dialogFragment = Fragment1.newInstance(
"Are you sure you want to do this?");
dialogFragment.show(getFragmentManager(), "dialog");
}
public void doPositiveClick() {
//---perform steps when user clicks on OK---
Log.d("DialogFragmentExample", "User clicks on OK");
}
public void doNegativeClick() {
//---perform steps when user clicks on Cancel---
Log.d("DialogFragmentExample", "User clicks on Cancel");
}
}
4. 按F11在模拟器上调试。会看到一个对话框,点击OK或Cancel按钮会弹出消息。
要创建一个DialogFragment,首先要继承DialogFragment基类:
- public class Fragment1 extends DialogFragment{
- }
public class Fragment1 extends DialogFragment{
}
在这个例子中,我没创建一个警告对话框,它包含一条警告消息和两个可供点击的按钮。在Fragment1类中,我们定义了一个newInstance()方法:
- static Fragment1 newInstance(String title) {
- Fragment1 fragment = new Fragment1();
- Bundle args = new Bundle();
- args.putString("title", title);
- fragment.setArguments(args);
- return fragment;
- }
static Fragment1 newInstance(String title) {
Fragment1 fragment = new Fragment1();
Bundle args = new Bundle();
args.putString("title", title);
fragment.setArguments(args);
return fragment;
}
这个newInstance()方法允许创建一个碎片的实例对象,同时,它也可以接受一个指定的字符串参数,这个参数就是对话框中的消息。title对象被存储在一个Bundle对象中,之后会用到它。
接下来,我们定义了onCreateDialog()方法,这个方法在onCreate()之后,onCreateView()之前被调用:
- @Override
- public Dialog onCreateDialog(Bundle savedInstanceState) {
- String title = getArguments().getString("title");
- return new AlertDialog.Builder(getActivity())
- .setIcon(R.drawable.ic_launcher)
- .setTitle(title)
- .setPositiveButton("OK",
- new DialogInterface.OnClickListener() {
- public void onClick(DialogInterface dialog,
- int whichButton) {
- ((DialogFragmentExampleActivity)
- getActivity()).doPositiveClick();
- }
- })
- .setNegativeButton("Cancel",
- new DialogInterface.OnClickListener() {
- public void onClick(DialogInterface dialog,
- int whichButton) {
- ((DialogFragmentExampleActivity)
- getActivity()).doNegativeClick();
- }
- }).create();
- }
@Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
String title = getArguments().getString("title");
return new AlertDialog.Builder(getActivity())
.setIcon(R.drawable.ic_launcher)
.setTitle(title)
.setPositiveButton("OK",
new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog,
int whichButton) {
((DialogFragmentExampleActivity)
getActivity()).doPositiveClick();
}
})
.setNegativeButton("Cancel",
new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog,
int whichButton) {
((DialogFragmentExampleActivity)
getActivity()).doNegativeClick();
}
}).create();
}
然后,我们可以创建两个按钮OK和Cancel。对话框的标题是从Bunddle对象中取出来的。
想要把对话框碎片显示出来,我们创建一个它的实例,然后调用show()方法即可:
- Fragment1 dialogFragment = Fragment1.newInstance(
- "Are you sure you want to do this?");
- dialogFragment.show(getFragmentManager(), "dialog");
Fragment1 dialogFragment = Fragment1.newInstance(
"Are you sure you want to do this?");
dialogFragment.show(getFragmentManager(), "dialog");
同时,我们需要实现两个回调方法,doPositiveClick()和doNegativeClick(),通过这两个方法去处理用户的输入事件:
- public void doPositiveClick() {
- //---perform steps when user clicks on OK---
- Log.d("DialogFragmentExample", "User clicks on OK");
- }
- public void doNegativeClick() {
- //---perform steps when user clicks on Cancel---
- Log.d("DialogFragmentExample", "User clicks on Cancel");
- }
public void doPositiveClick() {
//---perform steps when user clicks on OK---
Log.d("DialogFragmentExample", "User clicks on OK");
}
public void doNegativeClick() {
//---perform steps when user clicks on Cancel---
Log.d("DialogFragmentExample", "User clicks on Cancel");
}
注:在Android 4.0版本以后,官方推荐使用DialogFragment去替换Dialog。大家可以看看Android 4.0的Launcher等源码,这些源码中大量使用了Fragment类。