GridTemplate
@CarProtocol
class GridTemplate : Template
A template representing a grid of items.
Template Restrictions In regards to template refreshes, as described inonGetTemplate, this template is considered a refresh of a previous one if:
- The previous template is in a loading state (see
setLoading, or - The template title has not changed, and the number of grid items and the title of each grid item have not changed.
Summary
Nested types |
|---|
class GridTemplate.BuilderA builder of |
Constants |
|
|---|---|
const Int |
Represents a preference to crop all grid item images into the shape of a circle. |
const Int |
Represents a preference to keep the images as-is without modifying their shape. |
const Int |
Represents a large size for all grid items within a template. |
const Int |
Represents a medium size for all grid items within a template. |
const Int |
Represents a small size for all grid items within a template. |
Public functions |
|
|---|---|
Boolean |
|
ActionStrip? |
This function is deprecated. use |
(Mutable)List<Action!> |
@ExperimentalCarApiReturns the list of additional actions. |
Header? |
Returns the |
Action? |
This function is deprecated. use |
Int |
Returns the item image shape. |
Int |
Returns the grid item size, which applies to all grid items in the template. |
ItemList? |
Returns the |
CarText? |
This function is deprecated. use |
Int |
hashCode() |
Boolean |
Returns whether the template is loading. |
String |
toString() |
Constants
ITEM_IMAGE_SHAPE_CIRCLE
@ExperimentalCarApi
const val ITEM_IMAGE_SHAPE_CIRCLE = 2: Int
Represents a preference to crop all grid item images into the shape of a circle.
| See also | |
|---|---|
setItemImageShape |
ITEM_IMAGE_SHAPE_UNSET
@ExperimentalCarApi
const val ITEM_IMAGE_SHAPE_UNSET = 1: Int
Represents a preference to keep the images as-is without modifying their shape.
This is the default setting.
| See also | |
|---|---|
setItemImageShape |
ITEM_SIZE_LARGE
@ExperimentalCarApi
const val ITEM_SIZE_LARGE = 4: Int
Represents a large size for all grid items within a template.
| See also | |
|---|---|
setItemSize |
ITEM_SIZE_MEDIUM
@ExperimentalCarApi
const val ITEM_SIZE_MEDIUM = 2: Int
Represents a medium size for all grid items within a template.
| See also | |
|---|---|
setItemSize |
ITEM_SIZE_SMALL
@ExperimentalCarApi
const val ITEM_SIZE_SMALL = 1: Int
Represents a small size for all grid items within a template. This is the default size.
| See also | |
|---|---|
setItemSize |
Public functions
fungetActionStrip(): ActionStrip?
Returns the ActionStrip for this template or null if not set.
| See also | |
|---|---|
setActionStrip |
getActions
@ExperimentalCarApi
@RequiresCarApi(value = 7)
fun getActions(): (Mutable)List<Action!>
Returns the list of additional actions.
| See also | |
|---|---|
addAction |
getHeader
fun getHeader(): Header?
Returns the Header to display in this template.
This method was introduced in API 7, but is backwards compatible even if the client is using API 6 or below.
| See also | |
|---|---|
setHeader |
fungetHeaderAction(): Action?
Returns the Action that is set to be displayed in the header of the template, or null if not set.
| See also | |
|---|---|
setHeaderAction |
getItemImageShape
@ExperimentalCarApi
fun getItemImageShape(): Int
Returns the item image shape.
All item images in the grid are cropped into the specified shape.
| See also | |
|---|---|
setItemImageShape |
getItemSize
@ExperimentalCarApi
fun getItemSize(): Int
Returns the grid item size, which applies to all grid items in the template.
| See also | |
|---|---|
setItemSize |
getSingleList
fun getSingleList(): ItemList?
Returns the ItemList instance that contains the grid items to display or
null if not set.
| See also | |
|---|---|
setSingleList |
isLoading
fun isLoading(): Boolean
Returns whether the template is loading.
| See also | |
|---|---|
setLoading |