Android开发之SlidingDrawer(一)

时间:2024-03-30 10:58:35

Android开发之SlidingDrawer(一)

/*

* Android开发之SlidingDrawer

* 北京Android俱乐部群:167839253

*Created on: 2012-7-26

*Author: blueeagle

* Email:[email protected]

*/

概述

为了方便操作、美观、节约空间等多方面原因的考虑,Android提供了SlidingDrawer这样的控件。SlidingDrawer——一个像抽屉一样的控件,我们暂且就称之为抽屉。这种抽屉的效果随处可见,比如Android通知栏的下拉效果,比如某个网页工具箱的弹出框等等。

我们来看一下SDK中是如何定义的:SlidingDrawer隐藏了再屏幕外的一些内容,并且允许用户用拖拽“手柄”的方式使得内容再次显示于屏幕中。SlidingDrawer可以用于水平和垂直两个方向。一个SlidingDrawer控件由两个子View来组成,一个是“手柄”一个就是拖拽出来的内容。SlidingDrawer应该覆盖在layout上面,这就是说SlidingDrawer应该只被用于一个FrameLayout或者是 RelativeLayout之中。SlidingDrawer的大小定义了它被拖拽出来的内容将占据多大的空间。因此,SlidingDrawer通常使用match_parent来定义其大小。SlidingDrawer还必须定义“手柄”和其内容这两个View的id号。

例如下面的布局文件就是一个简单的SlidingDrawer的描述:

<SlidingDrawer
    android:id="@+id/drawer"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
     android:handle="@+id/handle"
    android:content="@+id/content">
     <ImageView
        android:id="@+id/handle"
        android:layout_width="88dip"
        android:layout_height="44dip" />
     <GridView
        android:id="@+id/content"
         android:layout_width="match_parent"
        android:layout_height="match_parent" />
 </SlidingDrawer>

XML文件中的属性

属性名称

描述

android:allowSingleTap

是否可通过单击handle打开或关闭抽屉。 默认是true。(如果是false,用户必须通过拖动,滑动或者使用轨迹球。)

android:animateOnClick

顾名思义,点击的时候是否有动画。默认是true。

android:bottomOffset

“手柄”距离SlidingDrawer底部的额外距离 。

android:content

SlidingDrawer的内容。

android:handle

SlidingDrawer的“手柄”。

android:orientation

SlidingDrawer的方向。

android:topOffset

“手柄”距离SlidingDrawer顶部的额外距离 。

一些重要的方法:

voidsetOnDrawerCloseListener(SlidingDrawer.OnDrawerCloseListeneronDrawerCloseListener)

设置一个监听器,用来接收当抽屉被关闭时候的通知。

voidsetOnDrawerOpenListener(SlidingDrawer.OnDrawerOpenListeneronDrawerOpenListener)

Since:API Level 3

设置一个监听器,用来接收当抽屉被打开的时候的通知。

voidsetOnDrawerScrollListener(SlidingDrawer.OnDrawerScrollListeneronDrawerScrollListener)

设置一个监听器,用来接收当抽屉处于正在打开或者正在结束的滚动时候的通知。

animateClose():

使用动画关闭抽屉。

animateOpen():

使用动画打开抽屉

getContent():

获取内容

isMoving():

指示SlidingDrawer是否在移动。

isOpened():

指示SlidingDrawer是否已全部打开

lock():

屏蔽触摸事件。

unlock():

解除屏蔽触摸事件。

toggle():

切换打开和关闭的抽屉SlidingDrawer。

一个简单的例子

我们可以引用SDK中给我们提供的XML文件。

JAVA文件中如下编写:

public class SlidingDrawerDemoActivity extends Activity {  
            private SlidingDrawer myDrawer;
            private ImageView myImageView;
            private GridView myGridView;
            @Override
            protected void onCreate(Bundle savedInstanceState) {
                super.onCreate(savedInstanceState);
                setContentView(R.layout.main);
                myDrawer = (SlidingDrawer) findViewById(R.id.drawer);
                myImageView = (ImageView)findViewById(R.id.handle);
                myGridView = (GridView)findViewById(R.id.content);
                myDrawer.setOnDrawerOpenListener(newSlidingDrawer.OnDrawerOpenListener() {
                    @Override
                    public void onDrawerOpened() {
                        myImageView.setImageResource(R.drawable.down);
                    }
                });
                myDrawer.setOnDrawerCloseListener(newSlidingDrawer.OnDrawerCloseListener() {
                    @Override
                    public void onDrawerClosed() {
                        myImageView.setImageResource(R.drawable.up);
                    }
                });    
                myGridView.setAdapter(new ImageAdapter(this));   
                myGridView.setOnItemClickListener(newOnItemClickListener(){ 
                    @Override 
                    public void onItemClick(AdapterView<?> arg0, Viewarg1, int arg2, 
                            long arg3) { 
                        // TODO Auto-generated method stub 
                        Toast.makeText(SlidingDrawerDemoActivity.this, "你选择了"+(arg2+1)+" 号图片 ", Toast.LENGTH_SHORT).show(); 
                    } 
                });
    }
}

对于ImageAdapter这个类前面我们已经讨论过,这里就不再赘述。上面代码的效果如下:

Android开发之SlidingDrawer(一)

当然,还需要在GridView的XML文件中添加如下几个参数:

android:numColumns="auto_fit"

android:verticalSpacing="10dp"

android:horizontalSpacing="10dp"

android:columnWidth="90dp"

android:stretchMode="columnWidth"

android:gravity="center"

如果将SildingDrawer的高度属性改变一下例如:android:layout_height="100dip",则效果就会变成如下图所示:

Android开发之SlidingDrawer(一)

如果将SildingDrawer的topOffset属性改变一下例如:android:topOffset="150dip",则效果就会变成如下图所示:

Android开发之SlidingDrawer(一)

小结

上述简单的例子显然不能够满足应用开发的需求,我们在写程序的时候,经常遇见从左到右,从上到下,控制SlidingDrawer的大小等需求,要完成这个操作,我们需要自定义一个SlidingDrawer。自定义的SlidingDrawer则相当于是继承了一个LinearLayout,我们会在后面的章节详细讨论如何自定义一个SlidingDrawer。