Xem cuộn thẻ

Đã thêm trong API cấp độ XE12

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

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

Xem Thẻ cuộn trong các hoạt động để biết thêm thông tin.

Cách sử dụng chung

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

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

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

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

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

Đã thêm trong API cấp độ XE12

public CardScrollView (Bối cảnh Ngữ cảnh)

Đã thêm trong API cấp độ XE12

public CardScrollView (Bối cảnh Ngữ cảnh, Thuộc tính setSet)

Đã thêm trong API cấp độ XE12

public CardScrollView (Bối cảnh Ngữ cảnh, Thuộc tính setSet, int defStyle)

Phương thức công khai

Đã thêm trong API cấp độ XE12

public khoảng 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 liệu chúng tôi có thể thay thế [de]kích hoạt bằng các sự kiện tiêu điểm hay không, hãy xem yêu cầu b/17574566.

Đã thêm trong API cấp độ XE21

public boolean animate (vị trí inint, CardScrollView.Animation animateType)

Tạo ảnh động cho thẻ ở một vị trí cụ thể, trong đó animationType phải là một trong:

  • NAVIGATION: di chuyển đến thẻ nhất định từ bất kỳ vị trí nào, điều hướng thông thường,
  • INSERTION: di chuyển sang thẻ nhất định, xuất hiện trong chế độ xem sau khi chèn,
  • DELETION: thẻ đã cho sẽ biến mất khỏi chế độ xem (nếu được chọn) sau khi xóa.
Ảnh động này 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 đó 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ẻ đã xoá hiện được chọn.

Bạn nên sử dụng ảnh động chèn và xoá sau khi thực hiện đột biến tương ứng trong CardScrollAdapter. Ảnh động sẽ gọi notifyDataSetChanged() trên bộ chuyển đổi vào đúng thời điểm trong ảnh động, ngay cả khi bị bỏ qua hoặc chấm dứt 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
 

Các tham số
position của thẻ tham gia vào ảnh động
loại ảnh động kiểm soát loại ảnh động để sử dụng
Trả về
  • ảnh động có bắt đầu hay không
Đã thêm trong API cấp độ XE12

public khoảng trống hủy kích hoạt ()

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

Đã thêm trong API cấp độ XE12

public CardScrollAdapter getAdapter ()

public dài getSelectedItemId ()

Đã thêm trong API cấp độ XE12

public int getSelectedItemPosition ()

Đã thêm trong API cấp độ XE12

public Xem getSelectedView ()

Đã thêm trong API cấp độ XE12

public boolean được kích hoạt ()

public boolean isHorizontalScrollBarEnabled ()

public boolean onKeyDown (int keyCode, sự kiện KeyEvent)

public khoảng trống onWindowFocusChanged (boolean hasWindowFocus)

Đã thêm trong API cấp độ XE12

public khoảng trống setAdapter (bộ chuyển đổi ScrollScrollAdapter)

public khoảng trống setEmptyView (View emptyView)

setEmptyView(View) không được CardScrollView hỗ trợ.

Để sử dụng ảnh động và hành vi có thể chỉnh sửa phù hợp, hãy sử dụng bộ chuyển đổi có một chế độ xem trống duy nhất cho các tập dữ liệu trống.

public khoảng trống setHorizontalScrollBarEnabled (bật boolean)

Đã thêm trong API cấp độ XE12

public khoảng trống setSelection (vị trí inint)

Phương thứ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ệ khoảng trống khởi tạo thanh cuộn (TypedArray a)

Đã thêm trong API cấp độ XE12

được bảo vệ khoảng trống onLayout (boolean đã thay đổi, int top, int top, int right, int bottom)

được bảo vệ khoảng trống onVisibilityChanged (Xem thay đổi, chế độ hiển thị int)