Android 畫廊效果常用於圖片預覽、Banner 輪播。本文提供 Java (原生) 與 C# (Xamarin.Android) 兩套完整實現代碼,涵蓋 Gallery (已棄用) 與現代 ViewPager2/RecyclerView 替代方案,並附帶佈局與效果圖。

<androidx.viewpager2.widget.ViewPager2
android:id="@+id/viewPager"
android:layout_width="match_parent"
android:layout_height="200dp" />
<ImageView
android:id="@+id/ivCurrent"
android:layout_width="match_parent"
android:layout_height="300dp"
android:layout_below="@id/viewPager"
android:scaleType="centerCrop" />
public class ImagePagerAdapter extends RecyclerView.Adapter {
private final Context context;
private final int[] imageResIds;
public ImagePagerAdapter(Context context, int[] imageResIds) {
this.context = context;
this.imageResIds = imageResIds;
}
@NonNull @Override
public VH onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
ImageView iv = new ImageView(context);
iv.setScaleType(ImageView.ScaleType.CENTER_CROP);
iv.setLayoutParams(new ViewGroup.LayoutParams(
ViewGroup.LayoutParams.MATCH_PARENT,
ViewGroup.LayoutParams.MATCH_PARENT));
return new VH(iv);
}
@Override public void onBindViewHolder(@NonNull VH holder, int position) {
holder.imageView.setImageResource(imageResIds[position]);
}
@Override public int getItemCount() { return imageResIds.length; }
static class VH extends RecyclerView.ViewHolder {
ImageView imageView;
VH(ImageView v) { super(v); imageView = v; }
}
}
public class MainActivity extends AppCompatActivity {
private int[] images = {R.drawable.test1, R.drawable.test2, R.drawable.test3,
R.drawable.test4, R.drawable.test5, R.drawable.test6,
R.drawable.test7, R.drawable.test8};
private ViewPager2 viewPager;
private ImageView ivCurrent;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
viewPager = findViewById(R.id.viewPager);
ivCurrent = findViewById(R.id.ivCurrent);
viewPager.setAdapter(new ImagePagerAdapter(this, images));
viewPager.registerOnPageChangeCallback(new ViewPager2.OnPageChangeCallback() {
@Override public void onPageSelected(int position) {
ivCurrent.setImageResource(images[position]);
}
});
// 初始顯示第一張
ivCurrent.setImageResource(images[0]);
}
}
using Android.App;
using Android.OS;
using Android.Widget;
using Android.Support.V4.View;
namespace ImageDemo {
[Activity(Label = "@string/ApplicationName", MainLauncher = true, Icon = "@drawable/icon")]
public class MainActivity : Activity {
private ViewPager _viewPager;
private ImageView _selectedImg;
private readonly int[] _imageIds = {
Resource.Drawable.test1, Resource.Drawable.test2, Resource.Drawable.test3,
Resource.Drawable.test4, Resource.Drawable.test5, Resource.Drawable.test6,
Resource.Drawable.test7, Resource.Drawable.test8
};
protected override void OnCreate(Bundle bundle) {
base.OnCreate(bundle);
SetContentView(Resource.Layout.Main);
_viewPager = FindViewById(Resource.Id.viewPager);
_selectedImg = FindViewById(Resource.Id.currentImg);
_viewPager.Adapter = new ImagePagerAdapter(this, _imageIds);
_viewPager.PageSelected += (s, e) => _selectedImg.SetImageResource(_imageIds[e.Position]);
_selectedImg.SetImageResource(_imageIds[0]);
}
}
public class ImagePagerAdapter : PagerAdapter {
private readonly Context _context;
private readonly int[] _imageIds;
public ImagePagerAdapter(Context context, int[] imageIds) {
_context = context; _imageIds = imageIds;
}
public override int Count => _imageIds.Length;
public override bool IsViewFromObject(View view, Java.Lang.Object obj) => view == obj;
public override Java.Lang.Object InstantiateItem(ViewGroup container, int position) {
var image = new ImageView(_context);
image.SetImageResource(_imageIds[position]);
image.SetScaleType(ImageView.ScaleType.CenterCrop);
container.AddView(image);
return image;
}
public override void DestroyItem(ViewGroup container, int position, Java.Lang.Object obj) {
container.RemoveView((View)obj);
}
}
}
Gallery 為 API 16 棄用組件,存在回收機制缺陷、不支援 RTL、觸摸衝突等問題。RecyclerView + SnapHelper 或開源 Banner 庫。兩套代碼邏輯一致,語言差異僅在語法糖與 API 命名慣例,核心思路均為「適配器 + 頁面變更監聽 + 大圖聯動」。