最近学习android时发现,很多书上都介绍了preference首选项这个东西,但是大部分的书都是直接上来讲怎么用,对其的用途和来历都是只字不提,笔者本人对于这种做法是非常鄙视的。
为了简化与preference相关的应用开发,android为我们提供了一系列的api来帮助我们。主要有PreferenceActivity,ListPreference,EditTextPreference,CheckBoxPreference,RingtonePreference
下面我们简单的介绍下ListPreference的用法:
activity代码:
package cn.com.chenzheng_java.pref;
import android.os.Bundle;
import android.preference.ListPreference;
import android.preference.PreferenceActivity;
import android.preference.PreferenceManager;
import android.util.Log;
/**
* @description 有关首选项preferences的研究
* @author chenzheng_java
* @since 2011/03/29
* 继承了PreferenceActivity我们可以方便的对preference进行操作。
* 例如可以通过getPreferenceManager获取首选项管理器
* 那,我们可不可以不继承PreferenceActivity呢?当然可以,你还记得不记得,实际上Activity类中
* 就有个SharedPreferences getSharedPreferences(String name, int mode)方法呢,我们通过它
* 也可以对preference进行操作。当然了,如果我们不继承PreferenceActivity的话,那么我们就要手动的
* 对数据进行保存了。而不是跟现在一样,会自动的根据你的选择项进行数据保存。
* 那么,preference在这里是怎么样进行自动保存的呢,答案很简单,那就是在addPreferencesFromResource方法的具体实现中!
*/
public class MyPreferencesActivity extends PreferenceActivity {
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
addPreferencesFromResource(R.xml.mylistpreference);
/**
* getPreferenceManager返回首选项管理器对象
*/
PreferenceManager manager = getPreferenceManager();
// 根据android:key中指定的名称(相当于id)来获取首选项
ListPreference listPreference = (ListPreference) manager.findPreference("myListPreference");
Log.i("存储的值为", ""+listPreference.getValue());
}
}
res/xml/mylistperference.xml布局文件
<?xml version="1.0" encoding="utf-8"?>
<!--
对于该文件需要注意以下几点
第一:位置。该文件的位置是在res/xml/下的。
第二:格式,PreferenceScreen为根标签,ListPreference为子标签
第三:标签属性含义
android:key 唯一标识符,和android:id相类似,PreferenceManager可以以其为参数通过findPreference获取指定的preference
android:title 整个屏幕的标题
android:summary 选项的简单说明
android:entries 弹出的对话框中,列表显示的文本内容,注意哦,这里指定的是一个数组哦
android:entryValues 与android:entries相对应的值
android:defaultValue 当对应值不存在时的默认值
android:dialogTitle 弹出的对话框中的标题信息
-->
<PreferenceScreen
xmlns:android="http://schemas.android.com/apk/res/android"
android:key="screen_list"
android:title="标题"
android:summary="说明摘要"
>
<ListPreference
android:key="myListPreference"
android:title="标题"
android:summary="说明摘要"
android:entries="@array/list_entries"
android:entryValues="@array/list_entries_value"
android:dialogTitle="dialogTitle"
android:defaultValue="@array/list_entries_value2"
></ListPreference>
</PreferenceScreen>
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string-array name="list_entries">
<item>山东</item>
<item>福建</item>
<item>北京</item>
<item>河北</item>
</string-array>
<string-array name="list_entries_value">
<item>shandong1</item>
<item>fujian1</item>
<item>beijing1</item>
<item>hebei1</item>
</string-array>
<string-array name="list_entries_value2">
<item>shandong2</item>
<item>fujian2</item>
<item>beijing2</item>
<item>hebei2</item>
</string-array>
</resources>
<?xml version='1.0' encoding='utf-8' standalone='yes' ?>
<map>
<string name="myListPreference">fujian1</string>
</map>
本文来自CSDN博客,转载请标明出处:http://blog.csdn.net/chenzheng_java/archive/2011/03/29/6285966.aspx
效果如上。代码很简单:
package cn.com.chenzheng_java.pref;
import android.os.Bundle;
import android.preference.PreferenceActivity;
/**
* @description 有关首选项preferences的研究
* @author chenzheng_java
* @since 2011/03/29
*/
public class MyPreferencesActivity extends PreferenceActivity {
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
addPreferencesFromResource(R.xml.checkbox);
}
}
package cn.com.chenzheng_java.pref;
import android.preference.PreferenceActivity;
/**
* @description 有关首选项preferences的研究
* @author chenzheng_java
* @since 2011/03/29
*/
public class MyPreferencesActivity extends PreferenceActivity {
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
addPreferencesFromResource(R.xml.checkbox);
}
}
<?xml version="1.0" encoding="utf-8"?>
<PreferenceScreen
xmlns:android="http://schemas.android.com/apk/res/android"
android:title="屏幕标题"
android:key="mycheckbox_screen"
android:summary="复选框介绍"
>
<CheckBoxPreference
android:key="shandong"
android:title="山东"
android:summaryOn="山东被选中了"
android:summaryOff="山东未被选中"
></CheckBoxPreference>
<CheckBoxPreference
android:key="shanghai"
android:title="上海"
android:summaryOn="上海被选中了"
android:summaryOff="上海未被选中"
></CheckBoxPreference>
<CheckBoxPreference
android:key="yunnan"
android:title="云南"
android:summaryOn="云南被选中了"
android:summaryOff="云南未被选中"
></CheckBoxPreference>
</PreferenceScreen>
<?xml version='1.0' encoding='utf-8' standalone='yes' ?>
<map>
<string name="myListPreference">hebei1</string>
<boolean name="shanghai" value="true" />
<boolean name="shandong" value="true" />
</map>
可以看到,其为我们选择的每一个checkbox项定义了一行数据哦。
Android学习笔记--创建Dialog
1.分类
(1)AlertDialog.它能够管理0个`1个`2个`3个按钮和一个包含radio或者checkbox的可选项列表.
(2)ProgressDialog.一个用于显示进度圈或者进度条的dialog,继承自AlertDialog,所以它也支持按钮.
(3)DatePickerDialog.用于让用户选择日期的dialog.
(4)TimePickerDialog.用于让用户选择时间的dialog.
如果你需要定义自己的dialog,只需要继承dialog或者上面提到四个组件之一, 并且为新的dialog定义自己的布局就可以了.
2.显示dialog
(1)一个dialog总是作为某个Activity的一部分被创建和显示.创建dialog当然是在Activity的onCreateDialog方法里做了,但是在创建不同用途的dialog却有章可循,推荐的方式是使用switch...case...结构.比如一个游戏里可能需要暂停和结束两种dialog,那我们的示例代码如下:
static final int DIALOG_PAUSED_ID = 0;
static final int DIALOG_GAMEOVER_ID = 1;
protected Dialog onCreateDialog(int id) {
Dialog dialog;
switch(id) {
case DIALOG_PAUSED_ID:
// do the work to define the pause Dialog
break;
case DIALOG_GAMEOVER_ID:
// do the work to define the game over Dialog
break;
default:
dialog = null;
}
return dialog;
}
(2)当你想显示一个dialog的时候,使用showDialog(int id),参数id是你要显示的dialog的ID.
(3)如果想在每次打开dialog的时候显示的内容有所不同,你应该考虑使用onPrepareDialog(int,Dialog)方法.它会在每次打开dialog时被调用,而不是像
onCreateDialog那样只在创建时被调用.
(4)注意:如果你在onCreateDialog方法之外创建一个dialog,它不会默认被绑定到当前的Activity,但是你可以通过setOwnerActivity(Activity)方法来强制绑定.
3.关闭dialog
(1)当你打算关闭一个dialog时,在dialog对象上调用dismiss()方法或者直接在Activity里调用dismissDialog(int)方法都可以达到这个目的.
实际上他俩是完全一样的,下面是dismissDialog方法的代码:
public final void dismissDialog(int id) {
if (mManagedDialogs == null) {
throw missingDialog(id);
}
final Dialog dialog = mManagedDialogs.get(id);
if (dialog == null) {
throw missingDialog(id);
}
dialog.dismiss();
}
(如果你正在使用onCreateDialog(int)方法管理你所有的dialog的状态),每次使用dismissDialog(int)方法关闭dialog时,Activity还会保留此dialog的状态.如果你确信不再需要已经关闭的dialog对象或者清除先前的状态对你的程序非常重要,那么你应该使用removeDialog(int),它会清除所有指向这个dialog对象的引用并且关闭它(如果这个dialog正在显示的话).下面是removeDialog方法的代码:
public final void removeDialog(int id) {
if (mManagedDialogs == null) {
return;
}
final Dialog dialog = mManagedDialogs.get(id);
if (dialog == null) {
return;
}
dialog.dismiss();
mManagedDialogs.remove(id);//这句做了些什么呢,还没仔细看
}
(2)使用dismiss listeners
如果想在关闭dialog的时候执行某些程序,那你应该考虑使用DialogInterface.OnDismissListener.使用方法如下代码所示:
Dialog dialog = new Dialog(this);
dialog.setOnDismissListener(new DialogInterface.OnDismissListener() {
public void onDismiss(DialogInterface dialog) {
// write your performance here
}
});
dialog也有cancel状态,这是一种较特殊的情况.当用户点击"返回","取消"或者程序里明确调用了dialog.cancel()方法时发生.注意,这个时候,
先前注册的OnDismissListener仍然会被通知(即触发调用).如果你想发出明确的取消通知(而不是简单的关闭),那你就应该使用setOnCancelListener()方法注册一个DialogInterface.OnCancelListener来做这件事.
4.创建一个AlertDialog
AlertDialog类继承于 Dialog 类.它是系统推荐的方式,能够构造出用户界面上的大多数dialog.有如下任何一个需求时,你应该考虑使用它:
显示一行标题文本;
显示一段文本消息;
让用户选择由一个`两个或者三个按钮代表的操作;
显示一个可选项列表(checkbox button或者radio button)
AlertDialog.Builder子类用来创建一个AlertDialog.首先使用new AlertDialog.Builder(this)来创建一个Builder对象,然后使用它的公有
接口方法设置AlertDialog的所有属性.完成后可以通过builder.create()来得到新创建的dialog.下面是使用AlertDialog.Builder类来创建不同的AlertDialog的方法:
(1)带button的Dialog
AlertDialog.Builder builder = new AlertDialog.Builder(this);
builder.setMessage("Are you sure you want to exit?")
.setCancelable(false)
.setPositiveButton("Yes", new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int id) {
MyActivity.this.finish();
}
})
.setNegativeButton("No", new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int id) {
dialog.cancel();
}
});
AlertDialog alert = builder.create();
注意:这里的按钮有三类setPositiveButton,setNegativeButton,setNeutralButton, 每一类只允许添加一次, 也就是最多三个按钮.按钮的种类
名称只是帮助我们区分对待它们,与它们的实际功能(由我们自己在onClick方法里定义)无关.
(2)添加一个列表
这个比较简单,给出代码示例
final CharSequence[] items = {"Red", "Green", "Blue"};
AlertDialog.Builder builder = new AlertDialog.Builder(this);
builder.setTitle("Pick a color");
builder.setItems(items, new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int item) {
Toast.makeText(getApplicationContext(), items[item], Toast.LENGTH_SHORT).show();
}
});
AlertDialog alert = builder.create();
(3)添加checkbox 和 radio 按钮
在dialog里创建多选和单选列表应分别使用setMultiChoiceItems()和setSingleChoiceItems()方法.下面是创建一个单选项列表的代码:
final CharSequence[] items = {"Red", "Green", "Blue"};
AlertDialog.Builder builder = new AlertDialog.Builder(this);
builder.setTitle("Pick a color");
builder.setSingleChoiceItems(items, -1, new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int item) {
Toast.makeText(getApplicationContext(), items[item], Toast.LENGTH_SHORT).show();
}
});
AlertDialog alert = builder.create();
其中,setSingleChoiceItems()方法里第二个参数的意思是默认时选中哪一项,-1表示默认不选中任何一项.
注意:这样的情况下,用户可能希望这些值能被记忆并且恢复.要持久化存储这些选项的值,须借助android的数据存取技术.
(4)创建ProgressDialog
ProgressDialog dialog = ProgressDialog.show(MyActivity.this, "",
"Loading. Please wait...", true);
第一个参数为应用程序的Context(上下文);第二个参数为dialog的title;第三个参数是要显示的消息文本;the last parameter is whether the progress is indeterminate.
ProgressDialog的默认样式是一个旋转的轮子.如果要创建一个能显示即时进度的工具条,需要更多一点的代码:
ProgressDialog progressDialog;
progressDialog = new ProgressDialog(mContext);
progressDialog.setProgressStyle(ProgressDialog.STYLE_HORIZONTAL);
progressDialog.setMessage("Loading...");
progressDialog.setCancelable(false);
这个代码在我测试的时候不能直接运行,会报出以下异常:
E/AndroidRuntime( 278): Uncaught handler: thread main exiting due to uncaught exception
E/AndroidRuntime( 278): android.view.WindowManager$BadTokenException: Unable to add window -- token
解决办法是把第二行换成下面这样就可以了:
progressDialog = new ProgressDialog(DialogActivity.this);//这里要写程序中Activity的名字
(5)创建自定义的Dialog
根据使用基类的不同可以分作两类:
使用Dialog类构造;
使用AlertDialog类构造
两种类别的不同在于,前者的Title不能为空.如果你不设置title里的文字,它占据的空间会空着,这样显然不美观.而用后面一种方法就不会出现这种问题,不设置title,Dialog里就不显示,不影响美观.所以,还是回到那句话,更推荐使用AlertDialog组件.
5.接口收集
(1)Activity里与其相关的方法:
protected Dialog onCreateDialog(int id)
protected void onPrepareDialog(int id, Dialog dialog)
public final void showDialog(int id)
public final void dismissDialog(int id)
public final void removeDialog(int id)
(2)android.content.DialogInterface:
interface OnCancelListener
interface OnDismissListener
interface OnShowListener
interface OnClickListener
interface OnMultiChoiceClickListener
interface OnKeyListener
(3)/android-src/frameworks/base/core/java/android/app/Dialog.java类及其子类里的所有方法