カード ビルダー

API レベル XE21 で追加されました

CardBuilder クラスは、さまざまなレイアウトの Glass をテーマにしたカードの作成に役立ちます。

詳細とサンプルコードについては、Glass スタイルのカードを作成するをご覧ください。

一般的な使用方法

  1. CardBuilder オブジェクトを作成し、目的の CardBuilder.Layout をコンストラクタに渡します。
  2. add/set* のメソッド ファミリーを使用して、カードにコンテンツを設定します。
  3. getView() を呼び出して View を取得するか、getRemoteViews() で RemoteViews オブジェクトを取得します。

埋め込みレイアウトのリサイクルに関する注意事項

EMBED_INSIDE を使用する場合、CardBuilder によってビューをリサイクルする際に、埋め込みレイアウトが区別されなくなります。EMBED_INSIDE を持つ 2 つの CardBuilder インスタンスがあり、1 つはレイアウト A、もう 1 つはレイアウト B である場合、これらは CardBuilder によって同じものとして扱われます。

この動作が望ましくない場合（たとえば、埋め込みレイアウトが異なる CardScrollAdapter を使用している場合）、getItemViewType(int) から異なるビュータイプを返して、リサイクラーが特定のアイテムで想定されるネストされたレイアウトを含む convertView のみを送信できるように、各ビューを区別する必要があります。

組み込みレイアウトとともに複数の埋め込みレイアウトを持つカードをサポートする必要がある場合は、getViewTypeCount()、CardBuilder.getViewTypeCount() + 1 などの番号の付いたビュータイプを返すことをおすすめします。

ネストされたクラス
enum CardBuilder.Layout カードのビジュアル レイアウトを定義します。
パブリック コンストラクタ
CardBuilder（Context コンテキスト、CardBuilder.Layout レイアウト）
パブリック メソッド
CardBuilder
addImage（Drawable imageDrawable）
CardBuilder
addImage(Bitmap imageBitmap)
CardBuilder
addImage（int imageId）
void
clearImages()
int
getItemViewType()
RemoteViews
getRemoteViews()
ビュー
getView（ビュー translateView、ViewGroup 親）
ビュー
getView()
静的 int
getViewTypeCount()
CardBuilder
setAttributionIcon(Bitmap iconBitmap)
CardBuilder
setAttributionIcon（Drawable iconDrawable）
CardBuilder
setAttributionIcon(int iconId)
CardBuilder
setEmbeddedLayout（int layoutResId）
CardBuilder
setFootnote(CharSequence 脚注)
CardBuilder
setFootnote(int footnoteId)
CardBuilder
setHeading(CharSequence heading)
CardBuilder
setHeading(int headingId)
CardBuilder
setIcon(Bitmap iconBitmap)
CardBuilder
setIcon（Drawable iconDrawable）
CardBuilder
setIcon（int iconId）
CardBuilder
setSubheading(CharSequence 小見出し)
CardBuilder
setSubheading(int subheadingId)
CardBuilder
setText(int textId)
CardBuilder
setText(CharSequence テキスト)
CardBuilder
setTimestamp(CharSequence タイムスタンプ)
CardBuilder
setTimestamp(int timestampId)
CardBuilder
showStackIndicator（ブール値表示）
継承されるメソッド

パブリック コンストラクタ

API レベル XE21 で追加

public CardBuilder （Context コンテキスト、CardBuilder.Layout レイアウト）

新しい CardBuilder を構築します。

パラメータ
context ビルダーがビューを作成するために使用する 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 ビュー getView （ビューconvertView、ViewGroup親）

このカードの View 表現を返します。

アダプターと組み合わせて使用すると便利です。getView(int, View, ViewGroup)をご確認ください。

パラメータ
convertView 再利用する古いビュー（可能であれば、null も可能）。注: このビューの型が正しくない場合、このメソッドは新しいビューを作成します。
親このビューが最終的にアタッチされる（おそらく null）
API レベル XE21 で追加

public 表示 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 脚注）

カードの脚注テキストを設定します。

パラメータ
脚注 このカードの脚注テキスト
戻り値
  • 呼び出しチェーン用のこのオブジェクト
API レベル XE21 で追加

public CardBuilder setFootnote (int footnoteId)

文字列リソースを使用して、カードの脚注テキストを設定します。

パラメータ
footnoteId このカードの脚注テキスト リソース ID
戻り値
  • 呼び出しチェーン用のこのオブジェクト
API レベル XE21 で追加

public CardBuilder setHeading (CharSequence heading)

カードの見出しテキストを設定します。

パラメータ
heading このカードの見出しテキスト
戻り値
  • 呼び出しチェーン用のこのオブジェクト
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 text）

カードのメインテキストを設定します。

パラメータ
テキスト このカードのメインテキスト
戻り値
  • 呼び出しチェーン用のこのオブジェクト
API レベル XE21 で追加

public CardBuilder setTimestamp （CharSequence タイムスタンプ）

カードのタイムスタンプ テキストを設定します。

パラメータ
タイムスタンプ このカードのタイムスタンプ テキスト
戻り値
  • 呼び出しチェーン用のこのオブジェクト
API レベル XE21 で追加

public CardBuilder setTimestamp (int timestampId)

文字列リソースを使用してカードのタイムスタンプ テキストを設定します。

パラメータ
timestampId このカードのタイムスタンプ テキスト リソース ID
戻り値
  • 呼び出しチェーン用のこのオブジェクト
API レベル XE22 で追加

public CardBuilder showStackIndicator (boolean visible)

visible が true の場合、このカードが 1 枚のカードではなく積み重ねられているカードのことを表すインジケーターが表示されます。

パラメータ
表示 スタック インジケーターを表示する場合は true、非表示にする場合は false
戻り値
  • 呼び出しチェーン用のこのオブジェクト