CardBuilder

已新增至 API 等級 XE21

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

如需詳細資訊和程式碼範例，請參閱建立 Glass 樣式的資訊卡。

一般使用情況

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

內嵌版面配置的回收注意事項

使用 EMBED_INSIDE CardBuilder 時，可區分不同的回收版面配置。如果您有多個 CardBuilder 個包含 EMBED_INSIDE 的執行個體，但另一個具有版面配置 A，另一個具有版面配置 B，則 CardBuilder 會將這些執行個體視為相同。

如果這不符合預期情況 (例如，搭配不同嵌入式版面配置使用 CardScrollAdapter 時)，您必須先從 getItemViewType(int) 傳回不同的檢視畫面類型以將其區分，這樣回收器才會將 convertView 傳送給您，為您提供特定項目的巢狀版面配置。

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

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

公用建構函式

已新增至 API 等級 XE21

public CardBuilder(Context 結構定義、CardBuilder.Layout 版面配置)

建構新的 CardBuilder。

參數
內容 建構工具將用來建立其檢視畫面的 Context。
版面配置所需的卡片版面配置

公用方法

已新增至 API 等級 XE21

public CardBuilder addImage (可繪項目 imageDrawable)

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

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

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

public CardBuilder addImage (點陣圖 imageBitmap)

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

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

public CardBuilderaddImage(int imageId)

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

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

公開 void clearImages ()

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

已新增至 API 等級 XE21

public getItemViewType()

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

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

已新增至 API 等級 XE21

public 遠端檢視getRemoteViews()

傳回此卡片的 RemoteViews 表示法。

已新增至 API 等級 XE21

public 查看 getView (View conversionView, ViewGroup 父項)

傳回此卡片的 View 表示法。

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

參數
轉換瀏覽 可重複使用的舊檢視 (如果可以的話)；可以是 null 注意：如果這個檢視畫面沒有正確類型，這個方法就會建立新的檢視畫面
父項 該檢視畫面最終會附加，或是null
已新增至 API 等級 XE21

公開 查看 getView ()

傳回此卡片的 View 表示法。

已新增至 API 等級 XE21

public static int getViewTypeCount ()

傳回資訊卡可使用的檢視類型總數。

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

已新增至 API 等級 XE22

public CardBuilder setAttributionIcon (點陣圖 iconBitmap)

使用 Bitmap 設定卡片的歸屬圖示。

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

public CardBuilder setAttributionIcon (可繪項目 iconDrawable)

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

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

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

public CardBuilder setAttributionIcon (int iconId)

使用可繪項目資源設定卡片的歸屬圖示。

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

public CardBuildersetEmbeddedLayout(int layoutResId)

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

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

public CardBuilder setFootnote (CharSequence註腳)

設定卡片的註腳文字。

參數
註腳 這張卡片的註腳文字
傳回
  • 這個物件用於呼叫鏈結
已新增至 API 等級 XE21

publicCardBuildersetFootnote(int footnoteId)

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

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

public CardBuilder setHeading (CharSequence 標題)

設定卡片的標題文字。

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

public CardBuildersetHeading(int headingId)

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

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

public CardBuilder setIcon (點陣圖 iconBitmap)

使用 Bitmap 設定卡片的圖示。

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

public CardBuilder setIcon (可繪項目 iconDrawable)

使用 Drawable 設定卡片的圖示。

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

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

public CardBuildersetIcon(int iconId)

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

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

public CardBuilder setSubheading (CharSequence 子標題)

設定卡片的子標題文字。

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

public CardBuildersetSubheading(int subheadingId)

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

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

public CardBuildersetText(int textId)

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

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

public CardBuilder setText (CharSequence 文字)

設定卡片的主要文字。

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

public CardBuilder setTimestamp (CharSequence 時間戳記)

設定卡片的時間戳記文字。

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

publicCardBuildersetTimestamp(int timestampId)

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

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

public CardBuildershowStackIndicator(顯示布林值)

如果 visible 為 true，代表此卡片代表一疊卡片，而非單張卡片。

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