CardBuilder

Добавлено на уровне API XE21.

Класс CardBuilder помогает создавать карточки в стиле Glass с различными макетами.

Дополнительную информацию и пример кода см. в разделе Создание карточек в стиле Glass .

Общее использование

  1. Создайте объект CardBuilder , передав желаемый CardBuilder.Layout конструктору.
  2. Установите содержимое карты с помощью семейства методов add/set* .
  3. Получите 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.Layout )
Публичные методы
CardBuilder
addImage ( Рисуемое изображениеDrawable)
CardBuilder
addImage ( Растровое изображениеBitmap)
CardBuilder
addImage (int imageId)
пустота
ОчиститьИзображения ()
интервал
getItemViewType ()
Удаленные представления
getRemoteViews ()
Вид
getView ( Просмотр ConvertView, родительский элемент ViewGroup )
Вид
получитьВью ()
статический int
getViewTypeCount ()
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
setIcon ( Рисуемый 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.

общедоступный CardBuilder ( контекст контекста, макет CardBuilder.Layout )

Создает новый CardBuilder .

Параметры
контекст Context , который будет использоваться разработчиком для создания представлений.
макет желаемый макет карты

Публичные методы

Добавлено на уровне API XE21.

public CardBuilder addImage ( Drawable imageDrawable)

Добавляет на карту изображение, указанное как Drawable .

Этот метод применим только к карточкам, которые преобразуются в представления с помощью getView() . RemoteViews , созданные CardBuilder поддерживают только Bitmap и изображения на основе ресурсов. Drawable изображения в RemoteViews не поддерживаются.

Параметры
изображениеРисуемый Drawable изображение для добавления
Возврат
  • этот объект для цепочки вызовов
Добавлено на уровне API XE21.

общедоступный CardBuilder addImage ( растровое изображение imageBitmap)

Добавляет на карту изображение, указанное как Bitmap .

Параметры
изображениеРастровое изображение Bitmap изображение для добавления
Возврат
  • этот объект для цепочки вызовов
Добавлено на уровне API XE21.

общедоступный CardBuilder addImage (int imageId)

Добавляет на карту изображение, указанное как доступный для рисования ресурс.

Параметры
идентификатор изображения идентификатор ресурса изображения, которое нужно добавить
Возврат
  • этот объект для цепочки вызовов
Добавлено на уровне API XE21.

общественная пустота ClearImages ()

Удаляет все изображения, ранее добавленные на карту.

Добавлено на уровне API XE21.

public int getItemViewType ()

Возвращает тип представления этой конкретной карточки.

Полезно в сочетании с адаптером. См. getItemViewType(int) .

Добавлено на уровне API XE21.

общедоступные RemoteViews getRemoteViews ()

Возвращает представление этой карты RemoteViews .

Добавлено на уровне API XE21.

public View getView ( Просмотр ConvertView, родительский элемент ViewGroup )

Возвращает View этой карты.

Полезно в сочетании с адаптером. См. getView(int, View, ViewGroup) .

Параметры
конвертироватьView старое представление для повторного использования, если это возможно; может быть null Примечание. Если это представление не имеет правильного типа, этот метод создает новое представление.
родитель к этому представлению в конечном итоге будет прикреплено, возможно, null
Добавлено на уровне API XE21.

общедоступный просмотр getView ()

Возвращает View этой карты.

Добавлено на уровне API XE21.

public static int getViewTypeCount ()

Возвращает общее количество типов просмотра, которые могут принимать карты.

Полезно в сочетании с адаптером. См. getViewTypeCount() .

Добавлено на уровне API XE22.

общедоступный CardBuilder setAttributionIcon ( растровое изображение iconBitmap)

Устанавливает значок атрибуции для карты с помощью Bitmap .

Параметры
значокРастровое изображение Bitmap , которое будет использоваться в качестве значка атрибуции
Возврат
  • этот объект для цепочки вызовов
Добавлено на уровне API XE22.

public CardBuilder setAttributionIcon ( Рисуемый значокDrawable)

Устанавливает значок атрибуции для карты с помощью Drawable .

Этот метод применим только к карточкам, которые преобразуются в представления с помощью getView() . RemoteViews , созданные CardBuilder поддерживают только Bitmap и изображения на основе ресурсов. Drawable изображения в RemoteViews не поддерживаются.

Параметры
значокРисуемый Drawable для использования в качестве значка атрибуции
Возврат
  • этот объект для цепочки вызовов
Добавлено на уровне API XE22.

общедоступный CardBuilder setAttributionIcon (int iconId)

Устанавливает значок атрибуции для карты с использованием доступного ресурса.

Параметры
идентификатор значка идентификатор ресурса, который будет использоваться в качестве значка атрибуции
Возврат
  • этот объект для цепочки вызовов
Добавлено на уровне API XE22.

общедоступный CardBuilder setEmbeddedLayout (int LayoutResId)

Устанавливает идентификатор ресурса макета для встраивания в карточку.

Параметры
макетResId идентификатор ресурса макета для встраивания в карточку
Возврат
  • этот объект для цепочки вызовов
Добавлено на уровне API XE21.

public CardBuilder setFootnote (сноска CharSequence )

Устанавливает текст сноски для карточки.

Параметры
сноска текст сноски к этой карточке
Возврат
  • этот объект для цепочки вызовов
Добавлено на уровне API XE21.

public CardBuilder setFootnote (int footnoteId)

Устанавливает текст сноски для карточки, используя строковый ресурс.

Параметры
сноскаId идентификатор текстового ресурса сноски для этой карточки
Возврат
  • этот объект для цепочки вызовов
Добавлено на уровне API XE21.

public CardBuilder setHeading (заголовок CharSequence )

Устанавливает текст заголовка карточки.

Параметры
заголовок текст заголовка для этой карточки
Возврат
  • этот объект для цепочки вызовов
Добавлено на уровне API XE21.

общедоступный SetHeading CardBuilder (int headingId)

Устанавливает текст заголовка карточки, используя строковый ресурс.

Параметры
идентификатор заголовка идентификатор текстового ресурса заголовка для этой карточки
Возврат
  • этот объект для цепочки вызовов
Добавлено на уровне API XE21.

public CardBuilder setIcon ( растровое изображение iconBitmap)

Устанавливает значок карты с помощью Bitmap .

Параметры
значокРастровое изображение Bitmap , которое будет использоваться в качестве значка
Возврат
  • этот объект для цепочки вызовов
Добавлено на уровне API XE21.

общедоступный набор CardBuilder ( Drawable iconDrawable )

Устанавливает значок карты с помощью Drawable .

Этот метод применим только к карточкам, которые преобразуются в представления с помощью getView() . RemoteViews , созданные CardBuilder поддерживают только Bitmap и изображения на основе ресурсов. Drawable изображения в RemoteViews не поддерживаются.

Параметры
значокРисуемый Drawable для использования в качестве значка
Возврат
  • этот объект для цепочки вызовов
Добавлено на уровне API XE21.

общедоступный SetIcon CardBuilder (int iconId)

Устанавливает значок карты, используя доступный ресурс.

Параметры
идентификатор значка идентификатор ресурса, который будет использоваться в качестве значка
Возврат
  • этот объект для цепочки вызовов
Добавлено на уровне API XE21.

public CardBuilder setSubheading (подзаголовок CharSequence )

Устанавливает текст подзаголовка для карточки.

Параметры
подзаголовок текст подзаголовка для этой карточки
Возврат
  • этот объект для цепочки вызовов
Добавлено на уровне API XE21.

общедоступный набор CardBuilderSubheading (int subheadingId)

Устанавливает текст подзаголовка для карточки, используя строковый ресурс.

Параметры
идентификатор подзаголовка идентификатор текстового ресурса подзаголовка для этой карточки
Возврат
  • этот объект для цепочки вызовов
Добавлено на уровне API XE21.

общедоступный SetText CardBuilder (int textId)

Устанавливает основной текст карточки, используя строковый ресурс.

Параметры
текстовый идентификатор идентификатор основного текстового ресурса для этой карточки
Возврат
  • этот объект для цепочки вызовов
Добавлено на уровне API XE21.

public CardBuilder setText (текст CharSequence )

Устанавливает основной текст карточки.

Параметры
текст основной текст этой карточки
Возврат
  • этот объект для цепочки вызовов
Добавлено на уровне API XE21.

public CardBuilder setTimestamp (временная метка CharSequence )

Устанавливает текст временной метки для карты.

Параметры
временная метка текст временной метки для этой карты
Возврат
  • этот объект для цепочки вызовов
Добавлено на уровне API XE21.

общедоступный CardBuilder setTimestamp (int timestampId)

Устанавливает текст временной метки для карты, используя строковый ресурс.

Параметры
метка времени идентификатор текстового ресурса метки времени для этой карты
Возврат
  • этот объект для цепочки вызовов
Добавлено на уровне API XE22.

общедоступный CardBuilder showStackIndicator (видимое логическое значение)

Показывает индикатор, если visible , что эта карта представляет собой стопку карт, а не одну карту.

Параметры
видимый true, чтобы показать индикатор стека, или false, чтобы скрыть его
Возврат
  • этот объект для цепочки вызовов