Trình tạo thẻ

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

Lớp CardBuilder giúp xây dựng các thẻ theo chủ đề Glass với nhiều bố cục khác nhau.

Hãy xem phần Tạo thẻ kiểu Glass để biết thêm thông tin và mã mẫu.

Cách sử dụng chung

  1. Tạo đối tượng CardBuilder, truyền CardBuilder.Layout mong muốn đến hàm khởi tạo.
  2. Đặt nội dung trên thẻ bằng nhóm phương thức add/set*.
  3. Nhận View bằng cách gọi getView() hoặc nhận đối tượng RemoteViews bằng getRemoteViews().

Ghi chú về việc tái chế cho bố cục được nhúng

Khi sử dụng EMBED_INSIDE, CardBuilder không phân biệt giữa các bố cục được nhúng khi tái chế các thành phần hiển thị. Nếu bạn có hai thực thể CardBuilder có EMBED_INSIDE nhưng một thực thể có bố cục A và một thực thể có bố cục B, thì hai thực thể này sẽ được CardBuilder xử lý giống nhau.

Nếu hành vi này không mong muốn (ví dụ: khi sử dụng CardScrollAdapter với các bố cục nhúng khác nhau), bạn phải phân biệt các loại này bằng cách trả về các loại thành phần hiển thị khác với getItemViewType(int) để trình tái chế chỉ gửi cho bạn convertView các bố cục lồng nhau mà bạn mong muốn cho một mục cụ thể.

Nếu cần hỗ trợ thẻ có nhiều bố cục nhúng cùng với bố cục tích hợp sẵn, bạn nên trả về các loại thành phần hiển thị được đánh số getViewTypeCount(), CardBuilder.getViewTypeCount() + 1, v.v.

Các lớp lồng ghép
enum CardBuilder.Layout Xác định bố cục hình ảnh cho thẻ. 
Công ty xây dựng công cộng
CardBuilder(Ngữ cảnh, bố cục CardBuilder.Layout)
Phương thức công khai
CardBuilder
addImage(Drawable imageDrawable)
CardBuilder
addImage(Bitmap imageBitmap)
CardBuilder
addImage(int imageId)
void
clearImage ()
int
getItemViewType ()
RemoteViews
getRemoteViews()
Xem
getView(View conversionView, ViewGroup mẹ)
Xem
getView()
tĩnh int
getViewTypeCount()
CardBuilder
setAttributionIcon(Bitmap biểu tượngBitmap)
CardBuilder
setAttributionIcon(Biểu tượng Drawable có thể vẽ)
CardBuilder
setAttributionIcon(biểu tượng mã nhận dạng)
CardBuilder
setEmbeddedLayout(int layoutResId)
CardBuilder
setFootnote(Chú thích cuối trang CharSequence)
CardBuilder
setFootnote(int AnnotationsId)
CardBuilder
setHeader(tiêu đề CharSequence)
CardBuilder
setTiêu đề(intheadingId)
CardBuilder
setIcon(Bitmap biểu tượngBitmap)
CardBuilder
setIcon(biểu tượng có thể vẽ có thể vẽ)
CardBuilder
setIcon(int iconId)
CardBuilder
setSubheading(Tiêu đề phụ CharSequence)
CardBuilder
setSubheading(int phụId)
CardBuilder
setText(int textId)
CardBuilder
setText(văn bản CharSequence)
CardBuilder
setTimestamp(Dấu thời gian CharSequence)
CardBuilder
setTimestamp(int timestampId)
CardBuilder
showStackIndicator(hiển thị boolean)
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 độ XE21

public CardBuilder (Bối cảnh Ngữ cảnh, bố cục CardBuilder.Layout)

Xây dựng một CardBuilder mới.

Các tham số
bối cảnh Context sẽ được trình tạo sử dụng để tạo chế độ xem.
layout bố cục mong muốn cho thẻ

Phương thức công khai

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

public CardBuilder addImage (Drawable imageDrawable)

Thêm một hình ảnh, được chỉ định là Drawable vào thẻ.

Phương thức này chỉ áp dụng cho những thẻ được chuyển đổi thành chế độ xem bằng cách sử dụng getView(). RemoteViews do CardBuilder tạo chỉ hỗ trợ Bitmap và hình ảnh dựa trên tài nguyên. Drawable hình ảnh trên RemoteViews không được hỗ trợ.

Các tham số
imageDrawable Drawable hình ảnh để thêm
Trả về
  • đối tượng này để tạo chuỗi cuộc gọi
Đã thêm trong API cấp độ XE21

public CardBuilder addImage (Bitmap imageBitmap)

Thêm một hình ảnh, được chỉ định là Bitmap vào thẻ.

Các tham số
imageBitmap Bitmap hình ảnh để thêm
Trả về
  • đối tượng này để tạo chuỗi cuộc gọi
Đã thêm trong API cấp độ XE21

public CardBuilder addImage (int imageId)

Thêm một hình ảnh, được chỉ định là tài nguyên có thể vẽ vào thẻ.

Các tham số
Mã hình ảnh mã tài nguyên của hình ảnh cần thêm
Trả về
  • đối tượng này để tạo chuỗi cuộc gọi
Đã thêm trong API cấp độ XE21

public khoảng trống clearImage ()

Xóa tất cả hình ảnh đã được thêm vào thẻ trước đây.

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

public int getItemViewType ()

Trả về loại thành phần hiển thị của thẻ này.

Hữu ích khi kết hợp với bộ chuyển đổi. Vui lòng xem getItemViewType(int).

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

public RemoteViews getRemoteViews ()

Trả về RemoteViews đại diện cho thẻ này.

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

công khai Xem getView (Xem conversionView, ViewGroup mẹ)

Trả về View đại diện cho thẻ này.

Hữu ích khi kết hợp với bộ chuyển đổi. Vui lòng xem getView(int, View, ViewGroup).

Các tham số
Lượt chuyển đổi thành phần hiển thị cũ để sử dụng lại nếu có thể; có thể là null Lưu ý: nếu thành phần hiển thị này không có loại phù hợp, phương thức này sẽ tạo thành phần hiển thị mới
mẹ mà cuối cùng thành phần hiển thị này sẽ được đính kèm, có thể là null
Đã thêm trong API cấp độ XE21

public Xem getView ()

Trả về View đại diện cho thẻ này.

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

public static int getViewTypeCount ()

Trả về tổng số loại chế độ xem mà thẻ có thể lấy.

Hữu ích khi kết hợp với bộ chuyển đổi. Vui lòng xem getViewTypeCount().

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

public CardBuilder setAttributionIcon (Bitmap iconBitmap)

Đặt biểu tượng phân bổ cho thẻ bằng cách sử dụng Bitmap.

Các tham số
biểu tượngBitmap Bitmap để dùng làm biểu tượng phân bổ
Trả về
  • đối tượng này để tạo chuỗi cuộc gọi
Đã thêm trong API cấp độ XE22

public CardBuilder setAttributionIcon (icondrawable iconDrawable)

Đặt biểu tượng phân bổ cho thẻ bằng cách sử dụng Drawable.

Phương thức này chỉ áp dụng cho những thẻ được chuyển đổi thành chế độ xem bằng cách sử dụng getView(). RemoteViews do CardBuilder tạo chỉ hỗ trợ Bitmap và hình ảnh dựa trên tài nguyên. Drawable hình ảnh trên RemoteViews không được hỗ trợ.

Các tham số
biểu tượng có thể vẽ Drawable để dùng làm biểu tượng phân bổ
Trả về
  • đối tượng này để tạo chuỗi cuộc gọi
Đã thêm trong API cấp độ XE22

public CardBuilder setAttributionIcon (int iconId)

Đặt biểu tượng phân bổ cho thẻ bằng cách sử dụng tài nguyên có thể vẽ.

Các tham số
biểu tượng mã nhận dạng tài nguyên để sử dụng làm biểu tượng phân bổ
Trả về
  • đối tượng này để tạo chuỗi cuộc gọi
Đã thêm trong API cấp độ XE22

public CardBuilder setEmbeddedLayout (int layoutResId)

Đặt mã tài nguyên của bố cục để nhúng vào thẻ.

Các tham số
layoutResId mã tài nguyên của bố cục cần nhúng vào thẻ
Trả về
  • đối tượng này để tạo chuỗi cuộc gọi
Đã thêm trong API cấp độ XE21

public CardBuilder setFootnote (CharSequence chú thích)

Đặt văn bản chú thích cuối trang cho thẻ.

Các tham số
chú thích cuối trang văn bản chú thích cuối trang cho thẻ này
Trả về
  • đối tượng này để tạo chuỗi cuộc gọi
Đã thêm trong API cấp độ XE21

public CardBuilder setFootnote (int AnnotationsId)

Đặt văn bản chú thích cuối trang cho thẻ bằng cách sử dụng tài nguyên chuỗi.

Các tham số
Mã chú thích cuối trang mã tài nguyên văn bản chú thích cuối trang cho thẻ này
Trả về
  • đối tượng này để tạo chuỗi cuộc gọi
Đã thêm trong API cấp độ XE21

public CardBuilder setheading (Tiêu đề CharSequence)

Thiết lập văn bản tiêu đề cho thẻ.

Các tham số
hướng văn bản tiêu đề cho thẻ này
Trả về
  • đối tượng này để tạo chuỗi cuộc gọi
Đã thêm trong API cấp độ XE21

public CardBuilder setheading (số mã đề)

Đặt văn bản tiêu đề cho thẻ bằng cách sử dụng một tài nguyên chuỗi.

Các tham số
Mã tiêu đề mã tài nguyên văn bản tiêu đề cho thẻ này
Trả về
  • đối tượng này để tạo chuỗi cuộc gọi
Đã thêm trong API cấp độ XE21

public CardBuilder setIcon (Bitmap iconBitmap)

Đặt biểu tượng cho thẻ bằng Bitmap.

Các tham số
biểu tượngBitmap Bitmap để sử dụng làm biểu tượng
Trả về
  • đối tượng này để tạo chuỗi cuộc gọi
Đã thêm trong API cấp độ XE21

public CardBuilder setIcon (iconDrawable iconDrawable)

Đặt biểu tượng cho thẻ bằng Drawable.

Phương thức này chỉ áp dụng cho những thẻ được chuyển đổi thành chế độ xem bằng cách sử dụng getView(). RemoteViews do CardBuilder tạo chỉ hỗ trợ Bitmap và hình ảnh dựa trên tài nguyên. Drawable hình ảnh trên RemoteViews không được hỗ trợ.

Các tham số
biểu tượng có thể vẽ Drawable để sử dụng làm biểu tượng
Trả về
  • đối tượng này để tạo chuỗi cuộc gọi
Đã thêm trong API cấp độ XE21

public CardBuilder setIcon (int iconId)

Đặt biểu tượng cho thẻ bằng một tài nguyên có thể vẽ.

Các tham số
biểu tượng mã nhận dạng tài nguyên để sử dụng làm biểu tượng
Trả về
  • đối tượng này để tạo chuỗi cuộc gọi
Đã thêm trong API cấp độ XE21

public CardBuilder setSubheading (Phân nhóm phụ)

Đặt văn bản phụ cho thẻ.

Các tham số
tiêu đề phụ văn bản tiêu đề phụ cho thẻ này
Trả về
  • đối tượng này để tạo chuỗi cuộc gọi
Đã thêm trong API cấp độ XE21

public CardBuilder setSubheading (int phụId)

Đặt văn bản phụ cho thẻ bằng cách sử dụng tài nguyên chuỗi.

Các tham số
Mã nhóm phụ mã tài nguyên văn bản của tiêu đề phụ cho thẻ này
Trả về
  • đối tượng này để tạo chuỗi cuộc gọi
Đã thêm trong API cấp độ XE21

public CardBuilder setText (int textId)

Đặt văn bản chính cho thẻ bằng một tài nguyên chuỗi.

Các tham số
Mã văn bản mã tài nguyên văn bản chính cho thẻ này
Trả về
  • đối tượng này để tạo chuỗi cuộc gọi
Đã thêm trong API cấp độ XE21

public CardBuilder setText (CharSequence văn bản)

Đặt văn bản chính cho thẻ.

Các tham số
văn bản văn bản chính cho thẻ này
Trả về
  • đối tượng này để tạo chuỗi cuộc gọi
Đã thêm trong API cấp độ XE21

public CardBuilder setTimestamp (CharSequence dấu thời gian)

Đặt văn bản dấu thời gian cho thẻ.

Các tham số
timestamp văn bản dấu thời gian cho thẻ này
Trả về
  • đối tượng này để tạo chuỗi cuộc gọi
Đã thêm trong API cấp độ XE21

public CardBuilder setTimestamp (int timestampId)

Đặt văn bản dấu thời gian cho thẻ bằng tài nguyên chuỗi.

Các tham số
Mã dấu thời gian mã tài nguyên văn bản về dấu thời gian cho thẻ này
Trả về
  • đối tượng này để tạo chuỗi cuộc gọi
Đã thêm trong API cấp độ XE22

public CardBuilder showStackIndicator (boolean hiển thị)

Hiển thị chỉ báo nếu visible đúng là thẻ này đại diện cho một ngăn xếp thẻ, thay vì một thẻ.

Các tham số
hiển thị true để hiển thị chỉ báo ngăn xếp, hoặc false để ẩn chỉ báo
Trả về
  • đối tượng này để tạo chuỗi cuộc gọi