public class

GridView

extends AbsListView

java.lang.Object
↳	com.neomades.ui.View
	↳	com.neomades.ui.AbsListView
		↳	com.neomades.ui.GridView

Class Overview

A GridView is a grid of views, where only one view could clicked at the same time.

Each view could be different.

Asynchronous data loading with Adapter

First, this grid could load views with adapter instead of calling addView(). Do not call addView() and provide an adapter to be called by this grid when the element becomes visible.

The Adapter has two methods : getCount() and getView() that help grids and lists to load items.

getCount() is called when data is ready to be loaded. This grid will know how many items should be displayed. After that, getView(int, View, View) will be called when a item becomes visible.

When data has changed, be sure calling the notifyDataChanged() method to let the grid or list refreshing views.

Summary

XML Attributes
Attribute Name	Related Method	Description
listIndicatorVisible	setListIndicatorVisible(boolean)

[Expand]

Inherited XML Attributes

From class com.neomades.ui.AbsListView

From class com.neomades.ui.View

Constants
int	STYLE_GROUPED	A ListView whose sections present distinct groups of rows.
int	STYLE_PLAIN	A plain ListView.

[Expand]

Inherited Constants

From interface com.neomades.ui.Alignment

From interface com.neomades.ui.StretchMode

Public Constructors
	GridView() Creates a new grid view.
	GridView(int style) Sets the iOS UITableView style.

Public Methods
void	scrollToTop() Move the scroll position to the first item of the `GridView`.
void	setColumnAlignment(int columnIndex, int alignment) Sets the column alignment with `Alignment` constants for the column specified in the parameter.
void	setColumnWidth(int width) Sets the column width in DP unit for every column.
void	setHorizontalSpacing(int space) Set the amount of horizontal (x) spacing to place between each item in the grid.
void	setListIndicatorVisible(boolean indicatorVisible) Displays or hide the list indicator (generally something that represents an arrow at the tight of the ListView cell).
void	setNumColumns(int numColumns) Sets the number of columns of this `GridView`.
void	setRowHeight(int height) Sets the row height in DP unit for every row.
void	setRowHeightAdapter(RowHeightAdapter rowHeightAdapter) Sets an adapter for row heights.
void	setSectionsVisible(boolean visible) Enables or not section items in the list.
void	setVerticalSpacing(int space) Set the amount of vertical (y) spacing to place between each item in the grid.

[Expand]

Inherited Methods

From class com.neomades.ui.AbsListView

void	addView(View view, int atIndex) Inserts a view at a specified position.
void	addView(View view) Add a new item view to the list.
int	getViewsCount() Returns the number of views inside this container.
void	notifyDataChanged() Notifies the list that data has changed and the list should update the UI.
void	removeAllViews() Remove all views from this container.
void	removeIndex(int index) Remove a view at the specified `index`.
void	removeView(View view) Remove a view from this list.
void	setFadingEdgeColor(Color color) Sets the fading edge color.
void	setFadingEdgeEnabled(boolean enabled) Sets if the vertical/horizontal edges should be faded when this view is scrolled vertically/horizontally.
void	setFadingEdgeLength(int length) Sets the fading edge length
void	setFastScrollEnabled(boolean enabled) Specifies whether fast scrolling is enabled or disabled.
void	setHorizontalScrollBarEnabled(boolean scrollBarEnabled) Displays or hides the horizontal scroll bar.
void	setIndexerEnabled(boolean indexerEnabled) Enables or not the alphabetic indexer.
void	setIndexes(String[] indexes) Sets a specific list of indexes to show on the right of the list.
void	setItemClickedListener(ItemClickedListener listener) Set the item clicked listener.
void	setItemTypeAdapter(ItemTypeAdapter itemTypeAdapter) Sets the adapter that provides the data type to differentiate the data item views in this widget.
void	setListAdapter(ListAdapter adapter) Sets the adapter that provides the views to represent the data in this list.
void	setListIndexer(ListIndexer indexer) Sets the alphabetical indexer at the right of the list.
void	setListScrollListener(ListScrollListener listener) Associates a `ListSrollListener` with this ListView.
void	setRowHeight(int height) Sets the row height in DP unit for every row.
void	setSectionsVisible(boolean visible) Enables or not section items in the list.
void	setSelectionColor(Color selectionColor) Changes the default color that is applied when a user select an item.
void	setSelectionColorEnabled(boolean selectionEnabled) Enables or disables the fact that the colors of an item changes when an user selects it.
void	setSeparatorColor(Color separatorColor) Changes the color of the separators between each items of the list.
void	setSeparatorHeight(int height) Sets the size of the separator between two items of the list.
void	setSeparatorVisible(boolean visible) Displays or hide the separator (usually a line) between between each items in the list.
void	setVerticalScrollBarEnabled(boolean scrollBarEnabled) Displays or hides the vertical scroll bar.

From class com.neomades.ui.View

View	findView(int viewId) Find view by Id.
int	getId() Returns the identifier of this element, by default all elements return "0".
Object	getTag() Returns this view's tag.
static View	inflateXML(int layoutResId) Inflate view from XMLLayout declared in the URS File.
static View	inflateXML(InputStream xmlStream) @return
boolean	isClickable() Returns if the view is clickable.
boolean	isEnabled() Return a boolean indicating if the view is enabled or not
boolean	isFocusable() Returns if the view is focusable (for the devices that have a keyboard Ui navigation).
boolean	isVisible() Returns if the view is visible
void	runOnUiThread(Runnable action) Calls `action.run()` asynchronously on the `UI-Thread`.
void	setBackground(Background background) Sets the background on this view.
void	setBackground(int backgroundResId) Sets the background on this view with a XML background definition.
void	setBackgroundColor(Color color) Sets the background color on this view.
void	setBackgroundImage(int imageID) Set the background image for this view.
void	setBackgroundImage(Image image) Set the background image for this view.
void	setBorderColor(Color borderColor) Sets the border color on this view.
void	setBorderWidth(int widthInDp) Set the border width (size) in DP units.
void	setClickListener(ClickListener clickListener) Sets a ClickListener to this view.
void	setClickable(boolean clickable) Sets this view clickable.
void	setCornerRadius(int radiusSize) Set the four corners radius, if the view has corners.
void	setDrawingCacheEnabled(boolean enabled) Enables or disables the drawing cache.
void	setEnabled(boolean enabled) Sets the state of this view to enabled or disabled.
void	setFocusable(boolean focusable) Sets the view focusable.
void	setGestureDetector(GestureDetector detector) Sets a `GestureDetector` on this view.
void	setHeight(int heightDp) Sets the height of the view, in dp units (density-independent pixels).
void	setId(int id) Sets a identifier/tag to this element
void	setInvalidateDisabled(boolean disabled) If set to true, force the layout that contains the view to not be draw again when its content changes.
void	setLayoutAlignment(int alignment) Sets the view alignment into its parent.
void	setMargin(int uniformMarginDp) Set the margin outside this view (used by `Layout`), by setting on each side the given value.
void	setMargin(int leftDp, int topDp, int rightDp, int bottomDp) Set the margin outside this view (used by `Layout`).
void	setMarginBottom(int marginBottomDp) Sets the bottom margin with the given value.
void	setMarginLeft(int marginLeftDp) Sets the left margin with the given value.
void	setMarginRight(int marginRightDp) Sets the right margin with the given value.
void	setMarginTop(int marginTopDp) Sets the top margin with the given value.
void	setPadding(int leftDp, int topDp, int rightDp, int bottomDp) Sets the view padding.
void	setPadding(int uniformPaddingDp) Sets the view padding, with for each side the value given in parameter.
void	setPaddingBottom(int paddingBottomDp) Sets the bottom padding with the given value.
void	setPaddingLeft(int paddingLeftDp) Sets the left padding with the given value.
void	setPaddingRight(int paddingRightDp) Sets the right padding with the given value.
void	setPaddingTop(int paddingTopDp) Sets the top padding with the given value.
void	setSize(int widthDp, int heightDp) Sets the size of the view, in dp units (density-independent pixels).
void	setStretchHorizontalMode(int widthMode) Sets the stretch horizontal mode.
void	setStretchMode(int horizontalMode, int verticalMode) Sets the view content stretch mode.
void	setStretchVerticalMode(int heightMode) Sets the stretch vertical mode.
void	setStyle(int styleResId)
void	setStyle(Style style)
void	setTag(Object tag) Sets the tag associated with this view.
void	setTouchListener(TouchListener touchListener) Register a listener to be invoked when a touch event is dispatched to this view.
void	setTransformOrigin(float xOrigin, float yOrigin) Sets the x and y location of the point around which the view will be scaled or rotated when an animation occurs.
void	setVisible(boolean visible) Sets the view's visibility : visible or invisible/hidden
void	setWidth(int widthDp) Sets the width of the view, in dp units (density-independent pixels).

From class java.lang.Object

boolean	equals(Object obj) Indicates whether some other object is "equal to" this one.
final Class<?>	getClass() Returns the runtime class of an object.
int	hashCode() Returns a hash code value for the object.
final void	notify() Wakes up a single thread that is waiting on this object's monitor.
final void	notifyAll() Wakes up all threads that are waiting on this object's monitor.
String	toString() Returns a string representation of the object.
final void	wait(long timeout, int nanos) Causes current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
final void	wait(long timeout) Causes current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
final void	wait() Causes current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

XML Attributes

listIndicatorVisible

Related Methods

setListIndicatorVisible(boolean)

Constants

public static final int STYLE_GROUPED

A ListView whose sections present distinct groups of rows. The section headers and footers do not float.

Constant Value: 1 (0x00000001)

public static final int STYLE_PLAIN

A plain ListView. Any section headers or footers are displayed as inline separators and float when the ListView is scrolled.

Constant Value: 0 (0x00000000)

Public Constructors

public GridView ()

Creates a new grid view.

public GridView (int style)

Sets the iOS UITableView style. (Only for iOS)

Parameters

style	STYLE_PLAIN (default) or STYLE_GROUPED

Public Methods

public void scrollToTop ()

Move the scroll position to the first item of the GridView.

public void setColumnAlignment (int columnIndex, int alignment)

Sets the column alignment with Alignment constants for the column specified in the parameter.

A column alignment could be set if the view given by the adapter is in MATCH_CONTENT mode or has a fixed width.

By default, the left alignment is set.

Parameters

columnIndex	0 for the first column, a positive value for other columns, should be less than the number of columns
alignment	`LEFT`, `HCENTER` , `RIGHT`

public void setColumnWidth (int width)

Sets the column width in DP unit for every column.

Use this method to apply the same width to all columns.

Parameters

width	the column width in DP

public void setHorizontalSpacing (int space)

Set the amount of horizontal (x) spacing to place between each item in the grid.

Parameters

space	The amount of horizontal space between items, in DP unit.

public void setListIndicatorVisible (boolean indicatorVisible)

Displays or hide the list indicator (generally something that represents an arrow at the tight of the ListView cell).

Related XML Attributes

listIndicatorVisible

Parameters

indicatorVisible	true to display the indicator

public void setNumColumns (int numColumns)

Sets the number of columns of this GridView.

Parameters

numColumns	number of columns

Throws

CrossThreadException	if the method is called from outside the UI-Thread

public void setRowHeight (int height)

Sets the row height in DP unit for every row.

Use this method if this is the same row height for each row.

This method could not be used if a RowHeightAdapter is set. See setRowHeightAdapter(RowHeightAdapter)

Parameters

height	the row height in DP

public void setRowHeightAdapter (RowHeightAdapter rowHeightAdapter)

Sets an adapter for row heights.

The adapter gives an height for each row (could be different).

Parameters

rowHeightAdapter	an adapter or null

public void setSectionsVisible (boolean visible)

Enables or not section items in the list.

Cross Platform considerations

This method does nothing on Android.

Parameters

visible	true to show sections

public void setVerticalSpacing (int space)

Set the amount of vertical (y) spacing to place between each item in the grid.

Parameters

space	The amount of vertical space between items, in DP unit.

Interfaces

Classes

Enums

Exceptions

GridView

Class Overview

Asynchronous data loading with Adapter

See Also

Summary

XML Attributes

listIndicatorVisible

Related Methods

Constants

public static final int STYLE_GROUPED

public static final int STYLE_PLAIN

Public Constructors

public GridView ()

public GridView (int style)

Parameters

See Also

Public Methods

public void scrollToTop ()

public void setColumnAlignment (int columnIndex, int alignment)

Parameters

See Also

public void setColumnWidth (int width)

Parameters

public void setHorizontalSpacing (int space)

Parameters

public void setListIndicatorVisible (boolean indicatorVisible)

Related XML Attributes

Parameters

public void setNumColumns (int numColumns)

Parameters

Throws

public void setRowHeight (int height)

Parameters

See Also

public void setRowHeightAdapter (RowHeightAdapter rowHeightAdapter)

Parameters

public void setSectionsVisible (boolean visible)

Cross Platform considerations

Parameters

public void setVerticalSpacing (int space)

Parameters