CardBuilder

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

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

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

一般的な使用方法

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

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

EMBED_INSIDE を使用する場合、CardBuilder は、ビューのリサイクル時に埋め込みレイアウトを区別しません。EMBED_INSIDE の CardBuilder インスタンスが 2 つあり、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（ViewconvertView、ViewGroup 親）
表示	getView()
static 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 見出し）
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（ブール値を表示）

継承されるメソッド
クラス java.lang.Object オブジェクト clone() ブール値 equals(Object arg0) void finalize() を実行します。 最終 クラス<?> getClass() int hashCode() 最終 void notify() 最終 void notifyAll() 文字列 toString() 最終 void wait() 最終 void wait(long arg0, int arg1) 最終 void wait（long arg0）

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

API レベル XE21 で追加

public CardBuilder （コンテキスト コンテキスト、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 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 （ViewconvertView、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 （ビットマップ 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）

ドローアブル リソースを使用してカードのアトリビューション アイコンを設定します。

パラメータ

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 見出し）

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

パラメータ

見出し	このカードのヘッダー

戻り値

• このオブジェクトはコール チェーン用です。

API レベル XE21 で追加

public CardBuilder setHeading （int headingId）

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

パラメータ

headingId	このカードのヘッダーテキスト リソース ID

戻り値

• このオブジェクトはコール チェーン用です。

API レベル XE21 で追加

public CardBuilder setIcon （ビットマップ 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 タイムスタンプ）

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

パラメータ

タイムスタンプ	このカードのタイムスタンプ テキスト

戻り値

• このオブジェクトはコール チェーン用です。

API レベル XE21 で追加

public CardBuilder setTimestamp (int timestampId)

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

パラメータ

timestampId	このカードのタイムスタンプ テキスト リソース ID

戻り値

• このオブジェクトはコール チェーン用です。

API レベル XE22 で追加

public CardBuilder showStackIndicator （ブール値の表示）

visible が true の場合、そのカードが 1 つのカードではなくカードのスタックを表すことを示します。

パラメータ

表示	スタック インジケーターを表示する場合は true、非表示にする場合は false。

戻り値

• このオブジェクトはコール チェーン用です。