CardBuilder
클래스는 다양한 레이아웃으로 Glass 테마 카드를 빌드하는 데 도움이 됩니다.
자세한 내용과 샘플 코드는 Glass 스타일 카드 만들기를 참고하세요.
일반 사용법
CardBuilder
객체를 만들고 원하는CardBuilder.Layout
를 생성자에 전달합니다.add/set*
메서드 계열을 사용하여 카드의 콘텐츠를 설정합니다.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 | |||||||||||
CardBuilder |
addImage(int imageId)
|
||||||||||
void | |||||||||||
int | |||||||||||
RemoteView |
getRemoteViews() 클래스의 생성자
|
||||||||||
보기 | |||||||||||
보기 |
getView()
|
||||||||||
static | |||||||||||
CardBuilder |
setAttributionIcon(비트맵 iconBitmap)
|
||||||||||
CardBuilder |
setAttributionIcon(드로어블 iconDrawable)
|
||||||||||
CardBuilder |
setAttributionIcon(int iconId)
|
||||||||||
CardBuilder |
setEmbeddedLayout(int layoutResId)
|
||||||||||
CardBuilder | |||||||||||
CardBuilder |
setFootnote(int footnoteId)
|
||||||||||
CardBuilder | |||||||||||
CardBuilder |
setHeading(int headingId)
|
||||||||||
CardBuilder | |||||||||||
CardBuilder | |||||||||||
CardBuilder |
setIcon(int iconId)
|
||||||||||
CardBuilder | |||||||||||
CardBuilder |
setSubheading(int subheadingId)
|
||||||||||
CardBuilder |
setText(int textId)
|
||||||||||
CardBuilder |
setText(CharSequence 텍스트)
|
||||||||||
CardBuilder |
setTimestamp(CharSequence 타임스탬프)
|
||||||||||
CardBuilder |
setTimestamp(int timestampId)
|
||||||||||
CardBuilder |
showStackIndicator(불리언 표시)
|
상속된 메서드 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
공개 생성자
public CardBuilder (컨텍스트 컨텍스트, CardBuilder.Layout 레이아웃)
새 CardBuilder
를 구성합니다.
매개변수
context | 빌더가 뷰를 만드는 데 사용할 Context |
---|---|
레이아웃 | 원하는 카드 레이아웃 |
공개 메서드
public CardBuilder addImage (Drawable imageDrawable)
Drawable
로 지정된 이미지를 카드에 추가합니다.
이 메서드는 getView()
를 사용하여 뷰로 변환되는 카드에만 적용됩니다.
CardBuilder
에서 빌드된 RemoteViews
는 Bitmap
및 리소스 기반 이미지만 지원합니다. RemoteViews
의 Drawable
이미지는 지원되지 않습니다.
매개변수
이미지 드로어블 | 추가할 Drawable 이미지 |
---|
반환 값
- 호출 체이닝을 위한 이 객체
public CardBuilder addImage (Bitmap imageBitmap)
public CardBuilder addImage (int imageId)
드로어블 리소스로 지정된 이미지를 카드에 추가합니다.
매개변수
이미지 ID | 추가할 이미지의 리소스 ID |
---|
반환 값
- 호출 체이닝을 위한 이 객체
public void clearImages ()
이전에 카드에 추가된 모든 이미지를 삭제합니다.
public int getItemViewType ()
이 특정 카드의 뷰 유형을 반환합니다.
어댑터와 함께 사용하면 유용합니다.
getItemViewType(int)
페이지를 참고하세요.
public 보기 getView (View conversionView, ViewGroup 상위 항목)
이 카드의 View
표현을 반환합니다.
어댑터와 함께 사용하면 유용합니다.
getView(int, View, ViewGroup)
페이지를 참고하세요.
매개변수
conversionView | 가능한 경우 이전 뷰를 재사용합니다. null 일 수 있습니다.
참고: 이 뷰에 올바른 유형이 없으면 새 메서드를 만듭니다. |
---|---|
parent | 결국에는 이 뷰가 연결될 수 있습니다. null
|
public static int getViewTypeCount ()
카드가 받을 수 있는 총 뷰 유형 수를 반환합니다.
어댑터와 함께 사용하면 유용합니다.
getViewTypeCount()
페이지를 참고하세요.
public CardBuilder setAttributionIcon (비트맵 iconBitmap)
public CardBuilder setAttributionIcon (Drawable iconDrawable)
Drawable
를 사용하여 카드의 기여 분석 아이콘을 설정합니다.
이 메서드는 getView()
를 사용하여 뷰로 변환되는 카드에만 적용됩니다.
CardBuilder
에서 빌드된 RemoteViews
는 Bitmap
및 리소스 기반 이미지만 지원합니다. RemoteViews
의 Drawable
이미지는 지원되지 않습니다.
매개변수
아이콘 드로어블 | 기여 분석 아이콘으로 사용할 Drawable |
---|
반환 값
- 호출 체이닝을 위한 이 객체
public CardBuilder setAttributionIcon (int iconId)
드로어블 리소스를 사용하여 카드의 기여 분석 아이콘을 설정합니다.
매개변수
아이콘 ID | 기여 분석 아이콘으로 사용할 리소스 ID |
---|
반환 값
- 호출 체이닝을 위한 이 객체
public CardBuilder setEmbeddedLayout (int layoutResId)
카드에 삽입할 레이아웃의 리소스 ID를 설정합니다.
매개변수
layoutResId | 카드에 삽입할 레이아웃의 리소스 ID |
---|
반환 값
- 호출 체이닝을 위한 이 객체
public CardBuilder setFootnote (CharSequence 각주)
카드의 각주 텍스트를 설정합니다.
매개변수
각주 | 이 카드의 각주 텍스트 |
---|
반환 값
- 호출 체이닝을 위한 이 객체
public CardBuilder setFootnote (int footnoteId)
문자열 리소스를 사용하여 카드의 각주 텍스트를 설정합니다.
매개변수
각주 ID | 이 카드의 각주 텍스트 리소스 ID |
---|
반환 값
- 호출 체이닝을 위한 이 객체
public CardBuilder setHeading (CharSequence 제목)
카드의 제목 텍스트를 설정합니다.
매개변수
방향 | 이 카드의 제목 텍스트 |
---|
반환 값
- 호출 체이닝을 위한 이 객체
public CardBuilder setHeading (int headingId)
문자열 리소스를 사용하여 카드의 제목 텍스트를 설정합니다.
매개변수
제목 ID | 이 카드의 제목 텍스트 리소스 ID |
---|
반환 값
- 호출 체이닝을 위한 이 객체
public CardBuilder setIcon (Bitmap iconBitmap)
public CardBuilder setIcon (Drawable iconDrawable)
Drawable
를 사용하여 카드 아이콘을 설정합니다.
이 메서드는 getView()
를 사용하여 뷰로 변환되는 카드에만 적용됩니다.
CardBuilder
에서 빌드된 RemoteViews
는 Bitmap
및 리소스 기반 이미지만 지원합니다. RemoteViews
의 Drawable
이미지는 지원되지 않습니다.
매개변수
아이콘 드로어블 | 아이콘으로 사용할 Drawable |
---|
반환 값
- 호출 체이닝을 위한 이 객체
public CardBuilder setIcon (int iconId)
드로어블 리소스를 사용하여 카드의 아이콘을 설정합니다.
매개변수
아이콘 ID | 아이콘으로 사용할 리소스 ID |
---|
반환 값
- 호출 체이닝을 위한 이 객체
public CardBuilder setSubheading (CharSequence 부제목)
카드의 부제목 텍스트를 설정합니다.
매개변수
부제목 | 이 카드의 부제목 텍스트 |
---|
반환 값
- 호출 체이닝을 위한 이 객체
public CardBuilder setSubheading (int subheadingId)
문자열 리소스를 사용하여 카드의 부제목 텍스트를 설정합니다.
매개변수
부제목 ID | 이 카드의 부제목 텍스트 리소스 ID |
---|
반환 값
- 호출 체이닝을 위한 이 객체
public CardBuilder setText (int textId)
문자열 리소스를 사용하여 카드의 기본 텍스트를 설정합니다.
매개변수
텍스트 ID | 이 카드의 기본 텍스트 리소스 ID |
---|
반환 값
- 호출 체이닝을 위한 이 객체
public CardBuilder setText (CharSequence 텍스트)
카드의 기본 텍스트를 설정합니다.
매개변수
문자 | 이 카드의 기본 텍스트 |
---|
반환 값
- 호출 체이닝을 위한 이 객체
public CardBuilder setTimestamp (CharSequence 타임스탬프)
카드의 타임스탬프 텍스트를 설정합니다.
매개변수
timestamp | 이 카드의 타임스탬프 텍스트 |
---|
반환 값
- 호출 체이닝을 위한 이 객체
public CardBuilder setTimestamp (int timestampId)
문자열 리소스를 사용하여 카드의 타임스탬프 텍스트를 설정합니다.
매개변수
타임스탬프 ID | 이 카드의 타임스탬프 텍스트 리소스 ID |
---|
반환 값
- 호출 체이닝을 위한 이 객체
public CardBuilder showStackIndicator (불리언 표시)
visible
가 true인 경우 이 카드가 단일 카드가 아닌 여러 개의 카드를 나타냄을 표시합니다.
매개변수
표시 | true로 설정하여 스택 표시기를 표시하거나 false로 설정합니다. |
---|
반환 값
- 호출 체이닝을 위한 이 객체