举例说明android中ListPreference的使用方法

本文详细介绍了如何在Android中使用ListPreference,包括创建、设置默认值、监听变化及显示摘要。通过示例代码展示了如何从XML资源加载、初始化ListPreference,并在选择项变化时更新摘要内容。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

先展示一下效果图,如下所示:

 

项目代码如下:

 

package com.my.listpreference;

import android.os.Bundle;
import android.preference.ListPreference;
import android.preference.Preference;
import android.preference.Preference.OnPreferenceChangeListener;
import android.preference.PreferenceActivity;

public class ListPreferenceTest extends PreferenceActivity implements OnPreferenceChangeListener{
    /** Called when the activity is first created. */
 
 ListPreference lp;//创建一个ListPreference对象
 
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        //过滤已经的XML文件资源,并将当前的preference层添加到这个preference层当中
        addPreferencesFromResource(R.xml.preference);
        //初始化这个ListPreference对象
        lp=(ListPreference)findPreference(getString(R.string.key_str));
        //设置获取ListPreference中发生的变化
        lp.setOnPreferenceChangeListener(this);
        /**让ListPreference中的摘要内容(即summary)显示为当前ListPreference中的实体对应的值
         * 这个方法的作用是为了当下一次打开这个程序时会显示上一次的设置的summary(摘要)
         * 如果没有添加这个方法,当再次打开这个程序时,它将不会显示上一次程序设置的值,而
         * 是显示默认值*/
        lp.setSummary(lp.getEntry());
    }
   
    //让所选择的项显示出来,获取变化并显示出来
 @Override
 public boolean onPreferenceChange(Preference preference, Object newValue) {
  // TODO Auto-generated method stub
  if(preference instanceof ListPreference){
   //把preference这个Preference强制转化为ListPreference类型
   ListPreference listPreference=(ListPreference)preference;
   //获取ListPreference中的实体内容
   CharSequence[] entries=listPreference.getEntries();
   //获取ListPreference中的实体内容的下标值
   int index=listPreference.findIndexOfValue((String)newValue);
   //把listPreference中的摘要显示为当前ListPreference的实体内容中选择的那个项目
   listPreference.setSummary(entries[index]);
  }
  return true;
 }
}

 

res.values.strings.xml中的内容如下:

 

<?xml version="1.0" encoding="utf-8"?>
<resources>

    <string name="hello">Hello World, ListPreferenceTest!</string>
    <string name="app_name">ListPreferenceTest</string>
    <string name="key_str">key</string>
    <string name="title_str">你最喜欢的蔬菜</string>
    <string name="title_listpreference">选择蔬菜</string>
    <string-array name="entries_str">
        <item >白菜</item>
        <item >萝卜</item>
        <item >豆芽</item>
        <item >芹菜</item>
    </string-array>
    <string-array name="entries_values_str">
        <item >baicai</item>
        <item >luobu</item>
        <item >douya</item>
        <item >qincai</item>
    </string-array>
    <string name="default_str">baicai</string>
    <string name="dialog_title">请选择你喜欢的蔬菜</string>
    <string name="summary_str">白菜</string>

</resources>

 

res.xml.preference.xml中的内容如下:

 

<?xml version="1.0" encoding="utf-8"?>
<PreferenceScreen xmlns:android="
http://schemas.android.com/apk/res/android" >
    <PreferenceCategory android:title="@string/title_str">
        <ListPreference
            android:key="@string/key_str"
            android:title="@string/title_listpreference"
            android:entries="@array/entries_str"
            android:entryValues="@array/entries_values_str"
            android:dialogTitle="@string/dialog_title"
            android:defaultValue="@string/default_str"
            android:summary="@string/summary_str"
            />
    </PreferenceCategory>
</PreferenceScreen>

 

上述程序中需要注意的事项:

 

1.必须要有android:entryValues="@array/entries_values_str"与android:entries="@array/entries_str"相对应
2.android:defaultValue="@string/default_str"中的default_str必须为entries_str中的一个选项
3.lp=(ListPreference)findPreference(getString(R.string.key_str));这里的获取的字符串的内容必须为key_str,否则会出来NullPointException的错误(即初始化不成功的错误)。因为android:key="@string/key_str"相当于android:id=""

 

 

 

### 如何在 Android使用 ListPreference #### XML 布局文件配置 为了使 `ListPreference` 正常工作,在 XML 文件中声明此组件时需指定几个重要属性。这些属性帮助定义选项列表以及默认行为。 ```xml <ListPreference android:key="list_preference_key" android:title="@string/list_preference_title" android:summary="%s selected" android:entries="@array/preference_entries" android:entryValues="@array/preference_values" android:defaultValue="default_value"/> ``` 上述代码片段展示了如何在 XML 资源文件中定义一个 `ListPreference` 组件[^1]。 #### Java 代码实现交互逻辑 除了在 XML 文件中定义外观外,还需要编写相应的 Java 或 Kotlin 代码来处理用户的输入并响应变化事件。下面是一个简单的例子: ```java // 获取对特定偏好设置项的引用 ListPreference listPref = findViewById(R.id.list_preference_id); // 设置监听器以捕获值的变化 listPref.setOnPreferenceChangeListener((preference, newValue) -> { String value = (String)newValue; // 更新摘要显示当前选中的条目名称 if(preference instanceof ListPreference){ ListPreference pref = (ListPreference) preference; int index = pref.findIndexOfValue(value); CharSequence[] entries = pref.getEntries(); if(index >=0 && index < entries.length){ pref.setSummary(entries[index]); } } return true; // 返回true表示接受更改 }); ``` 这段代码实现了当用户选择了不同的项目后更新界面摘要的功能[^3]。 对于现代应用开发环境下的兼容性考虑,如果正在使用支持库,则应继承自 `androidx.preference.ListPreference` 类而非旧版 API 提供的那个版本。这可以确保更好的向后兼容性和更广泛的设备覆盖范围[^2]。 #### 创建带有自定义样式的 ListPreference 有时可能希望进一步定制对话框样式或其他视觉效果。虽然官方文档并没有直接提供修改内置构建器的方法,但是可以通过重写某些方法来自定义展示形式。例如,通过覆写 `onBindDialogView()` 方法可以在弹出的选择窗口内加入额外视图或调整现有控件的位置和大小。 ```java public class CustomListPreference extends androidx.preference.ListPreference { @Override protected void onBindDialogView(@NonNull View view) { super.onBindDialogView(view); // 对话框内部进行个性化设计... } } ``` 以上就是关于如何在 Android 应用程序中有效利用 `ListPreference` 的基本指南。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值