zuoye/src/net/micode/notes/ui/NotesListItem.java

/*
 * 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.ui;

import android.content.Context;
import android.text.format.DateUtils;
import android.view.View;
import android.widget.CheckBox;
import android.widget.ImageView;
import android.widget.LinearLayout;
import android.widget.TextView;

import net.micode.notes.R;
import net.micode.notes.data.Notes;
import net.micode.notes.tool.DataUtils;
import net.micode.notes.tool.ResourceParser.NoteItemBgResources;

/**
 * NotesListItem类代表每个笔记列表项的视图。
 * 它负责显示笔记项的标题、时间、警告图标（如果有的话），并提供选中状态的支持。
 */
public class NotesListItem extends LinearLayout {
    private ImageView mAlert;        // 警告图标，显示提醒或重要标记
    private TextView mTitle;         // 标题文本
    private TextView mTime;          // 更新时间文本
    private TextView mCallName;      // 来电记录时显示的联系人名称
    private NoteItemData mItemData; // 存储笔记项的数据
    private CheckBox mCheckBox;     // 用于显示复选框（如果启用选择模式）

    /**
     * 构造函数，初始化视图元素
     * @param context 上下文环境
     */
    public NotesListItem(Context context) {
        super(context);
        inflate(context, R.layout.note_item, this); // 加载布局
        mAlert = (ImageView) findViewById(R.id.iv_alert_icon); // 获取警告图标
        mTitle = (TextView) findViewById(R.id.tv_title); // 获取标题文本
        mTime = (TextView) findViewById(R.id.tv_time); // 获取时间文本
        mCallName = (TextView) findViewById(R.id.tv_name); // 获取来电名称文本
        mCheckBox = (CheckBox) findViewById(android.R.id.checkbox); // 获取复选框
    }

    /**
     * 绑定数据到视图。
     * 根据不同的数据类型（文件夹、普通笔记、来电记录等），动态调整显示内容。
     * @param context 上下文环境
     * @param data 要显示的数据（包含笔记的相关信息）
     * @param choiceMode 是否启用选择模式
     * @param checked 当前项是否选中
     */
    public void bind(Context context, NoteItemData data, boolean choiceMode, boolean checked) {
        // 如果启用了选择模式且数据为普通笔记，则显示复选框
        if (choiceMode && data.getType() == Notes.TYPE_NOTE) {
            mCheckBox.setVisibility(View.VISIBLE); // 显示复选框
            mCheckBox.setChecked(checked); // 设置复选框选中状态
        } else {
            mCheckBox.setVisibility(View.GONE); // 否则隐藏复选框
        }

        mItemData = data; // 存储数据对象

        // 处理来电记录文件夹项
        if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {
            mCallName.setVisibility(View.GONE); // 隐藏来电名称
            mAlert.setVisibility(View.VISIBLE); // 显示警告图标
            mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
            mTitle.setText(context.getString(R.string.call_record_folder_name)
                    + context.getString(R.string.format_folder_files_count, data.getNotesCount()));
            mAlert.setImageResource(R.drawable.call_record); // 设置来电记录图标
        } else if (data.getParentId() == Notes.ID_CALL_RECORD_FOLDER) {
            // 处理来电记录中的单个笔记项
            mCallName.setVisibility(View.VISIBLE); // 显示来电名称
            mCallName.setText(data.getCallName());
            mTitle.setTextAppearance(context, R.style.TextAppearanceSecondaryItem);
            mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet())); // 设置笔记内容的格式化标题
            if (data.hasAlert()) {
                mAlert.setImageResource(R.drawable.clock); // 如果有提醒，显示时钟图标
                mAlert.setVisibility(View.VISIBLE);
            } else {
                mAlert.setVisibility(View.GONE); // 否则隐藏警告图标
            }
        } else {
            // 处理普通文件夹项
            mCallName.setVisibility(View.GONE); // 隐藏来电名称
            mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);

            if (data.getType() == Notes.TYPE_FOLDER) {
                // 文件夹类型的笔记项
                mTitle.setText(data.getSnippet()
                        + context.getString(R.string.format_folder_files_count,
                        data.getNotesCount()));
                mAlert.setVisibility(View.GONE); // 文件夹不显示警告图标
            } else {
                mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet())); // 设置标题文本
                if (data.hasAlert()) {
                    mAlert.setImageResource(R.drawable.clock); // 如果有提醒，显示时钟图标
                    mAlert.setVisibility(View.VISIBLE);
                } else {
                    mAlert.setVisibility(View.GONE); // 否则隐藏警告图标
                }
            }
        }

        // 设置更新时间文本
        mTime.setText(DateUtils.getRelativeTimeSpanString(data.getModifiedDate()));

        // 设置背景颜色
        setBackground(data);
    }

    /**
     * 根据笔记数据设置背景颜色。
     * @param data 笔记数据
     */
    private void setBackground(NoteItemData data) {
        int id = data.getBgColorId(); // 获取背景颜色ID
        if (data.getType() == Notes.TYPE_NOTE) {
            // 设置普通笔记的背景
            if (data.isSingle() || data.isOneFollowingFolder()) {
                setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(id)); // 单个或后续文件夹笔记
            } else if (data.isLast()) {
                setBackgroundResource(NoteItemBgResources.getNoteBgLastRes(id)); // 最后一项笔记
            } else if (data.isFirst() || data.isMultiFollowingFolder()) {
                setBackgroundResource(NoteItemBgResources.getNoteBgFirstRes(id)); // 第一项笔记或多个后续文件夹
            } else {
                setBackgroundResource(NoteItemBgResources.getNoteBgNormalRes(id)); // 普通笔记
            }
        } else {
            setBackgroundResource(NoteItemBgResources.getFolderBgRes()); // 设置文件夹背景
        }
    }

    /**
     * 获取绑定到此视图的笔记数据。
     * @return 当前视图的数据对象
     */
    public NoteItemData getItemData() {
        return mItemData;
    }
}