new annotation

app/src/main/java/net/micode/notes/tool/ResourceParser.java

@@ -13,7 +13,20 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-
+/*简介：字面意义是资源分析器，实际上就是获取资源并且在程序中使用，比如颜色图片等
+ * 实现方法：主要利用R.java这个类，其中包括
+ * R.id      组件资源引用
+ * R.drawable  图片资源 （被使用）
+ * R.layout  布局资源
+ * R.menu   菜单资源
+ * R.String  文字资源
+ * R.style    主题资源 （被使用）
+ * 在按顺序设置好相应的id后，就可以编写简单的getXXX函数获取需要的资源
+ * 
+ * 特殊的变量 ：
+ * @BG_DEFAULT_COLOR 默认背景颜色（黄）
+ * BG_DEFAULT_FONT_SIZE 默认文本大小（中）
+ */
 package net.micode.notes.tool;
 
 import android.content.Context;
@@ -28,16 +41,16 @@ public class ResourceParser {
     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 RED              = 4;//设置颜色的值（ID
 
-    public static final int BG_DEFAULT_COLOR = YELLOW;
+    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 TEXT_SUPER       = 3;//设置字体大小的值(ID
 
-    public static final int BG_DEFAULT_FONT_SIZE = TEXT_MEDIUM;
+    public static final int BG_DEFAULT_FONT_SIZE = TEXT_MEDIUM;//默认字体大小为中等
 
     public static class NoteBgResources {
         private final static int [] BG_EDIT_RESOURCES = new int [] {
@@ -46,7 +59,7 @@ public class ResourceParser {
             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,
@@ -54,26 +67,26 @@ public class ResourceParser {
             R.drawable.edit_title_white,
             R.drawable.edit_title_green,
             R.drawable.edit_title_red
-        };
+        };//创建设置标题颜色的篮框
 
         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)) {
+                NotesPreferenceActivity.PREFERENCE_SET_BG_COLOR_KEY, false)) 
+        {
             return (int) (Math.random() * NoteBgResources.BG_EDIT_RESOURCES.length);
         } else {
             return BG_DEFAULT_COLOR;
         }
-    }
-
+    }//直接获取默认的背景颜色。
     public static class NoteItemBgResources {
         private final static int [] BG_FIRST_RESOURCES = new int [] {
             R.drawable.list_yellow_up,
@@ -81,7 +94,7 @@ public class ResourceParser {
             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,
@@ -89,7 +102,7 @@ public class ResourceParser {
             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,
@@ -97,7 +110,7 @@ public class ResourceParser {
             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,
@@ -105,7 +118,7 @@ public class ResourceParser {
             R.drawable.list_white_single,
             R.drawable.list_green_single,
             R.drawable.list_red_single
-        };
+        };//设置单独的颜色
 
         public static int getNoteBgFirstRes(int id) {
             return BG_FIRST_RESOURCES[id];
@@ -135,7 +148,7 @@ public class ResourceParser {
             R.drawable.widget_2x_white,
             R.drawable.widget_2x_green,
             R.drawable.widget_2x_red,
-        };
+        };//设置2X颜色
 
         public static int getWidget2xBgResource(int id) {
             return BG_2X_RESOURCES[id];
@@ -147,7 +160,7 @@ public class ResourceParser {
             R.drawable.widget_4x_white,
             R.drawable.widget_4x_green,
             R.drawable.widget_4x_red
-        };
+        };//设置4X颜色
 
         public static int getWidget4xBgResource(int id) {
             return BG_4X_RESOURCES[id];
@@ -172,7 +185,7 @@ public class ResourceParser {
                 return BG_DEFAULT_FONT_SIZE;
             }
             return TEXTAPPEARANCE_RESOURCES[id];
-        }
+        }//这里有一个容错的函数，防止输入的id大于资源总量，若如此，则自动返回默认的设置结果
 
         public static int getResourcesSize() {
             return TEXTAPPEARANCE_RESOURCES.length;