/* * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ // ResourceParser.java - 资源解析工具类 // 主要功能：管理便签应用的颜色主题、背景资源、字体大小等UI相关资源的映射和获取 package net.micode.notes.tool; // ======================= 导入区域 ======================= // Android相关类 import android.content.Context; // 上下文，用于访问偏好设置 import android.preference.PreferenceManager; // 偏好设置管理器 // 应用内部资源 import net.micode.notes.R; // 资源文件R类 import net.micode.notes.ui.NotesPreferenceActivity; // 设置Activity，包含偏好设置键名 // ======================= 资源解析主类 ======================= /** * ResourceParser - 资源解析工具类 * 集中管理便签应用的UI资源映射关系 * 包括：背景颜色、字体大小、编辑界面背景、列表项背景、小部件背景等 */ 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 { // 便签编辑区域背景资源数组 // 数组索引对应颜色常量：0=黄, 1=蓝, 2=白, 3=绿, 4=红 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 * @param id 颜色索引（YELLOW/BLUE/WHITE/GREEN/RED） * @return 对应的drawable资源ID */ public static int getNoteBgResource(int id) { return BG_EDIT_RESOURCES[id]; } /** * 获取便签标题栏背景资源ID * @param id 颜色索引（YELLOW/BLUE/WHITE/GREEN/RED） * @return 对应的drawable资源ID */ public static int getNoteTitleBgResource(int id) { return BG_EDIT_TITLE_RESOURCES[id]; } } /** * 获取默认背景颜色ID * 根据用户设置决定：随机颜色或默认颜色 * @param context 上下文，用于读取偏好设置 * @return 背景颜色索引 */ public static int getDefaultBgId(Context context) { // 从偏好设置读取是否启用随机背景颜色 if (context.getSharedPreferences(NotesPreferenceActivity.PREFERENCE_NAME, Context.MODE_PRIVATE).getBoolean( NotesPreferenceActivity.PREFERENCE_SET_BG_COLOR_KEY, // 偏好设置键名 false)) { // 默认值为false（不随机） // 随机选择一种颜色 return (int) (Math.random() * NoteBgResources.BG_EDIT_RESOURCES.length); } else { // 使用默认颜色 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 * @param id 颜色索引 * @return 对应的drawable资源ID */ public static int getNoteBgFirstRes(int id) { return BG_FIRST_RESOURCES[id]; } /** * 获取列表末项背景资源ID * @param id 颜色索引 * @return 对应的drawable资源ID */ public static int getNoteBgLastRes(int id) { return BG_LAST_RESOURCES[id]; } /** * 获取列表单独项背景资源ID * @param id 颜色索引 * @return 对应的drawable资源ID */ public static int getNoteBgSingleRes(int id) { return BG_SINGLE_RESOURCES[id]; } /** * 获取列表中间项背景资源ID * @param id 颜色索引 * @return 对应的drawable资源ID */ public static int getNoteBgNormalRes(int id) { return BG_NORMAL_RESOURCES[id]; } /** * 获取文件夹项背景资源ID * 文件夹使用统一的背景，不区分颜色 * @return 文件夹专用背景资源ID */ public static int getFolderBgRes() { return R.drawable.list_folder; } } // ======================= 小部件背景资源类 ======================= /** * WidgetBgResources - 桌面小部件背景资源类 * 管理不同尺寸桌面小部件的背景图片资源 */ public static class WidgetBgResources { // 2x尺寸小部件背景资源数组 // 用于2x2尺寸的桌面小部件 private final static int [] BG_2X_RESOURCES = new int [] { R.drawable.widget_2x_yellow, // 黄色2x小部件背景 R.drawable.widget_2x_blue, // 蓝色2x小部件背景 R.drawable.widget_2x_white, // 白色2x小部件背景 R.drawable.widget_2x_green, // 绿色2x小部件背景 R.drawable.widget_2x_red, // 红色2x小部件背景 }; /** * 获取2x尺寸小部件背景资源ID * @param id 颜色索引 * @return 对应的drawable资源ID */ public static int getWidget2xBgResource(int id) { return BG_2X_RESOURCES[id]; } // 4x尺寸小部件背景资源数组 // 用于4x4尺寸的桌面小部件 private final static int [] BG_4X_RESOURCES = new int [] { R.drawable.widget_4x_yellow, // 黄色4x小部件背景 R.drawable.widget_4x_blue, // 蓝色4x小部件背景 R.drawable.widget_4x_white, // 白色4x小部件背景 R.drawable.widget_4x_green, // 绿色4x小部件背景 R.drawable.widget_4x_red // 红色4x小部件背景 }; /** * 获取4x尺寸小部件背景资源ID * @param id 颜色索引 * @return 对应的drawable资源ID */ public static int getWidget4xBgResource(int id) { return BG_4X_RESOURCES[id]; } } // ======================= 文本外观资源类 ======================= /** * TextAppearanceResources - 文本外观资源类 * 管理便签内容的字体大小样式资源 * 包含对偏好设置中存储异常的处理 */ public static class TextAppearanceResources { // 文本外观样式资源数组 // 索引对应字体大小常量：0=小, 1=中, 2=大, 3=超大 private final static int [] TEXTAPPEARANCE_RESOURCES = new int [] { R.style.TextAppearanceNormal, // 小号字体样式 R.style.TextAppearanceMedium, // 中号字体样式 R.style.TextAppearanceLarge, // 大号字体样式 R.style.TextAppearanceSuper // 超大号字体样式 }; /** * 获取文本外观样式资源ID * 包含对偏好设置中存储错误ID的修复处理 * @param id 字体大小索引 * @return 对应的style资源ID */ public static int getTexAppearanceResource(int id) { /** * HACKME: 修复在偏好设置中存储资源ID的bug * 问题：从偏好设置读取的id可能超过资源数组长度 * 解决：如果id超出范围，返回默认字体大小 */ if (id >= TEXTAPPEARANCE_RESOURCES.length) { return BG_DEFAULT_FONT_SIZE; // 返回默认字体大小索引 } return TEXTAPPEARANCE_RESOURCES[id]; } /** * 获取文本外观资源数组长度 * 用于验证和边界检查 * @return 字体大小样式总数 */ public static int getResourcesSize() { return TEXTAPPEARANCE_RESOURCES.length; } } }