ImageCardView

public class ImageCardView
extends BaseCardView

java.lang.Object
↳	android.view.View
	↳	android.view.ViewGroup
		↳	android.widget.FrameLayout
			↳	android.support.v17.leanback.widget.BaseCardView
				↳	android.support.v17.leanback.widget.ImageCardView

---

A subclass of BaseCardView with an ImageView as its main region. The ImageCardView is highly customizable and can be used for various use-cases by adjusting the ImageViewCard's type to any combination of Title, Content, Badge or ImageOnly.

Styling

There are two different ways to style the ImageCardView.
No matter what way you use, all your styles applied to an ImageCardView have to extend the style Widget_Leanback_ImageCardViewStyle.

Example:

 <style name="CustomImageCardViewStyle" parent="Widget.Leanback.ImageCardViewStyle">
        <item name="cardBackground">#F0F</item>
        <item name="lbImageCardViewType">Title|Content</item>
   </style>
   <style name="CustomImageCardTheme" parent="Theme.Leanback">
        <item name="imageCardViewStyle">@style/CustomImageCardViewStyle</item>
        <item name="imageCardViewInfoAreaStyle">@style/ImageCardViewColoredInfoArea</item>
        <item name="imageCardViewTitleStyle">@style/ImageCardViewColoredTitle</item>
    </style>
 

The first possibility is to set custom Styles in the Leanback Theme's attributes imageCardViewStyle, imageCardViewTitleStyle etc. The styles set here, is the default style for all ImageCardViews.

The second possibility allows you to style a particular ImageCardView. This is useful if you want to create multiple types of cards. E.g. you might want to display a card with only a title and another one with title and content. Thus you need to define two different ImageCardViewStyles and two different themes and apply them to the ImageCardViews. You can do this by using a the ImageCardView(Context) constructor and passing a ContextThemeWrapper with the custom ImageCardView theme id.

Example (using constructor):

 new ImageCardView(new ContextThemeWrapper(context, R.style.CustomImageCardTheme));
 
 

You can style all ImageCardView's components such as the title, content, badge, infoArea and the image itself by extending the corresponding style and overriding the specific attribute in your custom ImageCardView theme.

Components

The ImageCardView contains three components which can be combined in any combination:

• Title: The card's title
• Content: A short description
• Badge: An icon which can be displayed on the right or left side of the card.

In order to choose the components you want to use in your ImageCardView, you have to specify them in the lbImageCardViewType attribute of your custom ImageCardViewStyle. You can combine the following values: Title, Content, IconOnRight, IconOnLeft, ImageOnly.

Examples:

 <style name="CustomImageCardViewStyle" parent="Widget.Leanback.ImageCardViewStyle">
        ...
        <item name="lbImageCardViewType">Title|Content|IconOnLeft</item>
        ...
    </style>
 

 <style name="CustomImageCardViewStyle" parent="Widget.Leanback.ImageCardViewStyle">
        ...
        <item name="lbImageCardViewType">ImageOnly</item>
        ...
    </style>
 

Summary

XML attributes
LeanbackTheme_imageCardViewBadgeStyle
LeanbackTheme_imageCardViewContentStyle
LeanbackTheme_imageCardViewImageStyle
LeanbackTheme_imageCardViewInfoAreaStyle
LeanbackTheme_imageCardViewStyle
LeanbackTheme_imageCardViewTitleStyle
lbImageCardView_lbImageCardViewType

Constants
int	CARD_TYPE_FLAG_CONTENT
int	CARD_TYPE_FLAG_ICON_LEFT
int	CARD_TYPE_FLAG_ICON_RIGHT
int	CARD_TYPE_FLAG_IMAGE_ONLY
int	CARD_TYPE_FLAG_TITLE

Inherited constants
From class android.support.v17.leanback.widget.BaseCardView int CARD_REGION_VISIBLE_ACTIVATED Indicates that a card region is visible when the card is activated. int CARD_REGION_VISIBLE_ALWAYS Indicates that a card region is always visible. int CARD_REGION_VISIBLE_SELECTED Indicates that a card region is visible when the card is selected. int CARD_TYPE_INFO_OVER A Card type with 2 layout areas: A main area which is always visible, and an info area that fades in over the main area when it is visible. int CARD_TYPE_INFO_UNDER A Card type with 2 layout areas: A main area which is always visible, and an info area that appears below the main area. int CARD_TYPE_INFO_UNDER_WITH_EXTRA A Card type with 3 layout areas: A main area which is always visible; an info area which will appear below the main area, and an extra area that only appears after a short delay. int CARD_TYPE_MAIN_ONLY A simple card type with a single layout area.
From class android.view.ViewGroup int CLIP_TO_PADDING_MASK int FOCUS_AFTER_DESCENDANTS int FOCUS_BEFORE_DESCENDANTS int FOCUS_BLOCK_DESCENDANTS int LAYOUT_MODE_CLIP_BOUNDS int LAYOUT_MODE_OPTICAL_BOUNDS int PERSISTENT_ALL_CACHES int PERSISTENT_ANIMATION_CACHE int PERSISTENT_NO_CACHE int PERSISTENT_SCROLLING_CACHE
From class android.view.View int ACCESSIBILITY_LIVE_REGION_ASSERTIVE int ACCESSIBILITY_LIVE_REGION_NONE int ACCESSIBILITY_LIVE_REGION_POLITE int AUTOFILL_FLAG_INCLUDE_NOT_IMPORTANT_VIEWS String AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_DATE String AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_DAY String AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_MONTH String AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_YEAR String AUTOFILL_HINT_CREDIT_CARD_NUMBER String AUTOFILL_HINT_CREDIT_CARD_SECURITY_CODE String AUTOFILL_HINT_EMAIL_ADDRESS String AUTOFILL_HINT_NAME String AUTOFILL_HINT_PASSWORD String AUTOFILL_HINT_PHONE String AUTOFILL_HINT_POSTAL_ADDRESS String AUTOFILL_HINT_POSTAL_CODE String AUTOFILL_HINT_USERNAME int AUTOFILL_TYPE_DATE int AUTOFILL_TYPE_LIST int AUTOFILL_TYPE_NONE int AUTOFILL_TYPE_TEXT int AUTOFILL_TYPE_TOGGLE int DRAG_FLAG_GLOBAL int DRAG_FLAG_GLOBAL_PERSISTABLE_URI_PERMISSION int DRAG_FLAG_GLOBAL_PREFIX_URI_PERMISSION int DRAG_FLAG_GLOBAL_URI_READ int DRAG_FLAG_GLOBAL_URI_WRITE int DRAG_FLAG_OPAQUE int DRAWING_CACHE_QUALITY_AUTO int DRAWING_CACHE_QUALITY_HIGH int DRAWING_CACHE_QUALITY_LOW int FIND_VIEWS_WITH_CONTENT_DESCRIPTION int FIND_VIEWS_WITH_TEXT int FOCUSABLE int FOCUSABLES_ALL int FOCUSABLES_TOUCH_MODE int FOCUSABLE_AUTO int FOCUS_BACKWARD int FOCUS_DOWN int FOCUS_FORWARD int FOCUS_LEFT int FOCUS_RIGHT int FOCUS_UP int GONE int HAPTIC_FEEDBACK_ENABLED int IMPORTANT_FOR_ACCESSIBILITY_AUTO int IMPORTANT_FOR_ACCESSIBILITY_NO int IMPORTANT_FOR_ACCESSIBILITY_NO_HIDE_DESCENDANTS int IMPORTANT_FOR_ACCESSIBILITY_YES int IMPORTANT_FOR_AUTOFILL_AUTO int IMPORTANT_FOR_AUTOFILL_NO int IMPORTANT_FOR_AUTOFILL_NO_EXCLUDE_DESCENDANTS int IMPORTANT_FOR_AUTOFILL_YES int IMPORTANT_FOR_AUTOFILL_YES_EXCLUDE_DESCENDANTS int INVISIBLE int KEEP_SCREEN_ON int LAYER_TYPE_HARDWARE int LAYER_TYPE_NONE int LAYER_TYPE_SOFTWARE int LAYOUT_DIRECTION_INHERIT int LAYOUT_DIRECTION_LOCALE int LAYOUT_DIRECTION_LTR int LAYOUT_DIRECTION_RTL int MEASURED_HEIGHT_STATE_SHIFT int MEASURED_SIZE_MASK int MEASURED_STATE_MASK int MEASURED_STATE_TOO_SMALL int NOT_FOCUSABLE int NO_ID int OVER_SCROLL_ALWAYS int OVER_SCROLL_IF_CONTENT_SCROLLS int OVER_SCROLL_NEVER int SCREEN_STATE_OFF int SCREEN_STATE_ON int SCROLLBARS_INSIDE_INSET int SCROLLBARS_INSIDE_OVERLAY int SCROLLBARS_OUTSIDE_INSET int SCROLLBARS_OUTSIDE_OVERLAY int SCROLLBAR_POSITION_DEFAULT int SCROLLBAR_POSITION_LEFT int SCROLLBAR_POSITION_RIGHT int SCROLL_AXIS_HORIZONTAL int SCROLL_AXIS_NONE int SCROLL_AXIS_VERTICAL int SCROLL_INDICATOR_BOTTOM int SCROLL_INDICATOR_END int SCROLL_INDICATOR_LEFT int SCROLL_INDICATOR_RIGHT int SCROLL_INDICATOR_START int SCROLL_INDICATOR_TOP int SOUND_EFFECTS_ENABLED int STATUS_BAR_HIDDEN int STATUS_BAR_VISIBLE int SYSTEM_UI_FLAG_FULLSCREEN int SYSTEM_UI_FLAG_HIDE_NAVIGATION int SYSTEM_UI_FLAG_IMMERSIVE int SYSTEM_UI_FLAG_IMMERSIVE_STICKY int SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN int SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION int SYSTEM_UI_FLAG_LAYOUT_STABLE