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


public class FoldersListAdapter extends CursorAdapter {
    // 定义查询的列
    public static final String [] PROJECTION = {
        NoteColumns.ID, // 笔记ID
        NoteColumns.SNIPPET // 笔记摘要
    };



    // 定义列的索引
    public static final int ID_COLUMN   = 0;
    public static final int NAME_COLUMN = 1; // ID列的索引

    // 定义一个名为 FoldersListAdapter 的构造函数，接收两个参数：Context 类型的 context 和 Cursor 类型的 c
    public FoldersListAdapter(Context context, Cursor c) {
        // 调用父类（可能是 ArrayAdapter 或其他适配器类）的构造函数，传递 context 和 c 参数
        super(context, c);
        // TODO Auto-generated constructor stub
    }

    // 重写方法，用于创建一个新的视图实例
    @Override
    public View newView(Context context, Cursor cursor, ViewGroup parent) {
        // 使用传入的上下文对象创建一个新的FolderListItem视图实例
        // FolderListItem是一个自定义的视图类，用于展示文件夹列表中的每一项
        return new FolderListItem(context);
    }

    @Override
    // 重写父类或接口中的方法
    public void bindView(View view, Context context, Cursor cursor) {
        // 绑定视图的方法，用于将数据绑定到视图上
        if (view instanceof FolderListItem) {
            // 检查传入的视图是否是FolderListItem的实例
            String folderName = (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? context
                    // 如果当前游标所在的行的ID是根文件夹的ID
                    .getString(R.string.menu_move_parent_folder) : cursor.getString(NAME_COLUMN);
                    // 则获取字符串资源中的"menu_move_parent_folder"作为文件夹名称
                    // 否则，从游标中获取NAME_COLUMN列的值作为文件夹名称
            ((FolderListItem) view).bind(folderName);
            // 将文件夹名称绑定到FolderListItem视图上
        }
    }

    // 定义一个方法，用于获取指定位置的文件夹名称
    public String getFolderName(Context context, int position) {
        // 通过位置获取对应的Cursor对象
        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，用于表示文件夹列表中的一个条目
    private class FolderListItem extends LinearLayout {
        // 声明一个TextView成员变量mName，用于显示文件夹名称
        private TextView mName;

        // 构造方法，接收一个Context对象作为参数
        public FolderListItem(Context context) {
            // 调用父类LinearLayout的构造方法，传入context
            super(context);
            // 调用inflate方法，将布局文件R.layout.folder_list_item填充到当前LinearLayout中
            inflate(context, R.layout.folder_list_item, this);
            // 通过findViewById方法找到布局文件中的TextView控件，并赋值给mName
            mName = (TextView) findViewById(R.id.tv_folder_name);
        }

        // 定义一个bind方法，接收一个String类型的name参数，用于绑定文件夹名称到TextView上
        public void bind(String name) {
            // 调用TextView的setText方法，将传入的name设置为TextView的文本内容
            mName.setText(name);
        }
    }

}
