|
|
/*
|
|
|
* 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;
|
|
|
}
|
|
|
}
|
|
|
} |
