DraggableGridView 技术文档

1. 安装指南

1.1 项目引入

要开始使用 DraggableGridView，请按照以下步骤操作：

1. 将 libs/DraggableGridView.jar 文件放置到你的项目目录中，并将其添加到项目的构建路径中。
2. 在你希望使用 DraggableGridView 的 Activity 中添加导入语句：

   import com.animoto.android.views.*;
   

3. 在 Activity 的布局 XML 文件中添加 DraggableGridView 视图并保存：

   <com.animoto.android.views.DraggableGridView
       android:id="@+id/dgv"
       android:layout_height="fill_parent"
       android:layout_width="fill_parent"
       android:layout_alignParentTop="true"
       android:layout_alignParentLeft="true">
   </com.animoto.android.views.DraggableGridView>
   

4. 在代码中获取 DraggableGridView 的引用：

   public class DraggableGridViewSampleActivity extends Activity {
       DraggableGridView dgv;
       
       @Override
       public void onCreate(Bundle savedInstanceState) {
           super.onCreate(savedInstanceState);
           setContentView(R.layout.main);
           
           dgv = ((DraggableGridView)findViewById(R.id.dgv));
       }
   }
   

5. 完成以上步骤后，你可以开始向 DraggableGridView 中添加任何类型的视图。

2. 项目的使用说明

2.1 基本功能

• 拖拽与排序：长按视图即可开始移动它，拖动视图可以在其他视图之间重新排列，并将其放置在合适的位置。
• 自适应屏幕：DraggableGridView 能够很好地适应任何屏幕尺寸或分辨率。
• 平滑动画：在子视图重新排列时，会显示平滑的动画效果。
• 高性能：即使包含数百个子视图，DraggableGridView 也能表现出色。
• 滚动功能：当子视图数量超过可见区域时，DraggableGridView 会自动变为可滚动视图。
• 拖拽滚动：即使子视图正在被拖动，也可以通过将其拖动到顶部或底部来实现滚动。

2.2 示例项目

项目中包含一个 Android 版本的磁性诗句示例，类似于你可能在朋友冰箱上看到的磁性诗句。它为 DraggableGridView 创建了一个 OnRearrangeListener，用于操作一个字符串的 ArrayList。

如果你不想单独跟踪网格的元素，建议创建一个包含所需信息的自定义视图，并在需要时从 DraggableGridView 中收集这些信息：

String[] words = new String[dgv.getChildCount()];
for (int i = 0; i < words.length; i++)
    words[i] = ((CustomView)dgv.getChildAt(i)).word;

3. 项目API使用文档

3.1 主要API

• addView(View child)：向 DraggableGridView 中添加一个子视图。
• getChildCount()：获取 DraggableGridView 中子视图的数量。
• getChildAt(int index)：获取指定位置的子视图。
• setOnRearrangeListener(OnRearrangeListener listener)：设置一个监听器，用于在子视图重新排列时触发回调。

3.2 自定义视图

你可以创建自定义视图来包含更多信息，并在需要时从 DraggableGridView 中获取这些信息。例如：

public class CustomView extends View {
    public String word;
    
    public CustomView(Context context, String word) {
        super(context);
        this.word = word;
    }
}

4. 项目安装方式

4.1 手动安装

1. 下载 DraggableGridView.jar 文件。
2. 将 DraggableGridView.jar 文件放置到项目的 libs 目录中。
3. 在项目的构建路径中添加 DraggableGridView.jar。

4.2 使用示例

在项目中使用 DraggableGridView 的示例代码如下：

TextView tv = new TextView(this);
tv.setText("Hello world!");
dgv.addView(tv);

通过以上步骤，你可以在 Android 项目中成功安装并使用 DraggableGridView。