/*
 * 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.database.Cursor;
import android.view.View;
import android.view.ViewGroup;
import android.widget.CursorAdapter;
import android.widget.LinearLayout;
import android.widget.TextView;

import net.micode.notes.R;
import net.micode.notes.data.Notes;
import net.micode.notes.data.Notes.NoteColumns;
/**
 * FoldersListAdapter 是一个基于 CursorAdapter 的适配器，用于显示文件夹列表。
 * 它绑定数据库中的笔记文件夹数据到 `FolderListItem` 视图中。
 */

public class FoldersListAdapter extends CursorAdapter {
    /** 查询使用的列投影：ID 和 SNIPPET（文件夹名称） */
public static final String[] PROJECTION = {
        NoteColumns.ID,
        NoteColumns.SNIPPET
};

/** 列索引定义 */
    public static final int ID_COLUMN   = 0;
    public static final int NAME_COLUMN = 1;
/**
 * 创建一个新的 FoldersListAdapter 实例。
 *
 * @param context 上下文对象
 * @param c       数据游标（需包含 ID 和 SNIPPET 字段）
 */
    public FoldersListAdapter(Context context, Cursor c) {
        super(context, c);
        // TODO Auto-generated constructor stub
    }
/**
 * 创建一个新的视图项（FolderListItem）。
 *
 * @param context 上下文对象
 * @param cursor  当前数据游标位置
 * @param parent  父容器
 * @return 新创建的 View 对象
 */
    @Override
    public View newView(Context context, Cursor cursor, ViewGroup parent) {
        return new FolderListItem(context);
    }
/**
 * 将当前游标位置的数据绑定到指定视图。
 * 如果是系统根目录文件夹，则显示特殊名称。
 *
 * @param view    要绑定的视图
 * @param context 上下文对象
 * @param cursor  当前数据游标位置
 */
    @Override
    public void bindView(View view, Context context, Cursor cursor) {
        if (view instanceof FolderListItem) {
            String folderName = (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? context
                    .getString(R.string.menu_move_parent_folder) : cursor.getString(NAME_COLUMN);
            ((FolderListItem) view).bind(folderName);
        }
    }
/**
 * 获取指定位置的文件夹名称。
 * 如果是系统根目录文件夹，返回本地化的“上级文件夹”字符串。
 *
 * @param context 上下文对象
 * @param position 数据位置
 * @return 文件夹名称
 */
    public String getFolderName(Context context, int position) {
        Cursor cursor = (Cursor) getItem(position);
        return (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? context
                .getString(R.string.menu_move_parent_folder) : cursor.getString(NAME_COLUMN);
    }
/**
 * FolderListItem 是一个 LinearLayout 子类，表示文件夹列表中的单个条目。
 * 包含一个 TextView 显示文件夹名称。
 */
    private class FolderListItem extends LinearLayout {
        private TextView mName;
/**
 * 创建一个新的 FolderListItem 实例。
 *
 * @param context 上下文对象
 */
        public FolderListItem(Context context) {
            super(context);
            inflate(context, R.layout.folder_list_item, this);
            mName = (TextView) findViewById(R.id.tv_folder_name);
        }
/**
 * 绑定文件夹名称到视图中。
 *
 * @param name 文件夹名称
 */
        public void bind(String name) {
            mName.setText(name);
        }
    }

}
