Класс CardBuilder
помогает создавать карточки в стиле Glass с различными макетами.
Дополнительную информацию и пример кода см. в разделе Создание карточек в стиле Glass .
Общее использование
- Создайте объект
CardBuilder
, передав желаемыйCardBuilder.Layout
конструктору. - Установите содержимое карты с помощью семейства методов
add/set*
. - Получите
View
, вызвавgetView()
, или получите объектRemoteViews
с помощьюgetRemoteViews()
.
Примечание по переработке встроенных макетов
При использованииEMBED_INSIDE
CardBuilder
не делает различий между различными встроенными макетами при переработке представлений. Если у вас есть два экземпляра CardBuilder
с EMBED_INSIDE
, но один имеет макет A, а другой — макет B, CardBuilder
будет рассматривать их как один и тот же. Если такое поведение нежелательно (например, при использовании CardScrollAdapter
с разными встроенными макетами), вы должны различать их, возвращая разные типы представлений из getItemViewType(int)
, чтобы переработчик отправлял вам только convertView
с вложенными макетами, которые вы ожидаете для конкретный предмет.
Если вам необходимо поддерживать карты с несколькими встроенными макетами наряду со встроенными макетами, мы рекомендуем возвращать типы представлений с номерами getViewTypeCount()
, CardBuilder.getViewTypeCount() + 1
и т. д.
Вложенные классы | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
перечисление | CardBuilder.Layout | Определяет визуальные макеты карточек. |
Публичные конструкторы | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Публичные методы | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
CardBuilder | |||||||||||
CardBuilder | |||||||||||
CardBuilder | addImage (int imageId) | ||||||||||
пустота | |||||||||||
интервал | |||||||||||
Удаленные представления | |||||||||||
Вид | |||||||||||
Вид | получитьВью () | ||||||||||
статический int | |||||||||||
CardBuilder | setAttributionIcon ( растровое изображение iconBitmap) | ||||||||||
CardBuilder | setAttributionIcon ( Рисуемый значокDrawable) | ||||||||||
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 | |||||||||||
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 (видимое логическое значение) |
Унаследованные методы | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Публичные конструкторы
общедоступный CardBuilder ( контекст контекста, макет CardBuilder.Layout )
Создает новый CardBuilder
.
Параметры
контекст | Context , который будет использоваться разработчиком для создания представлений. |
---|---|
макет | желаемый макет карты |
Публичные методы
public CardBuilder addImage ( Drawable imageDrawable)
Добавляет на карту изображение, указанное как Drawable
.
Этот метод применим только к карточкам, которые преобразуются в представления с помощью getView()
. RemoteViews
, созданные CardBuilder
поддерживают только Bitmap
и изображения на основе ресурсов. Drawable
изображения в RemoteViews
не поддерживаются.
Параметры
изображениеРисуемый | Drawable изображение для добавления |
---|
Возврат
- этот объект для цепочки вызовов
общедоступный CardBuilder addImage ( растровое изображение imageBitmap)
Добавляет на карту изображение, указанное как Bitmap
.
Параметры
изображениеРастровое изображение | Bitmap изображение для добавления |
---|
Возврат
- этот объект для цепочки вызовов
общедоступный CardBuilder addImage (int imageId)
Добавляет на карту изображение, указанное как доступный для рисования ресурс.
Параметры
идентификатор изображения | идентификатор ресурса изображения, которое нужно добавить |
---|
Возврат
- этот объект для цепочки вызовов
общественная пустота ClearImages ()
Удаляет все изображения, ранее добавленные на карту.
public int getItemViewType ()
Возвращает тип представления этой конкретной карточки.
Полезно в сочетании с адаптером. См. getItemViewType(int)
.
общедоступные RemoteViews getRemoteViews ()
Возвращает представление этой карты RemoteViews
.
public View getView ( Просмотр ConvertView, родительский элемент ViewGroup )
Возвращает View
этой карты.
Полезно в сочетании с адаптером. См. getView(int, View, ViewGroup)
.
Параметры
конвертироватьView | старое представление для повторного использования, если это возможно; может быть null Примечание. Если это представление не имеет правильного типа, этот метод создает новое представление. |
---|---|
родитель | к этому представлению в конечном итоге будет прикреплено, возможно, null |
public static int getViewTypeCount ()
Возвращает общее количество типов просмотра, которые могут принимать карты.
Полезно в сочетании с адаптером. См. getViewTypeCount()
.
общедоступный CardBuilder setAttributionIcon ( растровое изображение iconBitmap)
Устанавливает значок атрибуции для карты с помощью Bitmap
.
Параметры
значокРастровое изображение | Bitmap , которое будет использоваться в качестве значка атрибуции |
---|
Возврат
- этот объект для цепочки вызовов
public CardBuilder setAttributionIcon ( Рисуемый значокDrawable)
Устанавливает значок атрибуции для карты с помощью Drawable
.
Этот метод применим только к карточкам, которые преобразуются в представления с помощью getView()
. RemoteViews
, созданные CardBuilder
поддерживают только Bitmap
и изображения на основе ресурсов. Drawable
изображения в RemoteViews
не поддерживаются.
Параметры
значокРисуемый | Drawable для использования в качестве значка атрибуции |
---|
Возврат
- этот объект для цепочки вызовов
общедоступный CardBuilder setAttributionIcon (int iconId)
Устанавливает значок атрибуции для карты с использованием доступного ресурса.
Параметры
идентификатор значка | идентификатор ресурса, который будет использоваться в качестве значка атрибуции |
---|
Возврат
- этот объект для цепочки вызовов
общедоступный CardBuilder setEmbeddedLayout (int LayoutResId)
Устанавливает идентификатор ресурса макета для встраивания в карточку.
Параметры
макетResId | идентификатор ресурса макета для встраивания в карточку |
---|
Возврат
- этот объект для цепочки вызовов
public CardBuilder setFootnote (сноска CharSequence )
Устанавливает текст сноски для карточки.
Параметры
сноска | текст сноски к этой карточке |
---|
Возврат
- этот объект для цепочки вызовов
public CardBuilder setFootnote (int footnoteId)
Устанавливает текст сноски для карточки, используя строковый ресурс.
Параметры
сноскаId | идентификатор текстового ресурса сноски для этой карточки |
---|
Возврат
- этот объект для цепочки вызовов
public CardBuilder setHeading (заголовок CharSequence )
Устанавливает текст заголовка карточки.
Параметры
заголовок | текст заголовка для этой карточки |
---|
Возврат
- этот объект для цепочки вызовов
общедоступный SetHeading CardBuilder (int headingId)
Устанавливает текст заголовка карточки, используя строковый ресурс.
Параметры
идентификатор заголовка | идентификатор текстового ресурса заголовка для этой карточки |
---|
Возврат
- этот объект для цепочки вызовов
public CardBuilder setIcon ( растровое изображение iconBitmap)
Устанавливает значок карты с помощью Bitmap
.
Параметры
значокРастровое изображение | Bitmap , которое будет использоваться в качестве значка |
---|
Возврат
- этот объект для цепочки вызовов
общедоступный набор CardBuilder ( Drawable iconDrawable )
Устанавливает значок карты с помощью Drawable
.
Этот метод применим только к карточкам, которые преобразуются в представления с помощью getView()
. RemoteViews
, созданные CardBuilder
поддерживают только Bitmap
и изображения на основе ресурсов. Drawable
изображения в RemoteViews
не поддерживаются.
Параметры
значокРисуемый | Drawable для использования в качестве значка |
---|
Возврат
- этот объект для цепочки вызовов
общедоступный SetIcon CardBuilder (int iconId)
Устанавливает значок карты, используя доступный ресурс.
Параметры
идентификатор значка | идентификатор ресурса, который будет использоваться в качестве значка |
---|
Возврат
- этот объект для цепочки вызовов
public CardBuilder setSubheading (подзаголовок CharSequence )
Устанавливает текст подзаголовка для карточки.
Параметры
подзаголовок | текст подзаголовка для этой карточки |
---|
Возврат
- этот объект для цепочки вызовов
общедоступный набор CardBuilderSubheading (int subheadingId)
Устанавливает текст подзаголовка для карточки, используя строковый ресурс.
Параметры
идентификатор подзаголовка | идентификатор текстового ресурса подзаголовка для этой карточки |
---|
Возврат
- этот объект для цепочки вызовов
общедоступный SetText CardBuilder (int textId)
Устанавливает основной текст карточки, используя строковый ресурс.
Параметры
текстовый идентификатор | идентификатор основного текстового ресурса для этой карточки |
---|
Возврат
- этот объект для цепочки вызовов
public CardBuilder setText (текст CharSequence )
Устанавливает основной текст карточки.
Параметры
текст | основной текст этой карточки |
---|
Возврат
- этот объект для цепочки вызовов
public CardBuilder setTimestamp (временная метка CharSequence )
Устанавливает текст временной метки для карты.
Параметры
временная метка | текст временной метки для этой карты |
---|
Возврат
- этот объект для цепочки вызовов
общедоступный CardBuilder setTimestamp (int timestampId)
Устанавливает текст временной метки для карты, используя строковый ресурс.
Параметры
метка времени | идентификатор текстового ресурса метки времени для этой карты |
---|
Возврат
- этот объект для цепочки вызовов
общедоступный CardBuilder showStackIndicator (видимое логическое значение)
Показывает индикатор, если visible
, что эта карта представляет собой стопку карт, а не одну карту.
Параметры
видимый | true, чтобы показать индикатор стека, или false, чтобы скрыть его |
---|
Возврат
- этот объект для цепочки вызовов