更新

src/tool/ResourceParser.java

@@ -1,44 +1,37 @@
-/*
- * 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.
- */
-
 package net.micode.notes.tool;
-
+ 
-import android.content.Context;
+/*简介：字面意义是资源分析器，实际上就是获取资源并且在程序中使用，比如颜色图片等
-import android.preference.PreferenceManager;
+ * 实现方法：主要利用R.java这个类，其中包括
-
+ * R.id      组件资源引用
-import net.micode.notes.R;
+ * R.drawable  图片资源 （被使用）
-import net.micode.notes.ui.NotesPreferenceActivity;
+ * R.layout  布局资源
-
+ * R.menu   菜单资源
+ * R.String  文字资源
+ * R.style    主题资源 （被使用）
+ * 在按顺序设置好相应的id后，就可以编写简单的getXXX函数获取需要的资源
+ * 
+ * 特殊的变量 ：
+ * @BG_DEFAULT_COLOR 默认背景颜色（黄）
+ * BG_DEFAULT_FONT_SIZE 默认文本大小（中）
+ */
+ 
 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;
-
+ 
     public static class NoteBgResources {
         private final static int [] BG_EDIT_RESOURCES = new int [] {
             R.drawable.edit_yellow,
@@ -47,7 +40,7 @@ public class ResourceParser {
             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,
@@ -55,17 +48,17 @@ public class ResourceParser {
             R.drawable.edit_title_green,
             R.drawable.edit_title_red
         };
-
+ 
         public static int getNoteBgResource(int id) {
             return BG_EDIT_RESOURCES[id];
         }
-
+ 
         public static int getNoteTitleBgResource(int id) {
             return BG_EDIT_TITLE_RESOURCES[id];
         }
     }
-
+    //直接获取默认的背景颜色。看不太懂，这个PREFERENCE_SET_BG_COLOR_KEY是个final string,也就是说getBoolean肯定执行else，为什么要这么写
-    public static int getDefaultBgId(Context context) {
+    public static int getDefaultBgId(Context context) { 
         if (PreferenceManager.getDefaultSharedPreferences(context).getBoolean(
                 NotesPreferenceActivity.PREFERENCE_SET_BG_COLOR_KEY, false)) {
             return (int) (Math.random() * NoteBgResources.BG_EDIT_RESOURCES.length);
@@ -73,7 +66,7 @@ public class ResourceParser {
             return BG_DEFAULT_COLOR;
         }
     }
-
+ 
     public static class NoteItemBgResources {
         private final static int [] BG_FIRST_RESOURCES = new int [] {
             R.drawable.list_yellow_up,
@@ -82,7 +75,7 @@ public class ResourceParser {
             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,
@@ -90,7 +83,7 @@ public class ResourceParser {
             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,
@@ -98,7 +91,7 @@ public class ResourceParser {
             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,
@@ -106,28 +99,28 @@ public class ResourceParser {
             R.drawable.list_green_single,
             R.drawable.list_red_single
         };
-
+ 
         public static int getNoteBgFirstRes(int id) {
             return BG_FIRST_RESOURCES[id];
         }
-
+ 
         public static int getNoteBgLastRes(int id) {
             return BG_LAST_RESOURCES[id];
         }
-
+ 
         public static int getNoteBgSingleRes(int id) {
             return BG_SINGLE_RESOURCES[id];
         }
-
+ 
         public static int getNoteBgNormalRes(int id) {
             return BG_NORMAL_RESOURCES[id];
         }
-
+ 
         public static int getFolderBgRes() {
             return R.drawable.list_folder;
         }
     }
-
+ 
     public static class WidgetBgResources {
         private final static int [] BG_2X_RESOURCES = new int [] {
             R.drawable.widget_2x_yellow,
@@ -136,11 +129,11 @@ public class ResourceParser {
             R.drawable.widget_2x_green,
             R.drawable.widget_2x_red,
         };
-
+ 
         public static int getWidget2xBgResource(int id) {
             return BG_2X_RESOURCES[id];
         }
-
+ 
         private final static int [] BG_4X_RESOURCES = new int [] {
             R.drawable.widget_4x_yellow,
             R.drawable.widget_4x_blue,
@@ -148,12 +141,12 @@ public class ResourceParser {
             R.drawable.widget_4x_green,
             R.drawable.widget_4x_red
         };
-
+ 
         public static int getWidget4xBgResource(int id) {
             return BG_4X_RESOURCES[id];
         }
     }
-
+ 
     public static class TextAppearanceResources {
         private final static int [] TEXTAPPEARANCE_RESOURCES = new int [] {
             R.style.TextAppearanceNormal,
@@ -161,7 +154,8 @@ public class ResourceParser {
             R.style.TextAppearanceLarge,
             R.style.TextAppearanceSuper
         };
-
+        
+        //这里有一个容错的函数，防止输入的id大于资源总量，若如此，则自动返回默认的设置结果
         public static int getTexAppearanceResource(int id) {
             /**
              * HACKME: Fix bug of store the resource id in shared preference.
@@ -173,9 +167,10 @@ public class ResourceParser {
             }
             return TEXTAPPEARANCE_RESOURCES[id];
         }
-
+ 
         public static int getResourcesSize() {
             return TEXTAPPEARANCE_RESOURCES.length;
         }
     }
 }
+