summaryrefslogtreecommitdiffstats
path: root/src/android/app/src/main/java/org/citra/citra_emu/features/settings/model/view/SettingsItem.java
blob: 305352022345873a7d28d7749161b58b8ac87346 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
package org.citra.citra_emu.features.settings.model.view;

import org.citra.citra_emu.features.settings.model.Setting;
import org.citra.citra_emu.features.settings.model.Settings;
import org.citra.citra_emu.features.settings.ui.SettingsAdapter;

/**
 * ViewModel abstraction for an Item in the RecyclerView powering SettingsFragments.
 * Each one corresponds to a {@link Setting} object, so this class's subclasses
 * should vaguely correspond to those subclasses. There are a few with multiple analogues
 * and a few with none (Headers, for example, do not correspond to anything in the ini
 * file.)
 */
public abstract class SettingsItem {
    public static final int TYPE_HEADER = 0;
    public static final int TYPE_CHECKBOX = 1;
    public static final int TYPE_SINGLE_CHOICE = 2;
    public static final int TYPE_SLIDER = 3;
    public static final int TYPE_SUBMENU = 4;
    public static final int TYPE_INPUT_BINDING = 5;
    public static final int TYPE_STRING_SINGLE_CHOICE = 6;
    public static final int TYPE_DATETIME_SETTING = 7;
    public static final int TYPE_PREMIUM = 8;

    private String mKey;
    private String mSection;

    private Setting mSetting;

    private int mNameId;
    private int mDescriptionId;
    private boolean mIsPremium;

    /**
     * Base constructor. Takes a key / section name in case the third parameter, the Setting,
     * is null; in which case, one can be constructed and saved using the key / section.
     *
     * @param key           Identifier for the Setting represented by this Item.
     * @param section       Section to which the Setting belongs.
     * @param setting       A possibly-null backing Setting, to be modified on UI events.
     * @param nameId        Resource ID for a text string to be displayed as this setting's name.
     * @param descriptionId Resource ID for a text string to be displayed as this setting's description.
     */
    public SettingsItem(String key, String section, Setting setting, int nameId,
                        int descriptionId) {
        mKey = key;
        mSection = section;
        mSetting = setting;
        mNameId = nameId;
        mDescriptionId = descriptionId;
        mIsPremium = (section == Settings.SECTION_PREMIUM);
    }

    /**
     * @return The identifier for the backing Setting.
     */
    public String getKey() {
        return mKey;
    }

    /**
     * @return The header under which the backing Setting belongs.
     */
    public String getSection() {
        return mSection;
    }

    /**
     * @return The backing Setting, possibly null.
     */
    public Setting getSetting() {
        return mSetting;
    }

    /**
     * Replace the backing setting with a new one. Generally used in cases where
     * the backing setting is null.
     *
     * @param setting A non-null Setting.
     */
    public void setSetting(Setting setting) {
        mSetting = setting;
    }

    /**
     * @return A resource ID for a text string representing this Setting's name.
     */
    public int getNameId() {
        return mNameId;
    }

    public int getDescriptionId() {
        return mDescriptionId;
    }

    public boolean isPremium() {
        return mIsPremium;
    }

    /**
     * Used by {@link SettingsAdapter}'s onCreateViewHolder()
     * method to determine which type of ViewHolder should be created.
     *
     * @return An integer (ideally, one of the constants defined in this file)
     */
    public abstract int getType();
}