카드 빌더

API 수준 XE21에 추가되었습니다.

CardBuilder 클래스는 다양한 레이아웃으로 Glass 테마 카드를 빌드하는 데 도움이 됩니다.

자세한 내용과 샘플 코드는 Glass 스타일 카드 만들기를 참고하세요.

일반 사용법

1. CardBuilder 객체를 만들어 원하는 CardBuilder.Layout를 생성자에 전달합니다.
2. add/set* 메서드 계열을 사용하여 카드의 콘텐츠를 설정합니다.
3. getView()를 호출하여 View를 가져오거나 getRemoteViews()로 RemoteViews 객체를 가져옵니다.

삽입된 레이아웃에 대한 재활용 참고사항

EMBED_INSIDE를 사용할 때 CardBuilder는 뷰를 재활용할 때 여러 삽입된 레이아웃을 구별하지 않습니다. EMBED_INSIDE가 있는 두 개의 CardBuilder 인스턴스가 있지만 하나에는 레이아웃 A가 있고 다른 하나에는 레이아웃 B가 있다면 이 인스턴스는 CardBuilder에서 동일한 것으로 취급됩니다.

이 동작이 바람직하지 않은 경우 (예: 삽입된 레이아웃이 다른 CardScrollAdapter를 사용하는 경우) recycler가 특정 항목에 관해 예상되는 중첩된 레이아웃이 있는 convertView만 전송하도록 getItemViewType(int)에서 다른 뷰 유형을 반환하여 이를 구별해야 합니다.

기본 제공 레이아웃과 함께 여러 삽입 레이아웃이 있는 카드를 지원해야 하는 경우 getViewTypeCount(), CardBuilder.getViewTypeCount() + 1 등으로 번호가 매겨진 뷰 유형을 반환하는 것이 좋습니다.

중첩된 클래스
enum	CardBuilder.Layout		카드의 시각적 레이아웃을 정의합니다.

공개 생성자
	CardBuilder(컨텍스트 컨텍스트, CardBuilder.Layout 레이아웃)

공개 메서드
CardBuilder	addImage(Drawable imageDrawable)
CardBuilder	addImage(Bitmap imageBitmap)
CardBuilder	addImage(int imageId)
void	clearImages()
int	getItemViewType()
RemoteViews	getRemoteViews()
View	getView(View conversionView, ViewGroup 상위)
View	getView()
정적 정수	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() boolean 같음(객체 arg0) void finalize() Final Class<?> getClass() int hashCode() 최종 void notify() 최종 void notifyAll() String toString() 최종 void wait() 최종 void wait(long arg0, int arg1) 최종 void wait(long arg0)

공개 생성자

API 수준 XE21에 추가되었습니다.

공개 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에 추가되었습니다.

공개 CardBuilder addImage (Bitmap imageBitmap)

Bitmap로 지정된 이미지를 카드에 추가합니다.

매개변수

imageBitmap	추가할 Bitmap 이미지

반환 값

• 호출 체이닝을 위한 이 객체

API 수준 XE21에 추가되었습니다.

공개 CardBuilder addImage (int imageId)

드로어블 리소스로 지정된 이미지를 카드에 추가합니다.

매개변수

imageId	추가할 이미지의 리소스 ID

반환 값

• 호출 체이닝을 위한 이 객체

API 수준 XE21에 추가되었습니다.

public void clearImages ()

이전에 카드에 추가된 이미지를 모두 지웁니다.

API 수준 XE21에 추가되었습니다.

public int getItemViewType ()

이 특정 카드의 뷰 유형을 반환합니다.

어댑터와 함께 사용하면 유용합니다. getItemViewType(int) 페이지를 참고하세요.

API 수준 XE21에 추가되었습니다.

공개 RemoteViews getRemoteViews ()

이 카드의 RemoteViews 표현을 반환합니다.

API 수준 XE21에 추가되었습니다.

공개 보기 getView (보기 switchView, ViewGroup 상위)

이 카드의 View 표현을 반환합니다.

어댑터와 함께 사용하면 유용합니다. getView(int, View, ViewGroup) 페이지를 참고하세요.

매개변수

convertView	가능한 경우 재사용할 기존 뷰. null일 수 있음. 참고: 이 뷰에 올바른 유형이 없으면 이 메서드는 새 뷰를 만듭니다.
parent	결국 이 뷰가 연결되는 항목(예: null)

API 수준 XE21에 추가되었습니다.

공개 보기 getView ()

이 카드의 View 표현을 반환합니다.

API 수준 XE21에 추가되었습니다.

public static int getViewTypeCount ()

카드에서 취할 수 있는 총 보기 유형 수를 반환합니다.

어댑터와 함께 사용하면 유용합니다. getViewTypeCount() 페이지를 참고하세요.

API 수준 XE22에 추가되었습니다.

공개 CardBuilder setAttributionIcon (Bitmap iconBitmap)

Bitmap를 사용하여 카드의 저작자 표시 아이콘을 설정합니다.

매개변수

iconBitmap	기여 분석 아이콘으로 사용할 Bitmap

반환 값

• 호출 체이닝을 위한 이 객체

API 수준 XE22에 추가되었습니다.

공개 CardBuilder setAttributionIcon (Drawable iconDrawable)

Drawable를 사용하여 카드의 저작자 표시 아이콘을 설정합니다.

이 메서드는 getView()를 사용하여 뷰로 변환된 카드에만 적용됩니다. CardBuilder로 빌드된 RemoteViews는 Bitmap 및 리소스 기반 이미지만 지원합니다. RemoteViews에서 Drawable 이미지는 지원되지 않습니다.

매개변수

iconDrawable	기여 분석 아이콘으로 사용할 Drawable

반환 값

• 호출 체이닝을 위한 이 객체

API 수준 XE22에 추가되었습니다.

공개 CardBuilder setAttributionIcon (int iconId)

드로어블 리소스를 사용하여 카드의 저작자 표시 아이콘을 설정합니다.

매개변수

iconId	저작자 표시 아이콘으로 사용할 리소스 ID입니다.

반환 값

• 호출 체이닝을 위한 이 객체

API 수준 XE22에 추가되었습니다.

공개 CardBuilder setEmbeddedLayout (int layoutResId)

카드에 삽입할 레이아웃의 리소스 ID를 설정합니다.

매개변수

layoutResId	카드에 삽입할 레이아웃의 리소스 ID

반환 값

• 호출 체이닝을 위한 이 객체

API 수준 XE21에 추가되었습니다.

공개 CardBuilder setFootnote (CharSequence 각주)

카드의 각주 텍스트를 설정합니다.

매개변수

각주	이 카드의 각주 텍스트

반환 값

• 호출 체이닝을 위한 이 객체

API 수준 XE21에 추가되었습니다.

공개 CardBuilder setFootnote (int footnoteId)

문자열 리소스를 사용하여 카드의 각주 텍스트를 설정합니다.

매개변수

footnoteId	이 카드의 각주 텍스트 리소스 ID

반환 값

• 호출 체이닝을 위한 이 객체

API 수준 XE21에 추가되었습니다.

공개 CardBuilder setHeading (CharSequence 제목)

카드의 제목 텍스트를 설정합니다.

매개변수

방향	이 카드의 제목 텍스트

반환 값

• 호출 체이닝을 위한 이 객체

API 수준 XE21에 추가되었습니다.

공개 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에 추가되었습니다.

공개 CardBuilder setIcon (int iconId)

드로어블 리소스를 사용하여 카드의 아이콘을 설정합니다.

매개변수

iconId	아이콘으로 사용할 리소스 ID

반환 값

• 호출 체이닝을 위한 이 객체

API 수준 XE21에 추가되었습니다.

공개 CardBuilder setSubheading (CharSequence 부제목)

카드의 부제목 텍스트를 설정합니다.

매개변수

부제목	이 카드의 부제목 텍스트

반환 값

• 호출 체이닝을 위한 이 객체

API 수준 XE21에 추가되었습니다.

공개 CardBuilder setSubheading (int subheadingId)

문자열 리소스를 사용하여 카드의 부제목 텍스트를 설정합니다.

매개변수

subheadingId	이 카드의 부제목 텍스트 리소스 ID

반환 값

• 호출 체이닝을 위한 이 객체

API 수준 XE21에 추가되었습니다.

공개 CardBuilder setText (int textId)

문자열 리소스를 사용하여 카드의 기본 텍스트를 설정합니다.

매개변수

textId	이 카드의 기본 텍스트 리소스 ID

반환 값

• 호출 체이닝을 위한 이 객체

API 수준 XE21에 추가되었습니다.

공개 CardBuilder setText (CharSequence 텍스트)

카드의 기본 텍스트를 설정합니다.

매개변수

text	이 카드의 기본 텍스트

반환 값

• 호출 체이닝을 위한 이 객체

API 수준 XE21에 추가되었습니다.

공개 CardBuilder setTimestamp (CharSequence 타임스탬프)

카드의 타임스탬프 텍스트를 설정합니다.

매개변수

타임스탬프	이 카드의 타임스탬프 텍스트

반환 값

• 호출 체이닝을 위한 이 객체

API 수준 XE21에 추가되었습니다.

공개 CardBuilder setTimestamp (int timestampId)

문자열 리소스를 사용하여 카드의 타임스탬프 텍스트를 설정합니다.

매개변수

timestampId	이 카드의 타임스탬프 텍스트 리소스 ID

반환 값

• 호출 체이닝을 위한 이 객체

API 수준 XE22에 추가되었습니다.

공개 CardBuilder showStackIndicator (boolean visible)

visible가 true인 경우 이 카드가 단일 카드가 아닌 카드 스택을 나타낸다는 표시기를 표시합니다.

매개변수

표시	스택 표시기를 표시하려면 true, 숨기려면 false를 지정합니다.

반환 값

• 호출 체이닝을 위한 이 객체