Notes-master/tool/ResourceParser.java

/*
 * 版权所有 (c) 2010-2011, MiCode 开源社区 (www.micode.net)
 *
 * 本文件根据 Apache License, Version 2.0 (以下简称“许可证”)授权使用；
 * 除非符合许可证的规定，否则您不得使用此文件。
 * 您可以在以下网址获取许可证的副本：
 *
 *        http://www.apache.org/licenses/LICENSE-2.0
 *
 * 除非适用法律要求或以书面形式同意，根据许可证分发的软件将按“现状”分发，
 * 不提供任何明示或暗示的保证或条件。
 * 请参阅许可证以了解控制权限和许可证下限制的特定语言。
 */
 
package net.micode.notes.tool;
 
import android.content.Context; // 引入Android上下文类，用于访问应用的资源和类以及调用应用级操作
import android.preference.PreferenceManager; // 引入Android偏好设置管理器类，用于访问应用的偏好设置
 
import net.micode.notes.R; // 引入应用的资源类，用于访问应用资源
import net.micode.notes.ui.NotesPreferenceActivity; // 引入应用的偏好设置活动类
 
// ResourceParser类，用于解析和管理应用的资源
public class ResourceParser {
 
    // 定义一些颜色常量
    public static final int YELLOW           = 0; // 黄色
    public static final int BLUE             = 1; // 蓝色
    public static final int WHITE            = 2; // 白色
    public static final int GREEN            = 3; // 绿色
    public static final int RED              = 4; // 红色
 
    // 定义默认背景颜色为黄色
    public static final int BG_DEFAULT_COLOR = YELLOW;
 
    // 定义一些字体大小常量
    public static final int TEXT_SMALL       = 0; // 小号字体
    public static final int TEXT_MEDIUM      = 1; // 中号字体
    public static final int TEXT_LARGE       = 2; // 大号字体
    public static final int TEXT_SUPER       = 3; // 超大号字体
 
    // 定义默认字体大小为中号
    public static final int BG_DEFAULT_FONT_SIZE = TEXT_MEDIUM;
 
    // NoteBgResources内部类，用于管理笔记背景资源
    public static class NoteBgResources {
        // 定义编辑状态下的背景资源数组
        private final static int [] BG_EDIT_RESOURCES = new int [] {
            R.drawable.edit_yellow,
            R.drawable.edit_blue,
            R.drawable.edit_white,
            R.drawable.edit_green,
            R.drawable.edit_red
        };
 
        // 定义编辑状态下标题的背景资源数组
        private final static int [] BG_EDIT_TITLE_RESOURCES = new int [] {
            R.drawable.edit_title_yellow,
            R.drawable.edit_title_blue,
            R.drawable.edit_title_white,
            R.drawable.edit_title_green,
            R.drawable.edit_title_red
        };
 
        // 获取指定ID的编辑背景资源
        public static int getNoteBgResource(int id) {
            return BG_EDIT_RESOURCES[id];
        }
 
        // 获取指定ID的编辑标题背景资源
        public static int getNoteTitleBgResource(int id) {
            return BG_EDIT_TITLE_RESOURCES[id];
        }
    }
 
    // 获取默认背景颜色ID
    public static int getDefaultBgId(Context context) {
        // 检查用户是否设置了背景颜色偏好
        if (PreferenceManager.getDefaultSharedPreferences(context).getBoolean(
                NotesPreferenceActivity.PREFERENCE_SET_BG_COLOR_KEY, false)) {
            // 如果设置了，则随机返回一个背景颜色ID
            return (int) (Math.random() * NoteBgResources.BG_EDIT_RESOURCES.length);
        } else {
            // 否则返回默认背景颜色ID
            return BG_DEFAULT_COLOR;
        }
    }
 
    // NoteItemBgResources内部类，用于管理笔记条目背景资源
    public static class NoteItemBgResources {
        // 定义列表第一项的背景资源数组
        private final static int [] BG_FIRST_RESOURCES = new int [] {
            R.drawable.list_yellow_up,
            R.drawable.list_blue_up,
            R.drawable.list_white_up,
            R.drawable.list_green_up,
            R.drawable.list_red_up
        };
 
        // 定义列表中间项的背景资源数组
        private final static int [] BG_NORMAL_RESOURCES = new int [] {
            R.drawable.list_yellow_middle,
            R.drawable.list_blue_middle,
            R.drawable.list_white_middle,
            R.drawable.list_green_middle,
            R.drawable.list_red_middle
        };
 
        // 定义列表最后一项的背景资源数组
        private final static int [] BG_LAST_RESOURCES = new int [] {
            R.drawable.list_yellow_down,
            R.drawable.list_blue_down,
            R.drawable.list_white_down,
            R.drawable.list_green_down,
            R.drawable.list_red_down,
        };
 
        // 定义单个列表项的背景资源数组
        private final static int [] BG_SINGLE_RESOURCES = new int [] {
            R.drawable.list_yellow_single,
            R.drawable.list_blue_single,
            R.drawable.list_white_single,
            R.drawable.list_green_single,
            R.drawable.list_red_single
        };
 
        // 获取指定ID的第一项背景资源
        public static int getNoteBgFirstRes(int id) {
            return BG_FIRST_RESOURCES[id];
        }
 
        // 获取指定ID的最后一项背景资源
        public static int getNoteBgLastRes(int id) {
            return BG_LAST_RESOURCES[id];
        }
 
        // 获取指定ID的单个项背景资源
        public static int getNoteBgSingleRes(int id) {
            return BG_SINGLE_RESOURCES[id];
        }
 
        // 获取指定ID的中间项背景资源
        public static int getNoteBgNormalRes(int id) {
            return BG_NORMAL_RESOURCES[id];
        }
 
        // 获取文件夹背景资源
        public static int getFolderBgRes() {
            return R.drawable.list_folder;
        }
    }
 
    // WidgetBgResources内部类，用于管理小部件背景资源
    public static class WidgetBgResources {
        // 定义2x大小的小部件背景资源数组
        private final static int [] BG_2X_RESOURCES = new int [] {
            R.drawable.widget_2x_yellow,
            R.drawable.widget_2x_blue,
            R.drawable.widget_2x_white,
            R.drawable.widget_2x_green,
            R.drawable.widget_2x_red,
        };
 
        // 获取指定ID的2x大小小部件背景资源
        public static int getWidget2xBgResource(int id) {
            return BG_2X_RESOURCES[id];
        }
 
        // 定义4x大小的小部件背景资源数组
        private final static int [] BG_4X_RESOURCES = new int [] {
            R.drawable.widget_4x_yellow,
            R.drawable.widget_4x_blue,
            R.drawable.widget_4x_white,
            R.drawable.widget_4x_green,
            R.drawable.widget_4x_red
        };
 
        // 获取指定ID的4x大小小部件背景资源
        public static int getWidget4xBgResource(int id) {
            return BG_4X_RESOURCES[id];
        }
    }
 
    // TextAppearanceResources内部类，用于管理文本外观资源
    public static class TextAppearanceResources {
        // 定义文本外观资源数组
        private final static int [] TEXTAPPEARANCE_RESOURCES = new int [] {
            R.style.TextAppearanceNormal,
            R.style.TextAppearanceMedium,
            R.style.TextAppearanceLarge,
            R.style.TextAppearanceSuper
        };
 
        // 获取指定ID的文本外观资源
        // 注意：这里有一个修正（HACKME），用于处理存储在偏好设置中的资源ID可能超出资源数组长度的情况
        public static int getTexAppearanceResource(int id) {
            if (id >= TEXTAPPEARANCE_RESOURCES.length) {
                return BG_DEFAULT_FONT_SIZE;
            }
            return TEXTAPPEARANCE_RESOURCES[id];
        }
 
        // 获取文本外观资源数组的大小
        public static int getResourcesSize() {
            return TEXTAPPEARANCE_RESOURCES.length;
        }
    }
}