Класс CardBuilder
помогает создавать карты на тему стекла с различными макетами.
Дополнительную информацию и пример кода см. в разделе Создание карточек в стиле 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.Макет | Определяет визуальные макеты для карточек. |
Публичные конструкторы | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Публичные методы | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
CardBuilder | |||||||||||
CardBuilder | |||||||||||
CardBuilder | addImage (int imageId) | ||||||||||
пустота | |||||||||||
инт | |||||||||||
RemoteViews | |||||||||||
Вид | |||||||||||
Вид | получить вид () | ||||||||||
статический интервал | |||||||||||
CardBuilder | setAttributionIcon ( Bitmap 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 заголовокId) | ||||||||||
CardBuilder | |||||||||||
CardBuilder | |||||||||||
CardBuilder | setIcon (интервал 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 , который будет использоваться построителем для создания своих представлений. |
---|---|
макет | желаемый макет карты |
Публичные методы
общедоступный CardBuilder addImage ( Drawable imageDrawable)
Добавляет на карту изображение, указанное как Drawable
.
Этот метод применяется только к карточкам, которые преобразуются в представления с помощью getView()
. RemoteViews
, созданные CardBuilder
поддерживают только Bitmap
изображения и изображения на основе ресурсов. Drawable
изображения на RemoteViews
не поддерживаются.
Параметры
изображениеDrawable | Drawable изображение для добавления |
---|
Возвращает
- этот объект для цепочки вызовов
общедоступный CardBuilder addImage ( Bitmap imageBitmap)
Добавляет на карту изображение, указанное как Bitmap
.
Параметры
изображениеРастровое изображение | Bitmap изображение для добавления |
---|
Возвращает
- этот объект для цепочки вызовов
общедоступный CardBuilder addImage (int imageId)
Добавляет на карту изображение, указанное как ресурс для рисования.
Параметры
идентификатор изображения | идентификатор ресурса изображения для добавления |
---|
Возвращает
- этот объект для цепочки вызовов
public void clearImages ()
Удаляет все изображения, ранее добавленные на карту.
общедоступный интервал getItemViewType ()
Возвращает тип просмотра этой конкретной карточки.
Полезно в сочетании с адаптером. См. getItemViewType(int)
.
общедоступные RemoteViews getRemoteViews ()
Возвращает представление RemoteViews
этой карты.
public View getView ( View convertView, ViewGroup parent)
Возвращает View
представление этой карточки.
Полезно в сочетании с адаптером. См. getView(int, View, ViewGroup)
.
Параметры
convertView | старый вид для повторного использования, если это возможно; может быть null Примечание: если это представление не имеет правильного типа, этот метод создает новое представление |
---|---|
родитель | к которому в конечном итоге будет прикреплено это представление, возможно, null |
общедоступный статический интервал getViewTypeCount ()
Возвращает общее количество карточек типов просмотра, которые могут принимать.
Полезно в сочетании с адаптером. См. getViewTypeCount()
.
общедоступный CardBuilder setAttributionIcon ( Bitmap iconBitmap)
Устанавливает значок атрибуции для карты с помощью Bitmap
.
Параметры
значокРастровое изображение | Bitmap для использования в качестве значка авторства |
---|
Возвращает
- этот объект для цепочки вызовов
общедоступный CardBuilder setAttributionIcon ( Drawable iconDrawable)
Устанавливает значок атрибуции для карты с помощью Drawable
.
Этот метод применяется только к карточкам, которые преобразуются в представления с помощью getView()
. RemoteViews
, созданные CardBuilder
поддерживают только Bitmap
изображения и изображения на основе ресурсов. Drawable
изображения на RemoteViews
не поддерживаются.
Параметры
значокDrawable | Drawable для использования в качестве значка атрибуции |
---|
Возвращает
- этот объект для цепочки вызовов
открытый CardBuilder setAttributionIcon (int iconId)
Устанавливает значок атрибуции для карты, используя доступный ресурс.
Параметры
iconId | идентификатор ресурса для использования в качестве значка атрибуции |
---|
Возвращает
- этот объект для цепочки вызовов
открытый CardBuilder setEmbeddedLayout (int layoutResId)
Задает идентификатор ресурса макета для встраивания в карточку.
Параметры
layoutResId | идентификатор ресурса макета для встраивания в карточку |
---|
Возвращает
- этот объект для цепочки вызовов
public CardBuilder setFootnote (сноска CharSequence )
Устанавливает текст сноски для карточки.
Параметры
сноска | текст сноски для этой карты |
---|
Возвращает
- этот объект для цепочки вызовов
открытый CardBuilder setFootnote (int footnoteId)
Задает текст сноски для карточки с помощью строкового ресурса.
Параметры
сноскаId | идентификатор текстового ресурса сноски для этой карточки |
---|
Возвращает
- этот объект для цепочки вызовов
public CardBuilder setHeading (заголовок CharSequence )
Устанавливает текст заголовка для карточки.
Параметры
заголовок | текст заголовка для этой карты |
---|
Возвращает
- этот объект для цепочки вызовов
открытый CardBuilder setHeading (int headingId)
Задает текст заголовка для карточки, используя строковый ресурс.
Параметры
идентификатор заголовка | идентификатор ресурса текста заголовка для этой карточки |
---|
Возвращает
- этот объект для цепочки вызовов
общедоступный CardBuilder setIcon ( Bitmap iconBitmap)
Устанавливает значок для карты с помощью Bitmap
.
Параметры
значокРастровое изображение | Bitmap для использования в качестве значка |
---|
Возвращает
- этот объект для цепочки вызовов
общедоступный CardBuilder setIcon ( Drawable iconDrawable)
Устанавливает значок для карты с помощью Drawable
.
Этот метод применяется только к карточкам, которые преобразуются в представления с помощью getView()
. RemoteViews
, созданные CardBuilder
поддерживают только Bitmap
изображения и изображения на основе ресурсов. Drawable
изображения на RemoteViews
не поддерживаются.
Параметры
значокDrawable | Drawable для использования в качестве значка |
---|
Возвращает
- этот объект для цепочки вызовов
открытый CardBuilder setIcon (int iconId)
Устанавливает значок для карты, используя доступный для рисования ресурс.
Параметры
iconId | идентификатор ресурса для использования в качестве значка |
---|
Возвращает
- этот объект для цепочки вызовов
public CardBuilder setSubheading (подзаголовок CharSequence )
Устанавливает текст подзаголовка для карточки.
Параметры
подзаголовок | текст подзаголовка для этой карты |
---|
Возвращает
- этот объект для цепочки вызовов
общедоступный CardBuilder setSubheading (int subheadingId)
Задает текст подзаголовка для карточки с помощью строкового ресурса.
Параметры
идентификатор подзаголовка | идентификатор текстового ресурса подзаголовка для этой карточки |
---|
Возвращает
- этот объект для цепочки вызовов
открытый CardBuilder setText (int textId)
Задает основной текст для карточки с помощью строкового ресурса.
Параметры
текстовый идентификатор | ID основного текстового ресурса для этой карты |
---|
Возвращает
- этот объект для цепочки вызовов
открытый CardBuilder setText (текст CharSequence )
Устанавливает основной текст для карточки.
Параметры
текст | основной текст этой карты |
---|
Возвращает
- этот объект для цепочки вызовов
общедоступный CardBuilder setTimestamp (временная метка CharSequence )
Устанавливает текст временной метки для карты.
Параметры
отметка времени | текст временной метки для этой карты |
---|
Возвращает
- этот объект для цепочки вызовов
публичный CardBuilder setTimestamp (int timestampId)
Устанавливает текст временной метки для карты, используя строковый ресурс.
Параметры
идентификатор временной метки | идентификатор текстового ресурса временной метки для этой карты |
---|
Возвращает
- этот объект для цепочки вызовов
общедоступный CardBuilder showStackIndicator (логический видимый)
Показывает индикатор, если visible
верно, что эта карта представляет стопку карт, а не одну карту.
Параметры
видимый | true, чтобы показать индикатор стека, или false, чтобы скрыть его |
---|
Возвращает
- этот объект для цепочки вызовов