CardBuilder

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

Lớp CardBuilder giúp tạo thẻ theo chủ đề Glass với nhiều bố cục.

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

Cách sử dụng chung

  1. Tạo một đố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. Lấy View bằng cách gọi getView() hoặc lấy đối tượng RemoteViews bằng getRemoteViews().

Ghi chú tái chế cho bố cục nhúng

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

Nếu hành vi này không được mong muốn (ví dụ: khi sử dụng CardScrollAdapter với nhiều bố cục nhúng), bạn phải phân biệt chúng bằng cách trả về nhiều kiểu khung hiển thị từ getItemViewType(int) để trình tái chế chỉ gửi cho bạn các convertView 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ợ các thẻ có nhiều bố cục nhúng cùng với các bố cục tích hợp sẵn, bạn nên trả về các kiểu thành phần hiển thị được đánh số getViewTypeCount(), CardBuilder.getViewTypeCount() + 1, v.v.

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 Ngữ cảnh, bố cục CardBuilder.Layout)
Phương thức công khai
CardBuilder
addImage(hình ảnh có thể vẽ)
CardBuilder
addImage(Bitmap imageBitmap)
CardBuilder
addImage(int imageId)
void
clearImages()
int
Phương thức getItemViewType()
RemoteViews
getRemoteViews()
Chế độ xem
getView(View ConvertView, ViewGroup mẹ)
Chế độ xem
getView()
int tĩnh
Hàm getViewTypeCount()
CardBuilder
setAttributionIcon(Bitmap iconBitmap)
CardBuilder
setAttributionIcon(biểu tượng Đối tượng có thể vẽ)
CardBuilder
setAttributionIcon(int iconId)
CardBuilder
setEmbeddedLayout(int layoutResId)
CardBuilder
setFootnote(chú thích cuối trang CharSequence)
CardBuilder
setFootnote(int footnoteId)
CardBuilder
setHeading(tiêu đề CharSequence)
CardBuilder
setHeading(int headerId)
CardBuilder
setIcon(Bitmap iconBitmap)
CardBuilder
setIcon(Biểu tượng có thể vẽ)
CardBuilder
setIcon(int iconId)
CardBuilder
setSubheading(tiêu đề phụ CharSequence)
CardBuilder
setSubheading(int subheadingId)
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(boolean hiển thị)
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 XE21

công khai CardBuilder (Ngữ cảnh, bố cục CardBuilder.Layout)

Tạo CardBuilder mới.

Thông số
bối cảnh Context mà trình tạo sẽ sử dụng để tạo khung hiển thị.
bố cục bố cục mong muốn cho thẻ

Phương thức công khai

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

công khai CardBuilder addImage (Hình ảnh có thể vẽ có thể vẽ)

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. Không hỗ trợ Drawable hình ảnh trên RemoteViews.

Thông số
imageDrawable Drawable hình ảnh cần thêm
Giá trị trả về
  • đối tượng này để tạo chuỗi lệnh gọi
Đã thêm vào API cấp XE21

công khai CardBuilder addImage (Bitmap imageBitmap)

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

Thông số
imageBitmap Bitmap hình ảnh cần thêm
Giá trị trả về
  • đối tượng này để tạo chuỗi lệnh gọi
Đã thêm vào API cấp XE21

Public CardBuilder addImage (int imageId)

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

Thông số
imageId mã nhận dạng tài nguyên của hình ảnh cần thêm
Giá trị trả về
  • đối tượng này để tạo chuỗi lệnh gọi
Đã thêm vào API cấp XE21

công khai khoảng trống clearImages ()

Xoá tất cả hình ảnh đã được thêm vào thẻ trước đó.

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

Public int getItemViewType ()

Trả về loại chế độ xem của thẻ cụ 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 vào API cấp XE21

Public RemoteViews getRemoteViews ()

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

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

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

Trả về View đại diện của 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).

Thông số
convertView một khung hiển thị cũ để sử dụng lại (nếu có thể) có thể là null Lưu ý: nếu khung hiển thị này không có kiểu phù hợp, thì phương thức này sẽ tạo một khung hiển thị mới
parent mà cuối cùng chế độ xem này sẽ được đính kèm vào, có thể là null
Đã thêm vào API cấp XE21

Public View getView ()

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

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

công khai tĩnh int getViewTypeCount ()

Trả về tổng số loại chế độ xem thẻ có thể sử dụng.

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

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

công khai CardBuilder setAttributionIcon (Bitmap iconBitmap)

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

Thông số
iconBitmap Bitmap để dùng làm biểu tượng phân bổ
Giá trị trả về
  • đối tượng này để tạo chuỗi lệnh gọi
Đã thêm vào API cấp XE22

công khai CardBuilder setAttributionIcon (Drawable biểu tượngDrawable)

Đặ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. Không hỗ trợ Drawable hình ảnh trên RemoteViews.

Thông số
iconDrawable Drawable để dùng làm biểu tượng phân bổ
Giá trị trả về
  • đối tượng này để tạo chuỗi lệnh gọi
Đã thêm vào API cấp XE22

công khai CardBuilder setAttributionIcon (int iconId)

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

Thông số
iconId mã nhận dạng tài nguyên để dùng làm biểu tượng phân bổ
Giá trị trả về
  • đối tượng này để tạo chuỗi lệnh gọi
Đã thêm vào API cấp XE22

công khai CardBuilder setEmbeddedLayout (int layoutResId)

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

Thông số
layoutResId mã nhận dạng tài nguyên của bố cục để nhúng vào thẻ
Giá trị trả về
  • đối tượng này để tạo chuỗi lệnh gọi
Đã thêm vào API cấp XE21

công khai CardBuilder setFootnote (chú thích cuối trang CharSequence)

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

Thông số
chú thích cuối trang văn bản chú thích cuối trang cho thẻ này
Giá trị trả về
  • đối tượng này để tạo chuỗi lệnh gọi
Đã thêm vào API cấp XE21

Public CardBuilder setFootnote (int footnoteId)

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

Thông số
footnoteId mã tài nguyên văn bản ở chú thích cuối trang cho thẻ này
Giá trị trả về
  • đối tượng này để tạo chuỗi lệnh gọi
Đã thêm vào API cấp XE21

công khai CardBuilder setHeading (tiêu đề CharSequence)

Đặt văn bản tiêu đề cho thẻ.

Thông số
hướng văn bản tiêu đề cho thẻ này
Giá trị trả về
  • đối tượng này để tạo chuỗi lệnh gọi
Đã thêm vào API cấp XE21

Public CardBuilder setHeading (int headerId)

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

Thông số
headingId mã tài nguyên văn bản tiêu đề của thẻ này
Giá trị trả về
  • đối tượng này để tạo chuỗi lệnh gọi
Đã thêm vào API cấp XE21

công khai CardBuilder setIcon (Bitmap iconBitmap)

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

Thông số
iconBitmap Bitmap để dùng làm biểu tượng
Giá trị trả về
  • đối tượng này để tạo chuỗi lệnh gọi
Đã thêm vào API cấp XE21

công khai CardBuilder setIcon (Biểu tượng có thể vẽ)

Đặ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. Không hỗ trợ Drawable hình ảnh trên RemoteViews.

Thông số
iconDrawable Drawable để dùng làm biểu tượng
Giá trị trả về
  • đối tượng này để tạo chuỗi lệnh gọi
Đã thêm vào API cấp XE21

công khai CardBuilder setIcon (int iconId)

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

Thông số
iconId mã nhận dạng tài nguyên để dùng làm biểu tượng
Giá trị trả về
  • đối tượng này để tạo chuỗi lệnh gọi
Đã thêm vào API cấp XE21

công khai CardBuilder setSubheading (tiêu đề phụ của CharSequence)

Đặt văn bản tiêu đề phụ cho thẻ.

Thông số
tiêu đề phụ văn bản tiêu đề phụ cho thẻ này
Giá trị trả về
  • đối tượng này để tạo chuỗi lệnh gọi
Đã thêm vào API cấp XE21

Public CardBuilder setSubheading (int subheadingId)

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

Thông số
subheadingId mã tài nguyên văn bản của tiêu đề phụ cho thẻ này
Giá trị trả về
  • đối tượng này để tạo chuỗi lệnh gọi
Đã thêm vào API cấp XE21

Public CardBuilder setText (int textId)

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

Thông số
textId mã tài nguyên văn bản chính của thẻ này
Giá trị trả về
  • đối tượng này để tạo chuỗi lệnh gọi
Đã thêm vào API cấp XE21

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

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

Thông số
văn bản văn bản chính cho thẻ này
Giá trị trả về
  • đối tượng này để tạo chuỗi lệnh gọi
Đã thêm vào API cấp XE21

công khai CardBuilder setTimestamp (CharSequence dấu thời gian)

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

Thông số
timestamp văn bản dấu thời gian cho thẻ này
Giá trị trả về
  • đối tượng này để tạo chuỗi lệnh gọi
Đã thêm vào API cấp XE21

Public CardBuilder setTimestamp (int timestampId)

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

Thông số
timestampId mã tài nguyên văn bản có dấu thời gian của thẻ này
Giá trị trả về
  • đối tượng này để tạo chuỗi lệnh gọi
Đã thêm vào API cấp XE22

công khai CardBuilder showStackIndicator (boolean visible)

Hiện chỉ báo nếu visible đúng là thẻ này đại diện cho một ngăn xếp thẻ, chứ không phải là một thẻ.

Thông số
hiển thị true để hiện chỉ báo ngăn xếp hoặc false để ẩn chỉ báo ngăn xếp
Giá trị trả về
  • đối tượng này để tạo chuỗi lệnh gọi