作为一款广受欢迎的移动操作系统，Android提供了强大的开发工具和框架，使开发者能够轻松地构建高品质的应用程序。在Android应用程序中，常常需要让用户设置一些个性化的配置，这个时候就需要使用到Preference（偏好设置）这个类。

Preference是Android开发中的一个重要概念，它提供了一种用户友好的设置界面，允许用户通过一个“设置”页面来修改应用程序的设置项。其中，ListPreference是Preference的一种特殊类型，它可以实现以列表形式展示多个选项，并且允许用户选择其中的任意一个。

本文将详细介绍ListPreference的用法，包括创建和初始化、修改和保存、读取和使用等一系列操作。希望本文能够为广大Android开发者提供帮助，让你们轻松地掌握ListPreference的使用方法。

一、创建和初始化ListPreference

1. 在xml布局文件中定义ListPreference

在创建ListPreference之前，首先需要在res/xml目录下创建preference.xml文件，然后在该文件中定义ListPreference实例。

android:title="选择语言"

android:key="language"

android:entries="@array/lang_entries"

android:entryValues="@array/lang_values"

android:defaultValue="chinese" />

在上述xml布局文件中，我们创建了一个PreferenceScreen实例，并在其中定义了一个PreferenceCategory实例。PreferenceCategory是Preference的一种容器，它可以将多个Preference组合在一起，形成一个组。在该PreferenceCategory中，我们创建了一个ListPreference实例，用于显示多个语言选项供用户选择。

在ListPreference中，有几个重要的属性需要了解和掌握。

·android:title：ListPreference显示的标题；

·android:key：ListPreference的唯一标识符，用于保存和读取用户的选择；

·android:entries：用于显示在ListPreference中的字符串数组，每个字符串代表一个选项；

·android:entryValues：用于保存在ListPreference中的字符串数组，每个字符串对应一个选项的值，这个值将被保存到SharedPreferences中；

·android:defaultValue：ListPreference默认值。

2. 在Activity中初始化ListPreference

在完成xml布局文件的定义之后，需要在Activity中初始化ListPreference实例，并且注册Preference的变化监听器。在这里，我们需要使用SharedPreferences类来保存和读取用户的选择。

public class SettingsActivity extends PreferenceActivity

implements OnSharedPreferenceChangeListener {

private ListPreference mLanguagePreference;

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

addPreferencesFromResource(R.xml.preference);

mLanguagePreference = (ListPreference) findPreference("language");

mLanguagePreference.setOnPreferenceChangeListener(this);

}

@Override

public void onSharedPreferenceChanged(SharedPreferences sharedPreferences, String key) {

if (key.equals("language")) {

mLanguagePreference.setSummary(sharedPreferences.getString(key, ""));

}

}

}

在上述代码中，我们首先调用addPreferencesFromResource方法来加载preference.xml文件，然后获取ListPreference实例，设置其变化监听器为当前Activity。在onSharedPreferenceChanged回调方法中，我们可以检测到ListPreference的变化，将用户选择的值保存到SharedPreferences中，然后更新ListPreference的摘要值。

二、修改和保存ListPreference

1. 修改ListPreference的值

对于ListPreference实例，允许用户使用下拉菜单来选择一个选项。当用户选择了一个不同的选项后，ListPreference的值将会发生变化。

public class SettingsActivity extends PreferenceActivity

implements OnSharedPreferenceChangeListener {

private ListPreference mLanguagePreference;

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

addPreferencesFromResource(R.xml.preference);

mLanguagePreference = (ListPreference) findPreference("language");

mLanguagePreference.setOnPreferenceChangeListener(this);

}

@Override

public void onSharedPreferenceChanged(SharedPreferences sharedPreferences, String key) {

if (key.equals("language")) {

mLanguagePreference.setSummary(sharedPreferences.getString(key, ""));

}

}

// 修改ListPreference的值

private void updateLanguagePreference(String value) {

SharedPreferences.Editor editor = PreferenceManager.getDefaultSharedPreferences(this).edit();

editor.putString("language", value);

editor.commit();

}

}

在上述代码中，我们定义了updateLanguagePreference方法，在这个方法中使用SharedPreferences.Editor将新值保存到SharedPreferences中。

2. 保存ListPreference的值

在用户修改ListPreference的值后，需要将新值保存到SharedPreferences中，否则下次打开应用程序时，ListPreference会显示上一次用户的选择，而不是最新值。

public class SettingsActivity extends PreferenceActivity

implements OnSharedPreferenceChangeListener {

private ListPreference mLanguagePreference;

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

addPreferencesFromResource(R.xml.preference);

mLanguagePreference = (ListPreference) findPreference("language");

mLanguagePreference.setOnPreferenceChangeListener(this);

}

@Override

public void onSharedPreferenceChanged(SharedPreferences sharedPreferences, String key) {

if (key.equals("language")) {

mLanguagePreference.setSummary(sharedPreferences.getString(key, ""));

}

}

// 修改ListPreference的值

private void updateLanguagePreference(String value) {

SharedPreferences.Editor editor = PreferenceManager.getDefaultSharedPreferences(this).edit();

editor.putString("language", value);

editor.commit();

}

@Override

protected void onResume() {

super.onResume();

// 注册SharedPreferences变化监听器

getPreferenceScreen().getSharedPreferences().registerOnSharedPreferenceChangeListener(this);

}

@Override

protected void onPause() {

super.onPause();

// 注销SharedPreferences变化监听器

getPreferenceScreen().getSharedPreferences().unregisterOnSharedPreferenceChangeListener(this);

}

}

在上述代码中，我们在Activity的onResume和onPause方法中分别注册和注销SharedPreferences变化监听器，以保证每次修改ListPreference的值都可以被准确地保存到SharedPreferences中。

三、读取和使用ListPreference的值

在Activity中，可以通过SharedPreferences读取ListPreference的值，并且使用它来改变应用程序的状态。以下是一个将用户选择的语言设置为应用程序语言的实例。

public class MyActivity extends Activity {

private Locale mCurrentLocale;

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

SharedPreferences sharedPreferences = PreferenceManager.getDefaultSharedPreferences(this);

String lang = sharedPreferences.getString("language", "");

mCurrentLocale = new Locale(lang);

Configuration config = new Configuration();

config.locale = mCurrentLocale;

getResources().updateConfiguration(config, getResources().getDisplayMetrics());

}

}

在上述代码中，我们获取用户选择的语言，创建一个新的Locale并将它保存在SharedPreferences中，然后创建一个新的Configuration实例，并将Locale设置为当前的语言。

最后一步是使用updateConfiguration方法来应用新的Configuration，这个方法会立即更新应用程序的所有字符串资源，使得应用程序的语言立即生效。

总结

ListPreference是一种特殊的Preference实例，它允许用户从多个选项中选择一个。在开发Android应用程序时，常常需要使用ListPreference来让用户设置某些选项，比如语言、主题、颜色等。

本文详细介绍了ListPreference的使用方法，包括创建和初始化、修改和保存、读取和使用等。希望读者在掌握了本文的内容之后，能够轻松地使用ListPreference创建高质量的Android应用程序。