卡片建構工具

已新增至 API 級別 XE21

CardBuilder 類別可協助您建構具有各種版面配置的玻璃主題卡片。

如需詳細資訊及程式碼範例，請參閱「建立玻璃樣式卡片」。

一般使用情況

  1. 建立 CardBuilder 物件，將所需的 CardBuilder.Layout 傳遞至建構函式。
  2. 使用 add/set* 方法系列設定資訊卡內容。
  3. 呼叫 getView() 以取得 View，或使用 getRemoteViews() 取得 RemoteViews 物件。

嵌入版面配置的回收附註

使用 EMBED_INSIDE CardBuilder 時，系統不會在回收檢視畫面時區分不同的內嵌版面配置。如果您有兩個具備 EMBED_INSIDE 的 CardBuilder 執行個體，但其中一個有版面配置 A，另一個則採用版面配置 B，則 CardBuilder 會視為相同。

如果不適合這個行為 (例如搭配不同嵌入版面配置使用 CardScrollAdapter)，您必須透過傳回 getItemViewType(int) 的不同檢視類型來區分這些行為，讓回收器只會傳送含有您希望特定項目巢狀版面配置的 convertView。

如果您需要支援包含多種內嵌版面配置的資訊卡和內建版面配置，建議您傳回編號為 getViewTypeCount()、CardBuilder.getViewTypeCount() + 1 等的檢視畫面類型。

巢狀類別
列舉 CardBuilder.Layout 定義資訊卡的視覺版面配置。
公用建構函式
CardBuilder(情境內容、CardBuilder.Layout 版面配置)
公用方法
CardBuilder
addImage(Drawable imageDrawable)
CardBuilder
addImage(點陣圖 imageBitmap)
CardBuilder
addImage(int imageId)
void
clearImages()
int
getItemViewType()
RemoteViews
getRemoteViews()
查看
getView(View transformView、ViewGroup 父項)
查看
getView()
static int
getViewTypeCount()
CardBuilder
setAttributionIcon(點陣圖 iconBitmap)
CardBuilder
setAttributionIcon(Drawable iconDrawable)
CardBuilder
setAttributionIcon(int iconId)
CardBuilder
setEmbeddedLayout(int layoutResId)
CardBuilder
setFootnote(CharSequence 註腳)
CardBuilder
setFootnote(int footnoteId)
CardBuilder
setHeading(「CharSequence」CharSequence標題)
CardBuilder
setHeading(int headingId)
CardBuilder
setIcon(點陣圖 iconBitmap)
CardBuilder
setIcon(「Drawable」iconDrawable)
CardBuilder
setIcon(int iconId)
CardBuilder
setSubheading(「CharSequence」CharSequence子標題)
CardBuilder
setSubheading(int subheadingId)
CardBuilder
setText(int textId)
CardBuilder
setText(CharSequence文字)
CardBuilder
setTimestamp(CharSequence 時間戳記)
CardBuilder
setTimestamp(int timestampId)
CardBuilder
showStackIndicator(顯示布林值)
繼承的方法

公用建構函式

已新增至 API 級別 XE21

公開 CardBuilder (Context 內容，CardBuilder.Layout 版面配置)

建構新的 CardBuilder。

參數
背景資訊建構工具會使用 Context 建立檢視畫面。
版面配置 所需的資訊卡版面配置

公用方法

已新增至 API 級別 XE21

public CardBuilder addImage (Drawable imageDrawable)

將以 Drawable 指定的圖片新增至資訊卡。

這個方法僅適用於使用 getView() 轉換為檢視畫面的資訊卡。CardBuilder 建構的 RemoteViews 僅支援 Bitmap 和以資源為基礎的映像檔。RemoteViews 不支援 Drawable 張圖片。

參數
imageDrawable 要新增的 Drawable 圖片
傳回
  • 這個物件用於呼叫鏈結
已新增至 API 級別 XE21

public CardBuilder addImage (Bitmap imageBitmap)

將以 Bitmap 指定的圖片新增至資訊卡。

參數
imageBitmap 要新增的 Bitmap 圖片
傳回
  • 這個物件用於呼叫鏈結
已新增至 API 級別 XE21

public CardBuilder addImage (int imageId)

將圖片指定為可繪製資源至資訊卡。

參數
imageId 待新增映像檔的資源 ID
傳回
  • 這個物件用於呼叫鏈結
已新增至 API 級別 XE21

public void clearImages ()

清除先前新增至資訊卡的所有圖片。

已新增至 API 級別 XE21

public int getItemViewType ()

傳回這張特定資訊卡的檢視畫面類型。

可搭配轉接器使用。詳情請參閱 getItemViewType(int)。

已新增至 API 級別 XE21

public RemoteViews getRemoteViews ()

傳回此卡片的 RemoteViews 表示法。

已新增至 API 級別 XE21

public View getView (View transformView，ViewGroup 父項)

傳回這張資訊卡的 View 表示法。

可搭配轉接器使用。查看《getView(int, View, ViewGroup)》。

參數
convertView 舊檢視畫面以重複使用 (可能的話)；可以是 null 注意：如果這個檢視區塊的類型不正確，這個方法會建立新的檢視表
父項 這個檢視畫面最後會附加至，可能是 null
已新增至 API 級別 XE21

public View getView ()

傳回此卡片的 View 表示法。

已新增至 API 級別 XE21

public static int getViewTypeCount ()

傳回資訊卡可顯示的檢視畫面類型總數。

可搭配轉接器使用。詳情請參閱 getViewTypeCount()。

已新增至 API 級別 XE22

public CardBuilder setAttributionIcon (Bitmap iconBitmap)

使用 Bitmap 設定資訊卡的屬性圖示。

參數
iconBitmap 要做為歸因圖示的 Bitmap
傳回
  • 這個物件用於呼叫鏈結
已新增至 API 級別 XE22

public CardBuilder setAttributionIcon (Drawable iconDrawable)

使用 Drawable 設定資訊卡的屬性圖示。

這個方法僅適用於使用 getView() 轉換為檢視畫面的資訊卡。CardBuilder 建構的 RemoteViews 僅支援 Bitmap 和以資源為基礎的映像檔。RemoteViews 不支援 Drawable 張圖片。

參數
iconDrawable 要做為歸因圖示的 Drawable
傳回
  • 這個物件用於呼叫鏈結
已新增至 API 級別 XE22

public CardBuilder setAttributionIcon (int iconId)

使用可繪製資源設定資訊卡的歸因圖示。

參數
iconId 要當做歸因圖示的資源 ID
傳回
  • 這個物件用於呼叫鏈結
已新增至 API 級別 XE22

public CardBuilder setEmbeddedLayout (int layoutResId)

設定要嵌入資訊卡的版面配置資源 ID。

參數
layoutResId 要嵌入資訊卡的版面配置資源 ID
傳回
  • 這個物件用於呼叫鏈結
已新增至 API 級別 XE21

public CardBuilder setFootnote (CharSequence footnote)

設定資訊卡的註腳文字。

參數
footnote (註腳)這張資訊卡的註腳文字
傳回
  • 這個物件用於呼叫鏈結
已新增至 API 級別 XE21

public CardBuilder setFootnote (int footnoteId)

使用字串資源設定資訊卡的註腳文字。

參數
footnoteId 這張資訊卡的註腳文字資源 ID
傳回
  • 這個物件用於呼叫鏈結
已新增至 API 級別 XE21

public CardBuilder setHeading (CharSequence 標題)

設定資訊卡的標題文字。

參數
標題 這張資訊卡的標題文字
傳回
  • 這個物件用於呼叫鏈結
已新增至 API 級別 XE21

public CardBuilder setHeading (int headingId)

使用字串資源設定資訊卡的標題文字。

參數
headingId 這張資訊卡的標題文字資源 ID
傳回
  • 這個物件用於呼叫鏈結
已新增至 API 級別 XE21

public CardBuilder setIcon (Bitmap iconBitmap)

使用 Bitmap 設定卡片圖示。

參數
iconBitmap 要做為圖示的 Bitmap
傳回
  • 這個物件用於呼叫鏈結
已新增至 API 級別 XE21

public CardBuilder setIcon (Drawable iconDrawable)

使用 Drawable 設定卡片圖示。

這個方法僅適用於使用 getView() 轉換為檢視畫面的資訊卡。CardBuilder 建構的 RemoteViews 僅支援 Bitmap 和以資源為基礎的映像檔。RemoteViews 不支援 Drawable 張圖片。

參數
iconDrawable 要做為圖示的 Drawable
傳回
  • 這個物件用於呼叫鏈結
已新增至 API 級別 XE21

public CardBuilder setIcon (int iconId)

使用可繪製資源設定資訊卡的圖示。

參數
iconId 要當做圖示的資源 ID
傳回
  • 這個物件用於呼叫鏈結
已新增至 API 級別 XE21

public CardBuilder setSubheading (CharSequence 子標題)

設定資訊卡的子標題文字。

參數
子標題 這張資訊卡的子標題文字
傳回
  • 這個物件用於呼叫鏈結
已新增至 API 級別 XE21

public CardBuilder setSubheading (int subheadingId)

使用字串資源設定資訊卡的子標題文字。

參數
subheadingId 這張資訊卡的子標題文字資源 ID
傳回
  • 這個物件用於呼叫鏈結
已新增至 API 級別 XE21

public CardBuilder setText (int textId)

使用字串資源設定資訊卡的主要文字。

參數
textId 這張資訊卡的主要文字資源 ID
傳回
  • 這個物件用於呼叫鏈結
已新增至 API 級別 XE21

public CardBuilder setText (CharSequence 文字)

設定資訊卡的主要文字。

參數
文字這張資訊卡的主要文字
傳回
  • 這個物件用於呼叫鏈結
已新增至 API 級別 XE21

public CardBuilder setTimestamp (CharSequence timestamp)

設定資訊卡的時間戳記文字。

參數
timestamp 這張資訊卡的時間戳記文字
傳回
  • 這個物件用於呼叫鏈結
已新增至 API 級別 XE21

public CardBuilder setTimestamp (int timestampId)

使用字串資源設定資訊卡的時間戳記文字。

參數
timestampId 這張資訊卡的時間戳記文字資源 ID
傳回
  • 這個物件用於呼叫鏈結
已新增至 API 級別 XE22

public CardBuilder showStackIndicator (boolean visible)

如果 visible 是，表示這張資訊卡代表的是一疊資訊卡，而非單一資訊卡，則顯示指標。

參數
顯示 true 以顯示堆疊指標，設為 false 則會隱藏堆疊
傳回
  • 這個物件用於呼叫鏈結