java类android.preference.PreferenceCategory的实例源码

private void initIncreasingRing(PreferenceCategory root) {
    mIncreasingRing = (TwoStatePreference)
            root.findPreference(CMSettings.System.INCREASING_RING);
    mIncreasingRingVolume = (IncreasingRingVolumePreference)
            root.findPreference(KEY_INCREASING_RING_VOLUME);

    if (!mVoiceCapable) {
        if (mIncreasingRing != null) {
            root.removePreference(mIncreasingRing);
            mIncreasingRing = null;
        }
        if (mIncreasingRingVolume != null) {
            root.removePreference(mIncreasingRingVolume);
            mIncreasingRingVolume = null;
        }
    } else {
        if (mIncreasingRingVolume != null) {
            mIncreasingRingVolume.setCallback(mIncreasingRingVolumeCallback);
        }
    }
}

private void initVibrateWhenRinging(PreferenceCategory root) {
    mVibrateWhenRinging = (TwoStatePreference) root.findPreference(KEY_VIBRATE_WHEN_RINGING);
    if (mVibrateWhenRinging == null) {
        Log.i(TAG, "Preference not found: " + KEY_VIBRATE_WHEN_RINGING);
        return;
    }
    if (!mVoiceCapable || !Utils.isUserOwner()) {
        root.removePreference(mVibrateWhenRinging);
        mVibrateWhenRinging = null;
        return;
    }
    mVibrateWhenRinging.setPersistent(false);
    updateVibrateWhenRinging();
    mVibrateWhenRinging.setOnPreferenceChangeListener(new OnPreferenceChangeListener() {
        @Override
        public boolean onPreferenceChange(Preference preference, Object newValue) {
            final boolean val = (Boolean) newValue;
            return Settings.System.putInt(getContentResolver(),
                    Settings.System.VIBRATE_WHEN_RINGING,
                    val ? 1 : 0);
        }
    });
}

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    addPreferencesFromResource(R.xml.pref_identities);
    setHasOptionsMenu(true);

    findPreference("add_identity").setOnPreferenceClickListener(new Preference.OnPreferenceClickListener() {
        @Override
        public boolean onPreferenceClick(Preference preference) {
            Intent i = new Intent(getActivity(), AddSSHIdentityActivity.class);
            startActivity(i);
            return true;
        }
    });

    listCategory = (PreferenceCategory) findPreference("list_identities");
}

private void setupGaplessControlSettingsV14() {
    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.JELLY_BEAN) {
        PreferenceCategory playbackControlSettings =
                (PreferenceCategory) findPreference(Constants.PREFERENCES_KEY_PLAYBACK_CONTROL_SETTINGS);
        CheckBoxPreference gaplessPlaybackEnabled =
                (CheckBoxPreference) findPreference(Constants.PREFERENCES_KEY_GAPLESS_PLAYBACK);

        if (gaplessPlaybackEnabled != null) {
            gaplessPlaybackEnabled.setChecked(false);
            gaplessPlaybackEnabled.setEnabled(false);

            if (playbackControlSettings != null) {
                playbackControlSettings.removePreference(gaplessPlaybackEnabled);
            }
        }
    }
}

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    addPreferencesFromResource(R.xml.preferences);
    useTorCheckPref = (CheckBoxPreference) findPreference(Preferences.PREF_USE_TOR);
    enableProxyCheckPref = (CheckBoxPreference) findPreference(Preferences.PREF_ENABLE_PROXY);
    updateAutoDownloadPref = findPreference(Preferences.PREF_AUTO_DOWNLOAD_INSTALL_UPDATES);
    updatePrivilegedExtensionPref = findPreference(Preferences.PREF_UNINSTALL_PRIVILEGED_APP);

    AppCompatListPreference languagePref = (AppCompatListPreference) findPreference(Preferences.PREF_LANGUAGE);
    if (Build.VERSION.SDK_INT >= 24) {
        PreferenceCategory category = (PreferenceCategory) findPreference("pref_category_display");
        category.removePreference(languagePref);
    } else {
        Languages languages = Languages.get(getActivity());
        languagePref.setDefaultValue(Languages.USE_SYSTEM_DEFAULT);
        languagePref.setEntries(languages.getAllNames());
        languagePref.setEntryValues(languages.getSupportedLocales());
    }
}

private void initUpdatePrivilegedExtensionPreference() {
    if (Build.VERSION.SDK_INT > 19) {
        // this will never work on newer Android versions, so hide it
        PreferenceCategory other = (PreferenceCategory) findPreference("pref_category_other");
        other.removePreference(updatePrivilegedExtensionPref);
        return;
    }
    updatePrivilegedExtensionPref.setPersistent(false);
    updatePrivilegedExtensionPref.setOnPreferenceClickListener(new Preference.OnPreferenceClickListener() {

        @Override
        public boolean onPreferenceClick(Preference preference) {
            // Open details of F-Droid Privileged
            Intent intent = new Intent(getActivity(), AppDetails2.class);
            intent.putExtra(AppDetails2.EXTRA_APPID,
                    PrivilegedInstaller.PRIVILEGED_EXTENSION_PACKAGE_NAME);
            startActivity(intent);

            return true;
        }
    });
}

/**
 * Gets the list of preferences in a PreferenceScreen
 *
 * @param p    preference to add to the list
 * @param list of preferences in the PreferenceScreen
 * @return a list of all the preferences
 */
private ArrayList<Preference> getPreferenceList(Preference p, ArrayList<Preference> list) {
    if (p instanceof PreferenceCategory || p instanceof PreferenceScreen) {
        PreferenceGroup prefGroup = (PreferenceGroup) p;

        final int prefCount = prefGroup.getPreferenceCount();

        for (int i = 0; i < prefCount; i++) {
            getPreferenceList(prefGroup.getPreference(i), list);
        }
    }

    if (!(p instanceof PreferenceCategory)) {
        list.add(p);
    }

    return list;
}

private CheckBoxPreference addCheckBox(String title, PreferenceCategory category, String key, Drawable icon, String onText, String offText, boolean defaultValue, Context context) {
    CheckBoxPreference c = new CheckBoxPreference(context);
    c.setTitle(title);
    c.setKey(key);
    if (null != icon) c.setIcon(icon);
    if (offText.equals(null) || onText.equals(null)) {
        if (offText.equals(null)) {
            c.setSummary(onText);
        } else if (onText.equals(null)) {
            c.setSummary(offText);
        }
    } else {
        c.setSummaryOn(onText);
        c.setSummaryOff(offText);
    }
    c.setDefaultValue(defaultValue);
    c.setChecked(KRFAM.sharedPreferences.getBoolean(key, defaultValue));
    category.addPreference(c);
    return c;
}

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    addPreferencesFromResource(R.xml.pref_wireless_socket);
    setHasOptionsMenu(true);

    PreferenceScreen preferenceScreen = this.getPreferenceScreen();

    PreferenceCategory preferenceCategory = new PreferenceCategory(preferenceScreen.getContext());
    preferenceCategory.setTitle("Wireless sockets");
    preferenceScreen.addPreference(preferenceCategory);

    for (int index = 0; index < WirelessSocketService.getInstance().GetDataList().getSize(); index++) {
        WirelessSocket wirelessSocket = WirelessSocketService.getInstance().GetDataList().getValue(index);

        SwitchPreference preference = new SwitchPreference(preferenceScreen.getContext());

        preference.setTitle(wirelessSocket.GetName());
        preference.setKey(wirelessSocket.GetSettingsKey());
        preference.setDefaultValue(false);

        preferenceCategory.addPreference(preference);

        bindPreferenceSummaryToValue(preference);
    }
}

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    addPreferencesFromResource(R.xml.pref_wireless_switch);
    setHasOptionsMenu(true);

    PreferenceScreen preferenceScreen = this.getPreferenceScreen();

    PreferenceCategory preferenceCategory = new PreferenceCategory(preferenceScreen.getContext());
    preferenceCategory.setTitle("Wireless switches");
    preferenceScreen.addPreference(preferenceCategory);

    for (int index = 0; index < WirelessSwitchService.getInstance().GetDataList().getSize(); index++) {
        WirelessSwitch wirelessSwitch = WirelessSwitchService.getInstance().GetDataList().getValue(index);

        SwitchPreference preference = new SwitchPreference(preferenceScreen.getContext());

        preference.setTitle(wirelessSwitch.GetName());
        preference.setKey(wirelessSwitch.GetSettingsKey());
        preference.setDefaultValue(false);

        preferenceCategory.addPreference(preference);

        bindPreferenceSummaryToValue(preference);
    }
}

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    handler = new Handler();

    getPreferenceManager().setSharedPreferencesName(com.monpub.sming.etc.Preference.NAME);
    getPreferenceManager().setSharedPreferencesMode(Context.MODE_PRIVATE);

    addPreferencesFromResource(R.xml.pref_sming);

    preferenceCategory = (PreferenceCategory) findPreference("prefCategorySave");
    preferenceStaticDisabled = findPreference("prefStaticDisabled");

    if (Build.VERSION.SDK_INT < 21) {
        preferenceCategory.removePreference(findPreference(SmingManager.PREF_KEY_SAVE_SCREENSHOT));
    }
}

/**
 * Shows the simplified settings UI if the device configuration if the
 * device configuration dictates that a simplified, single-pane UI should be
 * shown.
 */
private void setupSimplePreferencesScreen() {
    if (!isSimplePreferences(this)) {
        return;
    }

    // In the simplified UI, fragments are not used at all and we instead
    // use the older PreferenceActivity APIs.

    // Add 'general' preferences.
    addPreferencesFromResource(R.xml.pref_general);

    // Add 'notifications' preferences, and a corresponding header.
    PreferenceCategory fakeHeader = new PreferenceCategory(this);
    fakeHeader.setTitle(R.string.pref_header_notifications);
    getPreferenceScreen().addPreference(fakeHeader);
    addPreferencesFromResource(R.xml.pref_notification);

    // Bind the summaries of EditText/List/Dialog/Ringtone preferences to
    // their values. When their values change, their summaries are updated
    // to reflect the new value, per the Android Design guidelines.
    bindPreferenceSummaryToValue(findPreference("display_name"));
    bindPreferenceSummaryToValue(findPreference("display_image"));
    bindPreferenceSummaryToValue(findPreference("notifications_new_message_ringtone"));
}

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setRetainInstance(true);

    addPreferencesFromResource(R.xml.ota);

    mRomInfo = (PreferenceScreen) getPreferenceScreen().findPreference(KEY_ROM_INFO);
    mCheckUpdate = (PreferenceScreen) getPreferenceScreen().findPreference(KEY_CHECK_UPDATE);

    mUpdateInterval = (ListPreference) getPreferenceScreen().findPreference(KEY_UPDATE_INTERVAL);
    if (mUpdateInterval != null) {
        mUpdateInterval.setOnPreferenceChangeListener(this);
    }

    mLinksCategory = (PreferenceCategory) getPreferenceScreen().findPreference(CATEGORY_LINKS);
}

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Load the preferences from an XML resource
    addPreferencesFromResource(R.xml.preferences);

    // Remove from standard preferences if the flag ONLY_INTERNAL_STORAGE is not true
    if (!Config.ONLY_INTERNAL_STORAGE) {
        PreferenceCategory mCategory = (PreferenceCategory) findPreference("security_options");
        Preference mPref1 = findPreference("clean_cache");
        Preference mPref2 = findPreference("clean_private_storage");
        mCategory.removePreference(mPref1);
        mCategory.removePreference(mPref2);
    }

}

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    PreferenceScreen screen = getPreferenceManager().createPreferenceScreen(getActivity());

    PreferenceCategory category = new PreferenceCategory(getActivity());
    category.setTitle("Libraries");

    screen.addPreference(category);

    CheckBoxPreference checkBoxPref = new CheckBoxPreference(getActivity());
    checkBoxPref.setTitle("title");
    checkBoxPref.setSummary("summary");
    checkBoxPref.setChecked(true);

    category.addPreference(checkBoxPref);
    setPreferenceScreen(screen);
}

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    addPreferencesFromResource(R.xml.pref_wireless_socket);
    setHasOptionsMenu(true);

    PreferenceScreen preferenceScreen = this.getPreferenceScreen();

    PreferenceCategory preferenceCategory = new PreferenceCategory(preferenceScreen.getContext());
    preferenceCategory.setTitle("Wireless sockets");
    preferenceScreen.addPreference(preferenceCategory);

    for (int index = 0; index < WirelessSocketService.getInstance().GetDataList().getSize(); index++) {
        WirelessSocket wirelessSocket = WirelessSocketService.getInstance().GetDataList().getValue(index);

        SwitchPreference preference = new SwitchPreference(preferenceScreen.getContext());

        preference.setTitle(wirelessSocket.GetName());
        preference.setKey(wirelessSocket.GetSettingsKey());
        preference.setDefaultValue(false);

        preferenceCategory.addPreference(preference);

        bindPreferenceSummaryToValue(preference);
    }
}

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    addPreferencesFromResource(R.xml.pref_wireless_switch);
    setHasOptionsMenu(true);

    PreferenceScreen preferenceScreen = this.getPreferenceScreen();

    PreferenceCategory preferenceCategory = new PreferenceCategory(preferenceScreen.getContext());
    preferenceCategory.setTitle("Wireless switches");
    preferenceScreen.addPreference(preferenceCategory);

    for (int index = 0; index < WirelessSwitchService.getInstance().GetDataList().getSize(); index++) {
        WirelessSwitch wirelessSwitch = WirelessSwitchService.getInstance().GetDataList().getValue(index);

        SwitchPreference preference = new SwitchPreference(preferenceScreen.getContext());

        preference.setTitle(wirelessSwitch.GetName());
        preference.setKey(wirelessSwitch.GetSettingsKey());
        preference.setDefaultValue(false);

        preferenceCategory.addPreference(preference);

        bindPreferenceSummaryToValue(preference);
    }
}

@Override
protected void onCreate(Bundle savedInstanceState) {
    // TODO Auto-generated method stub
    super.onCreate(savedInstanceState);
    addPreferencesFromResource(R.xml.preferences);

    mPrefs = PreferenceManager.getDefaultSharedPreferences(getApplicationContext());
    screen = (PreferenceScreen) findPreference("preferenceScreen");
    category = (PreferenceCategory) findPreference("collection_category");
    collectionMethod = findPreference("dex_collection_method");
    showBridgeBattery = findPreference("showBridgeBattery");
    watchcategory = (PreferenceCategory) findPreference("category");
    bindPreferenceSummaryToValue(collectionMethod);
    listenForChangeInSettings();
    setCollectionPrefs();
}

@Override
protected void onCreate(Bundle savedInstanceState) {
    // TODO Auto-generated method stub
    super.onCreate(savedInstanceState);
    addPreferencesFromResource(R.xml.preferences);

    mPrefs = PreferenceManager.getDefaultSharedPreferences(getApplicationContext());
    screen = (PreferenceScreen) findPreference("preferenceScreen");
    category = (PreferenceCategory) findPreference("collection_category");
    collectionMethod = findPreference("dex_collection_method");
    showBridgeBattery = findPreference("showBridgeBattery");
    watchcategory = (PreferenceCategory) findPreference("category");
    bindPreferenceSummaryToValue(collectionMethod);
    listenForChangeInSettings();
    setCollectionPrefs();
}

public void onEvent(final PluginFoundMessage _msg) {
    if (mInflater == null || mViewContainer == null) {
        Log.e(LOG_TAG, "onEvent: Faster than light, onCreateView was not called yet.");
        return;
    }

    PreferenceGroup preferenceGroup = new PreferenceCategory(mViewContainer.getContext());
    preferenceGroup.setTitle(_msg.mName);


    View prefView = preferenceGroup.getView(null, mViewContainer);
    /*prefView.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            Intent intent = new Intent(getActivity(), _msg.mSettingsActivity);
            startActivity(intent);
        }
    });*/
    ViewGroup viewGroup = (ViewGroup) mViewContainer.getChildAt(0);
    viewGroup.addView(prefView, viewGroup.getChildCount());

}

private void initBasicPart(SharedPreferences sharedPreferences) {
    // back to top.
    MysplashListPreference backToTop = (MysplashListPreference) findPreference(getString(R.string.key_back_to_top));
    String backToTopValue = sharedPreferences.getString(getString(R.string.key_back_to_top), "all");
    String backToTopName = ValueUtils.getBackToTopName(getActivity(), backToTopValue);
    backToTop.setSummary(getString(R.string.now) + " : " + backToTopName);
    backToTop.setOnPreferenceChangeListener(this);

    // language.
    MysplashListPreference language = (MysplashListPreference) findPreference(getString(R.string.key_language));
    String languageValue = sharedPreferences.getString(getString(R.string.key_language), "follow_system");
    String languageName = ValueUtils.getLanguageName(getActivity(), languageValue);
    language.setSummary(getString(R.string.now) + " : " + languageName);
    language.setOnPreferenceChangeListener(this);

    // Muzei.
    MysplashPreference muzei = (MysplashPreference) findPreference("muzei_settings");
    if (!MuzeiOptionManager.isInstalledMuzei(getActivity())) {
        PreferenceCategory display = (PreferenceCategory) findPreference("basic");
        display.removePreference(muzei);
    }
}

private void initDisplayPart(SharedPreferences sharedPreferences) {
    // saturation animation duration.
    MysplashListPreference duration = (MysplashListPreference) findPreference(getString(R.string.key_saturation_animation_duration));
    String durationValue = sharedPreferences.getString(getString(R.string.key_saturation_animation_duration), "2000");
    String durationName = ValueUtils.getSaturationAnimationDurationName(getActivity(), durationValue);
    duration.setSummary(getString(R.string.now) + " : " + durationName);
    duration.setOnPreferenceChangeListener(this);

    // grid list in port.
    MysplashSwitchPreference gridPort = (MysplashSwitchPreference) findPreference(getString(R.string.key_grid_list_in_port));
    gridPort.setOnPreferenceChangeListener(this);
    if (!DisplayUtils.isTabletDevice(getActivity())) {
        PreferenceCategory display = (PreferenceCategory) findPreference("display");
        display.removePreference(gridPort);
    }

    // grid list in land.
    MysplashSwitchPreference gridLand = (MysplashSwitchPreference) findPreference(getString(R.string.key_grid_list_in_land));
    gridLand.setOnPreferenceChangeListener(this);
}

private List<Preference> getPreferenceList(Preference p, List<Preference> list)
{
    if (p instanceof PreferenceCategory || p instanceof PreferenceScreen)
    {
        PreferenceGroup g = (PreferenceGroup) p;
        int pCount = g.getPreferenceCount();
        for (int i = 0; i < pCount; i++)
        {
            getPreferenceList(g.getPreference(i), list);
        }
    }
    else
    {
        list.add(p);
    }
    return list;
}

private void initPrefSummary() {
    sharedPreferences = PreferenceManager.getDefaultSharedPreferences(this.getActivity());

    for (int i = 0; i < getPreferenceScreen().getPreferenceCount(); ++i) {
        Preference preference = getPreferenceScreen().getPreference(i);

        if (preference instanceof PreferenceCategory) {
            PreferenceCategory pGrp = (PreferenceCategory) preference;
            for (int j = 0; j < pGrp.getPreferenceCount(); j++) {
                updatePrefSummary(pGrp.getPreference(j));
            }
        } else {
            updatePrefSummary(preference);
        }
    }
}

@Override
public void onSharedPreferenceChanged(SharedPreferences sharedPreferences, String key) {
    Log.d("DEBUG", "key: " + key);
    if ("show_advanced_setting".equals(key)) {
        boolean enabled = sharedPreferences.getBoolean(key, false);

        if (enabled) {
            // show advanced setting here.
            addPreferencesFromResource(R.xml.preference_advanced_setting);
        } else {
            // remove advanced setting here.
            PreferenceCategory preferenceCategory = (PreferenceCategory) findPreference("advanced_settings");
            if (preferenceCategory != null) {
                screen.removePreference(preferenceCategory);
            }
        }
    }
}

@Override
public void onSharedPreferenceChanged(SharedPreferences sharedPreferences, String key) {
    Log.d("DEBUG", "key: " + key);
    if ("show_advanced_setting".equals(key)) {
        boolean enabled = sharedPreferences.getBoolean(key, false);

        if (enabled) {
            // show advanced setting here.
            addPreferencesFromResource(R.xml.preference_advanced_setting);
        } else {
            // remove advanced setting here.
            PreferenceCategory preferenceCategory = (PreferenceCategory) findPreference("advanced_settings");
            if (preferenceCategory != null) {
                screen.removePreference(preferenceCategory);
            }
        }
    }
}

/**
 * Create the "Select Instruments For Each Track " lists.
 * The list of possible instruments is in MidiFile.java.
 */
private void createInstrumentPrefs(PreferenceScreen root) {
    PreferenceCategory selectInstrTitle = new PreferenceCategory(this);
    selectInstrTitle.setTitle(R.string.select_instruments_per_track);
    root.addPreference(selectInstrTitle);
    selectInstruments = new ListPreference[options.tracks.length];
    for (int i = 0; i < options.instruments.length; i++) {
        selectInstruments[i] = new ListPreference(this);
        selectInstruments[i].setOnPreferenceChangeListener(this);
        selectInstruments[i].setEntries(MidiFile.Instruments);
        selectInstruments[i].setEntryValues(MidiFile.Instruments);
        selectInstruments[i].setTitle("Track " + i);
        selectInstruments[i].setValueIndex(options.instruments[i]);
        selectInstruments[i].setSummary(selectInstruments[i].getEntry());
        root.addPreference(selectInstruments[i]);
    }
    setAllToPiano = new Preference(this);
    setAllToPiano.setTitle(R.string.set_all_to_piano);
    setAllToPiano.setOnPreferenceClickListener(this);
    root.addPreference(setAllToPiano);
}

/**
 * Shows the simplified settings UI if the device configuration if the
 * device configuration dictates that a simplified, single-pane UI should be
 * shown.
 */
private void setupSimplePreferencesScreen() {
    if (!isSimplePreferences(this)) {
        return;
    }

    // In the simplified UI, fragments are not used at all and we instead
    // use the older PreferenceActivity APIs.

    // Add 'general' preferences.
    addPreferencesFromResource(R.xml.pref_general);

    // Add 'advanced' preferences, and a corresponding header.
    PreferenceCategory fakeHeader = new PreferenceCategory(this);
    fakeHeader.setTitle(R.string.pref_header_advanced);
    getPreferenceScreen().addPreference(fakeHeader);
    addPreferencesFromResource(R.xml.pref_advanced);

    // Bind the summaries of EditText/List/Dialog/Ringtone preferences to
    // their values. When their values change, their summaries are updated
    // to reflect the new value, per the Android Design guidelines.
    bindPreferenceSummaryToValue(findPreference("pref_defaultopts"));
    // Advanced
    bindPreferenceSummaryToValue(findPreference("pref_updateurl"));
    bindPreferenceSummaryToValue(findPreference("pref_binaryloc"));
}

private CheckBoxPreference addCheckBox(String title, PreferenceCategory category, String key, Drawable icon, String onText, String offText, boolean defaultValue, Context context) {
    CheckBoxPreference c = new CheckBoxPreference(context);
    c.setTitle(title);
    c.setKey(key);
    if (null != icon) c.setIcon(icon);
    if (offText.equals(null) || onText.equals(null)) {
        if (offText.equals(null)) {
            c.setSummary(onText);
        } else if (onText.equals(null)) {
            c.setSummary(offText);
        }
    } else {
        c.setSummaryOn(onText);
        c.setSummaryOff(offText);
    }
    c.setDefaultValue(defaultValue);
    c.setChecked(SIFAM.sharedPreferences.getBoolean(key, defaultValue));
    category.addPreference(c);
    return c;
}

/**
 * Returns a pair, which contains the item, which corresponds to the given position, as well
 * as the item's position in the encapsulated adapter, if the item is not a divider.
 *
 * @param position
 *         The position of the item, which should be returned, as an {@link Integer} value
 * @return A pair, which contains the item, which corresponds to the given position, as well as
 * the item's position in the encapsulated adapter, if the item is not a divider, as an instance
 * of the class Pair. The pair may not be null
 */
@NonNull
public final Pair<Object, Integer> getItemInternal(final int position) {
    ensureAtLeast(position, 0, null, IndexOutOfBoundsException.class);
    Object item = null;
    int offset = 0;
    int i = 0;

    while (i <= position) {
        item = encapsulatedAdapter.getItem(i - offset);

        if (i > 0 && item instanceof PreferenceCategory) {
            if (i == position) {
                return Pair.create(DIVIDER, -1);
            } else {
                offset++;
                i++;
            }
        }

        i++;
    }

    ensureNotNull(item, null, IndexOutOfBoundsException.class);
    return Pair.create(item, i - 1 - offset);
}