Xem cuộn thẻ

Đã thêm vào API cấp XE12

View cho thấy các khung hiển thị con cuộn theo chiều ngang, được gọi là thẻ.

Các thẻ này đến từ CardScrollAdapter liên kết với CardScrollView Mỗi thẻ đại diện trực quan cho một mục Object nhất định.

Xem Cuộn thẻ trong hoạt động để biết thêm thông tin.

Cách sử dụng chung

  1. Tạo một bộ thẻ bằng hệ phân cấp khung hiển thị chuẩn hoặc lớp CardBuilder.
  2. Triển khai CardScrollAdapter để cung cấp bộ thẻ cho CardScrollView Mỗi thẻ có một mã nhận dạng Object duy nhất và đại diện cho một mục Object nhất định.
  3. Hãy đặt khung hiển thị nội dung của hoạt động là CardScrollView hoặc sử dụng CardScrollView trong một bố cục.

Xử lý thao tác cuộn và tương tác

CardScrollView thông báo cho bạn qua các giao diện trình nghe sau đây kế thừa từ AdapterView:

Lớp lồng ghép
enum CardScrollView.Animation Xác định loại ảnh động dùng để di chuyển đến, chèn hoặc xoá thẻ.
Hằng số kế thừa
Trường kế thừa
Công ty xây dựng công cộng
CardScrollView(ngữ cảnh Context, các thuộc tính AttributeSet)
CardScrollView(Ngữ cảnh Ngữ cảnh, thuộc tính AttributeSet, int defStyle)
Phương thức công khai
void
boolean
animate(vị trí in, CardScrollView.Animation animationType)
void
CardScrollAdapter
long
int
Xem
boolean
boolean
boolean
onKeyDown(int keyCode, sự kiện KeyEvent)
void
onWindowFocusChanged(boolean hasWindowFocus)
void
setAdapter(bộ chuyển đổi CardScrollAdapter)
void
setEmptyView(View EmptyView)
void
void
setSelection(vị trí int)
Phương thức được bảo vệ
boolean
boolean
void
void
onLayout(boolean đã thay đổi, int left, int top, int right, int bottom)
void
onVisibilityChanged(Chế độ xem đã thay đổi View, chế độ hiển thị int)
Phương thức kế thừa

Công ty xây dựng công cộng

Đã thêm vào API cấp XE12

công khai CardScrollView (Bối cảnh)

Đã thêm vào API cấp XE12

công khai CardScrollView (Ngữ cảnh, thuộc tính AttributeSet)

Đã thêm vào API cấp XE12

công khai CardScrollView (Ngữ cảnh, thuộc tính AttributeSet, int defStyle)

Phương thức công khai

Đã thêm vào API cấp XE12

công khai trống kích hoạt ()

Yêu cầu CardScrollView kích hoạt và sẵn sàng hiển thị. TODO(ajcbik): điều tra xem chúng ta có thể thay thế [de]activate bằng sự kiện tiêu điểm hay không.

Đã thêm vào API cấp XE21

công khai boolean Ảnh động (vị trí in, CardScrollView.Animation animationType)

Hình động cho thẻ ở một vị trí nhất định, trong đó animationType phải là một trong:

  • NAVIGATION: di chuyển đến thẻ nhất định từ vị trí bất kỳ, thao tác điều hướng thông thường,
  • INSERTION: di chuyển đến thẻ nhất định, thẻ này sẽ xuất hiện trong chế độ xem, sau khi chèn,
  • DELETION: thẻ cụ thể sẽ biến mất khỏi chế độ xem (nếu được chọn) sau khi xoá.
Ảnh động sẽ bị bỏ qua nếu trình cuộn bị vô hiệu hoá, nếu một ảnh động tự động trước đó là vẫn đang diễn ra hoặc nếu vị trí không hợp lệ. Ảnh động xoá chỉ xảy ra nếu thẻ hiện đang được chọn.

Nên sử dụng ảnh động chèn và xoá sau khi thực hiện thao tác thay đổi tương ứng trong CardScrollAdapter. Ảnh động sẽ gọi notifyDataSetChanged() trên bộ chuyển đổi tại thời điểm thích hợp trong ảnh động, ngay cả khi bị bỏ qua hoặc kết thúc sớm.

Ví dụ về cách sử dụng:

 .... insert card at p-th position in adapter ....
 animate(p, INSERTION);    // calls notifyDataSetChanged() on adapter
 

Tham số
position của thẻ liên quan đến ảnh động
animationType kiểm soát loại ảnh động sẽ sử dụng
Giá trị trả về
  • ảnh động đã được bắt đầu hay chưa
Đã thêm vào API cấp XE12

công khai trống huỷ kích hoạt ()

Yêu cầu CardScrollView huỷ kích hoạt; nó sẽ không được hiển thị cho đến activate() sẽ được gọi lại.

Đã thêm vào API cấp XE12

công khai CardScrollAdapter getAdapter ()

công khai dài getSelectedItemId ()

Đã thêm vào API cấp XE12

công khai đánh chặn getSelectedItemPosition ()

Đã thêm vào API cấp XE12

công khai Chế độ xem getSelectedView ()

Đã thêm vào API cấp XE12

công khai boolean isActivated ()

công khai boolean isHorizontalScrollBarEnabled ()

công khai boolean onKeyDown (int keyCode, sự kiện KeyEvent)

công khai trống onWindowFocusChanged (boolean hasWindowFocus)

Đã thêm vào API cấp XE12

công khai trống setAdapter (Bộ chuyển đổi CardScrollAdapter)

công khai trống setEmptyView (Xem Xem trống)

setEmptyView(View) không được hỗ trợ bởi CardScrollView

Để có ảnh động thích hợp và hành vi kéo, hãy sử dụng bộ chuyển đổi với một chế độ xem trống cho tập dữ liệu trống.

công khai trống setHorizontalScrollBarEnabled (boolean enable)

Đã thêm vào API cấp XE12

công khai trống setSelection (vị trí int)

Phương thức được bảo vệ

được bảo vệ boolean awakenScrollBars ()

Đánh thức thanh cuộn ngang, nếu có.

được bảo vệ boolean dispatchGenericFocusedEvent (sự kiện MotionEvent)

được bảo vệ trống initializeScrollbars (TypedArray a)

Đã thêm vào API cấp XE12

được bảo vệ trống onLayout (boolean đã thay đổi, int trái, int trên cùng, int bên phải, int dưới cùng)

được bảo vệ trống onVisibilityChanged (Chế độ xem changedView, chế độ hiển thị số nguyên)