Пишем свой Android Preference

Доброго времени суток. Если вы пишете приложения под Android, то наверняка сталкивались с настройками приложения (Preferences). На первый взгляд всё делается просто (см. сюда), но после беглого знакомства понимаешь что стандартных настроек очень мало. Их всего пять штук:

• Preference
• CheckBoxPreference
• EditTextPreference
• ListPreference
• RingtonePreference

Очевидно что всех нужд эти настройки покрыть не могут.
Но тут самое время вспомнить что как то же можно настроить громкость звука или яркость экрана на телефоне — их нельзя настроить с помощью приведённого выше списка настроек! Идем в системные настройки и смотрим как это реализованно: Там есть обычная Preference, по клику на которую вылазит окошко с элементом управления «бегунок»(SeekBar). Впринципе приемлимое решение, но хочется избавится от лишнего окна и перенести бегунок прямо на экран настроек. Беглый поиск не нашёл приемлимых решений, и мы решили написать свой SeekBarPreference.


Наш SeekBarPreference должен обладать следущими качествами: он должен показовать текущее значение бегунка «на ходу», и мы хотим использовать его с разными параметрами длинны шага и количества шагов.

Собственно нам понадобится класс, которые отвечает за создание отображения настройки и поведение при перемещении ползунка.

public class SeekBarPreference extends Preference implements
 OnSeekBarChangeListener {

private TextView valueTextView;
 private int currentValue;
 private int max;

//конструктор, вытаскивает спецальные атрибуты настройки
 public SeekBarPreference(Context context, AttributeSet attrs) {
 super(context, attrs);
 max = attrs.getAttributeIntValue(
 "http://schemas.android.com/apk/res/com.sample", "max", 99);
 currentValue = attrs.getAttributeIntValue(
 "http://schemas.android.com/apk/res/com.sample",
 "currentValue", 0);
 }

//Переопределяем процедуру создания View для этой настройки
 @Override
 protected View onCreateView(ViewGroup parent) {

RelativeLayout layout = (RelativeLayout) LayoutInflater.from(
 getContext())
 .inflate(R.layout.seek_bar_preference_layout, null);

((TextView) layout.findViewById(R.id.title)).setText(getTitle());

SeekBar bar = (SeekBar) layout.findViewById(R.id.seekBar);
 bar.setMax(max);
 bar.setProgress(currentValue);
 bar.setOnSeekBarChangeListener(this);

valueTextView = (TextView) layout.findViewById(R.id.value);
 valueTextView.setText(currentValue+"");

return layout;
 }

//Функция, вызываемая каждый раз при перемещении ползунка
 public void onProgressChanged(SeekBar seekBar, int progress,
 boolean fromUser) {
 valueTextView.setText(progress+"");
 valueTextView.invalidate();
 }

public void onStartTrackingTouch(SeekBar seekBar) {
 }

//Функция, вызываемая после окончания движения пользователем
 public void onStopTrackingTouch(SeekBar seekBar) {
 currentValue = seekBar.getProgress();
 updatePreference(currentValue);
 notifyChanged();
 }

//Сохранение значения настройки
 private void updatePreference(int newValue) {
 SharedPreferences.Editor editor = getEditor();
 editor.putInt(getKey(), newValue);
 editor.commit();
 }
}

Для упрощния кода описание отображения было вынесено в отдельный layout:

<RelativeLayout
 xmlns:android="http://schemas.android.com/apk/res/android"
 android:layout_width="fill_parent"
 android:layout_height="wrap_content">
 <TextView
 android:id="@+id/title"
 android:layout_width="wrap_content"
 android:layout_height="wrap_content"
 android:textSize="20dp" />
 <TextView
 android:id="@+id/value"
 android:layout_width="wrap_content"
 android:layout_height="wrap_content"
 android:layout_toRightOf="@+id/title"
 android:layout_alignBaseline="@+id/title"
 android:paddingLeft="5dp"
 android:textSize="18dp" />
 <SeekBar
 android:id="@+id/seekBar"
 android:layout_width="fill_parent"
 android:layout_height="wrap_content"
 android:paddingTop="5dp"
 android:paddingLeft="10dp"
 android:paddingRight="10dp"
 android:paddingBottom="3dp"
 android:layout_below="@+id/value" />

Layout содержит два текстовых поля — название настройки и текущее значение, и SeekBar.

Для переиспользования этой настройки нам надо определить особые атрибуты — максимальное значение ползунка и начальное положение ползунка. Самый простой способ — сделать специальные атрибуты для нашей настройки. Для этого создадим файл в папке «res/values» файл «attributes.xml»:

<declare-styleable name="SeekBarPreferenceAttrs">
 />
 />
 </declare-styleable>

Теперь у нас есть числовые атрибуты которые мы можем использовать при задании настройки:

<com.example.SeekBarPreference
 android:key="pref" 
 android:title="Sample preference" 
 sample:max="99"
 sample:currentValue="30" />

Но чтобы компилятор понял эти атрибуты надо определить из какого пакета их брать. Для этого в начале файла с настройками надо добавить определение пакета:

xmlns:sample="http://schemas.android.com/apk/res/com.example"

После этого можно насладится красивой настройкой без лишних окон.