Android gallery详解
继承关系html
public class Gallery extends AbsSpinnerjava
implements GestureDetector.OnGestureListenerandroid
java.lang.Object数组
android.view.Viewapp
android.view.ViewGroupide
android.widget.AdapterView<T extends android.widget.Adapter>函数
android.widget.AbsSpinner布局
android.widget.Gallery测试
Gallery控件也可翻译为画廊组件，主要用于横向显示图像列表。咱们经过查看Gallery类的继承结构，发现Gallery与咱们之间讲解过的Spinner有共同的父类：AbsSpinner。从某种意义上来讲，Gallery和Spinner都是一个列表框，只不过Spinner是一个垂直显示的列表模型，而Gallery则是一个水平显示的列表框。固然Gallery主要是经过用户拖动来展现一组图片或其它组件，而Spinner则是提供选择让用户选择。动画
Gallery的用户也与Spinner类似，只须要为它提供一个内容Adapter便可，该Adapter的getView()方法返回的View将做为Gallery组件的列表项。若是须要监听Gallery选择项的改变，则为Gallery添加OnItemSelectedListener监听器便可。
Gallery（画廊）使用Theme_galleryItemBackground做为Gallery（画廊）适配器中的各视图的默认参数。若是你没有设置，你就须要调整一些Gallery（画廊）的属性，好比间距。Gallery（画廊）中的视图应该使用Gallery.LayoutParams做为它们的布局参数类型。参见Gallery tutorial
内部类
class Gallery.LayoutParams
Gallery(画廊)扩展了LayoutParams，以此提供能够容纳当前的转换信息和先前的位置转换信息的场所。
XML属性
| 属性名称 |
描述 |
|||||||||||||||||||||||||||||||||||||||
| android:animationDuration |
设置布局变化时动画的转换所需的时间（毫秒级）。仅在动画开始时计时。该值必须是整数，好比：100。 |
|||||||||||||||||||||||||||||||||||||||
| android:gravity |
指定在对象的X和Y轴上如何放置内容。指定一下常量中的一个或多个（使用 “|”分割）
|
|||||||||||||||||||||||||||||||||||||||
| android:spacing |
（译者注:设置图片之间的间距） |
|||||||||||||||||||||||||||||||||||||||
| android:unselectedAlpha |
设置未选中的条目的透明度(Alpha)。该值必须是float类型，好比：“1.2”。 |
公共方法
public boolean dispatchKeyEvent (KeyEvent event)
在焦点路径上分发按钮事件到下一个视图。该路径从视图树的顶端遍历到当前得到焦点的视图。若是当前视图已得到焦点，就分发给自身。不然，就分发到下一个节点的焦点路径上。该方法监放任何按钮事件。
参数
event 被分发的按钮事件
返回值
boolean 时间被处理返回true，不然false
public void dispatchSetSelected (boolean selected)
分发setSelected给视图的子类。
参数
selected 新选中的状态
public ViewGroup.LayoutParams generateLayoutParams (AttributeSet attrs)
返回一个新的已设置属性集合的布局参数。
参数
attrs 用于生成布局参数的属性集合
返回值
一个ViewGroup.LayoutParams实例或者它的子类
public boolean onDown (MotionEvent e)
当轻击和按下手势事件发生时通知该方法。任何按下事件都会直接触发该方法。全部其余的事件都要先于该方法。
参数
e 按下动做事件
public boolean onFling (MotionEvent e1, MotionEvent e2, float velocityX, float velocityY)
当初始化的按下动做事件和松开动做事件匹配时通知fling（译者注：快滑，用户按下触摸屏、快速移动后松开）事件。该动做的速度经过计算X和Y轴上每秒移动多少像素得来。
参数
e1 致使开始fling的按下动做事件。
e2 触发当前onFling方法的移动动做事件
velocityX 测量fling沿X轴上的速度，像素/每秒
velocityY 测量fling沿Y轴上的速度，像素/每秒
返回值
若是该事件被消耗返回true，不然false。
public boolean onKeyDown (int keyCode, KeyEvent event)
处理左，右和点击事件
参数
keyCode 表明按下按钮的按键码，来自KeyEvent。
event 定义按钮动做的KeyEvent对象。
返回值
若是已经处理了按钮事件，则返回true。若是你想让下一个事件接收者处理，就返回false
参见
public boolean onKeyUp (int keyCode, KeyEvent event)
KeyEvent.Callback.onKeyMultiple()方法的默认实现：当KEYCODE_DPAD_CENTER 或者 KEYCODE_ENTER被释放时，执行点击视图操做。
参数
keyCode 表明按下按钮的按键码，来自KeyEvent。
event 定义按钮动做的KeyEvent对象。
返回值
若是已经处理了按钮事件，则返回true。若是你想让下一个事件接收者处理，就返回false
public void onLongPress (MotionEvent e)
MotionEvent初始化并按下触发长按并通知本方法。
参数
e 致使开始长按的初始按下动做事件。
public boolean onScroll (MotionEvent e1, MotionEvent e2, float distanceX, float distanceY)
当初始按下动做事件和当前移动动做事件致使滚动时通知本方法。为了方便提供了X和Y轴上的距离。
监听屏幕滚动事件。为了方便提供了X和Y轴上的距离。
参数
e1 致使滚动开始按下的动做事件。
e2 触发当前onScroll方法的移动动做事件。
distanceX 距离是自上一次调用onScroll方法在X轴上的距离。不是e1 和e2之间的距离。
distanceY 距离是自上一次调用onScroll方法在Y轴上的距离。不是e1 和e2之间的距离。
返回值
若是该事件被消耗返回true不然false
public void onShowPress (MotionEvent e)
用户已经执行按下动做尚未执行移动或者弹起动做。该事件常经过高亮一个元素来向用户提供一个视觉反馈即用户的操做已经被辨识了。
参数
e 按下动做事件
public boolean onSingleTapUp (MotionEvent e)
在轻击动做和up动做事件触发时通知本方法。（译者注：点击屏幕上的某项的执行流程 有两种状况，一种是时间很短，一种时间稍长：时间很短：onDown--->onSingleTapUp--->onSingleTapConfirmed，见这里1，这里2。）
参数
e 完成开始轻击的up动做事件
返回值
若是该事件被消耗返回true不然false
public boolean onTouchEvent (MotionEvent event)
实现该方法来处理触摸屏动做事件
参数
event 动做事件
返回值
若是该事件被消耗返回true不然false
public void setAnimationDuration (int animationDurationMillis)
设置当子视图改变位置时动画转换时间。仅限于动画开始时生效。
参数
animationDurationMillis 动画转换时间（毫秒级）
public void setCallbackDuringFling (boolean shouldCallback)
当flinged时是否回调每个getOnItemSelectedListener()。若是设为false，只回调最终选中的项。若是为true，则全部的项都会回调。
参数
shouldCallback 设置抛滑的过程当中是否回调
public void setGravity (int gravity)
描述子视图的对齐方式。
public void setSpacing (int spacing)
设置Gallery中项的间距
参数
spacing Gallery中项的间距，以像素为单位
public void setUnselectedAlpha (float unselectedAlpha)
设置Gallery中未选中项的透明度(alpha)值。
参数
unselectedAlpha 未选中项的透明度(alpha)值
public boolean showContextMenu ()
显示该视图上下文菜单。
返回值
上下文菜单是否显示。
public boolean showContextMenuForChild (View originalView)
为指定的视图或者其父类显示上下文菜单。
大部分状况下，子类不须要重写该方法。可是，若是子类被直接添加到窗口管理器（例如：addView(View.android.view.ViewGroup.LayoutParams)），此时就须要重写来显示上下文菜单
参数
originalView 上下文菜单初次调用的源视图
返回值
若是上下文菜单被显示了 则返回true。
受保护方法
protected int computeHorizontalScrollExtent ()
在水平范围内计算滚动条滑块的滚动范围。该值用来计算滚动条滑块的长度。
该范围可使用任意的单位可是必须跟computeHorizontalScrollRange()和computeHorizontalScrollOffset()的单位保持一致。
默认范围是视图的宽度。
返回值
滚动条滑块的水平滚动范围
protected int computeHorizontalScrollOffset ()
在水平范围内计算滚动条滑块的偏移量。该值用来计算水平滑块的位置。
该范围可使用任意的单位可是必须跟computeHorizontalScrollRange()和computeHorizontalScrollExtent()的单位保持一致。
默认偏移量是视图的偏移量。
返回值
滚动条滑块的水平偏移量。
protected int computeHorizontalScrollRange ()
计算滚动条水平方向上的滚动范围。
该范围可使用任意的单位可是必须跟computeHorizontalScrollExtent()和computeHorizontalScrollOffset()的单位保持一致。
返回值
水平滚动条表明的滑动总范围。
protected void dispatchSetPressed (boolean pressed)
分发 setPressed到View的子类。
参数
pressed 新按下的状态
protected ViewGroup.LayoutParams generateDefaultLayoutParams ()
返回默认的布局参数。当View做为参数传递给addView(View)而没有布局参数时就会请求这些参数。若是返回null，则addView会抛出异常。
返回值
默认的布局参数或null
protected ViewGroup.LayoutParams generateLayoutParams (ViewGroup.LayoutParams p)
返回一组合法的受支持的布局参数。当把ViewGroup传递给View而该View的布局参数并无经过checkLayoutParams(android.view.ViewGroup.LayoutParams)的测试时，就会调用该方法。该方法应该返回一组适合该ViewGroup的新的布局参数，该过程可能须要从指定的一组布局参数中复制相关的属性。
参数
p 被转换成适合该ViewGroup的一组参数。
返回值
返回一个ViewGroup.LayoutParams的实例或者一个它的子类。
protected int getChildDrawingOrder (int childCount, int i)
返回迭代的绘制子类索引。若是你想改变子类的绘制顺序就要重写该方法。默认返回 i 值。
提示：为了可以调用该方法，你必须首先调用setChildrenDrawingOrderEnabled(boolean)来容许子类排序。
参数
childCount 子类个数
i 当前迭代顺序
返回值
绘制该迭代子类的索引
protected boolean getChildStaticTransformation (View child, Transformation t)
（译者注：setStaticTransformationsEnabled这个属性设成true的时候每次viewGroup(看Gallery的源码就能够看到它是从ViewGroup间接继承过来的)在从新画它的child的时候都会促发getChildStaticTransformation这个函数。这里1、这里2）
protected ContextMenu.ContextMenuInfo getContextMenuInfo ()
Views若是有额外的信息跟上下文菜单有联系的话就须要实现该方法。返回的结果被用做回调方法onCreateContextMenu(ContextMenu, View, ContextMenuInfo)的参数。
返回值
显示上下文菜单的条目的额外信息。这些信息将会改变View不一样的子类
protected void onFocusChanged (boolean gainFocus, int direction, Rect previouslyFocusedRect)
当该视图的焦点状态发生改变时将会调用视图系统。当导向的方向触发焦点事件时，方向和先前得到焦点的矩形提供焦点事件的来源。当用户重写该方法，必须调用父类方法来触发标准的焦点处理事件。
参数
gainFocus 若是View得到焦点为true，不然false
direction 当调用requestFocus()方法来给该视图焦点时焦点的移动方向。该值:FOCUS_UP, FOCUS_DOWN, FOCUS_LEFT 或 FOCUS_RIGHT。该参数不经常使用，一般使用它的默认值。
previouslyFocusedRect 该视图坐标系统中先前得到焦点的视图的矩形。若是适用，这将得到焦点事件来源的更细致的信息（除了方向之外）。不然为null。
protected void onLayout (boolean changed, int l, int t, int r, int b)
当视图为每个子类分配大小和位置时从布局中调用该方法。有子类的派生类应该重写该方法在子类中调用布局。
参数
changed 该视图新的大小和位置。
l 相对父容器的左侧位置
t 相对父容器的顶部位置
r 相对父容器的右侧位置
b 相对父容器的底部位置
补充
文章精选
☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆☆
简介：
这是一个很是炫的效果，能够用手指直接拖动图片移动，要实现这一效果，就必须有一个容器来存放Gallery索要显示的图片。这里使用一个继承自BaseAdapter的派生类来装这些图片。咱们须要监听其事件setOnItemClickListener,从而肯定当前用户选择了那一张图片。首先，咱们须要将显示的图片的索引存放在一个int数组中。而后经过setImageResource方法来设置ImageView要显示的图片资源。最后将每张图片的ImageView显示在屏幕上。
案例一：
首先定义一个布局文件gallery.xml以下：
<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="fill_parent" android:layout_height="fill_parent" android:orientation="vertical" > <ImageView android:id="@+id/gallery_imageview_id" android:layout_width="match_parent" android:layout_height="wrap_content" android:src="@drawable/gallery_01" /> <Gallery android:id="@+id/gallery_id" android:layout_width="match_parent" android:layout_height="wrap_content" android:background="?android:galleryItemBackground" /> </LinearLayout>
2.java代码GalleryDemo.java文件：
package com.test;
import android.app.Activity; import android.content.ClipData.Item; import android.content.Context; import android.content.res.TypedArray; import android.os.Bundle; import android.view.ContextMenu; import android.view.MenuItem; import android.view.View; import android.view.ContextMenu.ContextMenuInfo; import android.view.ViewGroup; import android.widget.AdapterView; import android.widget.AdapterView.AdapterContextMenuInfo; import android.widget.AdapterView.OnItemClickListener; import android.widget.BaseAdapter; import android.widget.Gallery; import android.widget.ImageView; import android.widget.Toast;
public class GalleryDemo extends Activity {
private Gallery gallery;
private Integer[] imageids=
{
R.drawable.gallery_01,R.drawable.gallery_02,R.drawable.gallery_03,
R.drawable.gallery_04,R.drawable.gallery_05,R.drawable.gallery_06
};
@Override
protected void onCreate(Bundle savedInstanceState)
{
// TODO Auto-generated method stub
super.onCreate(savedInstanceState);
setContentView(R.layout.gallery);
gallery= (Gallery)findViewById(R.id.gallery_id);
//设置图片适配器
gallery.setAdapter(new ImageAdapter(this));
gallery.setSpacing(6);
//设置监听器
gallery.setOnItemClickListener(listener);
}
private OnItemClickListener listener =new OnItemClickListener() {
@Override
public void onItemClick(AdapterView<?> arg0, View arg1, int arg2, long arg3)
{
// toast("点击了"+arg2+"张图片");
ImageView imageView = (ImageView)findViewById(R.id.gallery_imageview_id);
imageView.setImageResource(imageids[arg2]);
}
};
@Override
public void onCreateContextMenu(ContextMenu menu, View v,
ContextMenuInfo menuInfo)
{
// TODO Auto-generated method stub
super.onCreateContextMenu(menu, v, menuInfo);
menu.add("Action");
}
@Override
public boolean onContextItemSelected(MenuItem item) {
// TODO Auto-generated method stub
// return super.onContextItemSelected(item);
AdapterContextMenuInfo info = (AdapterContextMenuInfo)item.getMenuInfo();
Toast.makeText(this, "LOngPress"+info.position, Toast.LENGTH_LONG).show();
return true;
}
public class ImageAdapter extends BaseAdapter{
int galleryItemBackgroud;
private Context context;
//图片数组
public ImageAdapter(Context c)
{
context=c;
}
//获取图片的个数
@Override
public int getCount() {
// TODO Auto-generated method stub
return imageids.length;
}
//获取图片在库中的位置
@Override
public Object getItem(int position) {
// TODO Auto-generated method stub
return position;
}
//获取图片的ID
@Override
public long getItemId(int position) {
// TODO Auto-generated method stub
return position;
}
@Override
public View getView(int position, View convertView, ViewGroup parent) {
ImageView imageView = new ImageView(context);
//给imageVIew设置资源
imageView.setImageResource(imageids[position]);
//设置显示比例类型
imageView.setScaleType(ImageView.ScaleType.FIT_XY);
//设置布局图片对象Imageview的宽度和高度120*80
imageView.setLayoutParams(new Gallery.LayoutParams(50,100));
// TODO Auto-generated method stub
return imageView;
}
}
}
3.运行效果：
- 1. Gallery Tutorials 详解
- 2. Android Gallery控件使用方法详解
- 3. Android Gallery
- 4. Android Gallery运用
- 5. android之GridView和Gallery
- 6. android的GridView和Gallery
- 7. android HorizontalScrollView替代Gallery
- 8. Android 的gallery控件
- 9. Android Gallery的使用
- 10. Gallery
- 更多相关文章...
- • 免费ARP详解 - TCP/IP教程
- • *.hbm.xml映射文件详解 - Hibernate教程
- • Flink 数据传输及反压详解
- • 为了进字节跳动，我精选了29道Java经典算法题，带详细讲解
-
每一个你不满意的现在，都有一个你没有努力的曾经。