基本概念

• HorizontalScrollView 是一个容器，它允许包含的内容在水平方向上滚动。如果你有一块内容（比如一张宽大的图片或一个长长的水平列表），HorizontalScrollView 能让用户通过左右滑动来查看超出屏幕的部分

基本使用

• 在布局文件（如 activity_main.xml）中定义一个 HorizontalScrollView，并将其宽度设为 match_parent 以填满屏幕宽度，设置高度为 wrap_content 以适应内容的高度。然后，在 HorizontalScrollView 内部放置一个水平排列的子视图（如 LinearLayout），其中包含你想要滚动的内容，例如：

  <HorizontalScrollView
      xmlns:android="http://schemas.android.com/apk/res/android"
      android:layout_width="match_parent"
      android:layout_height="wrap_content">
  
      <LinearLayout
          android:layout_width="wrap_content"
          android:layout_height="wrap_content"
          android:orientation="horizontal">
  
          <!-- 这里放置需要水平滚动的内容 -->
          <!-- 可以是 TextView 或者其他布局一直叠加超出范围即可 -->
          
      </LinearLayout>
  </HorizontalScrollView>
  

  • 布局文件中的主要属性
    • android:layout_width：指定 HorizontalScrollView 的宽度。通常为 match_parent
    • android:layout_height：指定 HorizontalScrollView 的高度。通常为 wrap_content
    • android:fillViewport：设置为 true 可以使 HorizontalScrollView 填充整个视图，内容区域会被自动拉伸到视图的宽度。如果设置为 false，内容宽度不会自动拉伸

• 若需要通过代码动态控制滚动视图：

  HorizontalScrollView scrollView = findViewById(R.id.horizontalScrollView);
  scrollView.scrollTo(100, 0); // 滚动到 x=100 位置，y=0 位置
  

主要方法

• scrollTo(int x, int y)：将 HorizontalScrollView 滚动到指定的 x 和 y 位置。这个方法会立刻滚动到指定的位置

  scrollView.scrollTo(200, 0); // 滚动到 x=200 的位置
  

• scrollBy(int x, int y)：在当前滚动位置的基础上，滚动 x 和 y 距离

  scrollView.scrollBy(50, 0); // 相对于当前滚动位置，水平滚动 50 像素
  

• smoothScrollTo(int x, int y)：平滑地滚动到指定的 x 和 y 位置。这种滚动是动画的，用户体验更流畅

  scrollView.smoothScrollTo(300, 0); // 平滑地滚动到 x=300 的位置
  

• smoothScrollBy(int x, int y)：平滑地在当前滚动位置的基础上，滚动 x 和 y 距离

  scrollView.smoothScrollBy(100, 0); // 平滑地相对当前滚动位置，水平滚动 100 像素
  

常见场景

• 展示宽大的图片：当图片宽度超出屏幕时，可以使用 HorizontalScrollView 让用户水平滚动查看完整图片
• 水平滚动的列表：例如，展示一个水平滚动的标签栏或水平排列的商品展示

注意事项

• 性能：大量内容时，HorizontalScrollView 可能影响性能。确保不要将太多内容放入其中，或者考虑使用更高效的布局和视图组合
• 嵌套使用：如果 HorizontalScrollView 嵌套在其他滚动视图中（如 ScrollView），确保用户滚动的体验不会混乱，避免多个滚动视图之间的冲突