public class

StandardDashboard

extends LinearLayout
java.lang.Object
   ↳ android.view.View
     ↳ android.view.ViewGroup
       ↳ android.widget.LinearLayout
         ↳ com.droidux.pack.action.widget.StandardDashboard
Known Direct Subclasses

Class Overview

A standard implementation of a dashboard widget. This widget host a set of ActionInterfaces.Item.ActionItem to showcase the most prominent features of your app. The number of action items that can be displayed in this dashboard is limited by the value specified by the dux_columns and dux_rows.

This widget will automatically adjust itself when the screen orientation is changed (e.g. from portrait to landscape).

Summary

XML Attributes
Attribute Name Related Method Description
dux_columns Specifies the number of columns in a page, when the screen is in 'portrait' mode. 
dux_drawableEffect_colors Specifies the colors for the effect to be applied to the action drawable. 
dux_drawableEffect_type Specifies the effect to be applied to an action's icon/drawable. 
dux_glow_radius Specifies the radius of the glow around the action icon when the dux_drawableEffect_type is set to glow
dux_item_layoutId Specifies the layout resource identifier to be used for the dashboard item. 
dux_page_width Specifies the width of the workspace/dashboard. 
dux_rows Specifies the number of rows in a page, when the screen is in 'portrait' mode. 
[Expand]
Inherited Constants
From class android.widget.LinearLayout
From class android.view.ViewGroup
From class android.view.View
[Expand]
Inherited Fields
From class android.view.View
Public Constructors
StandardDashboard(Context context)
StandardDashboard(Context context, AttributeSet attrs)
Public Methods
void addView(View child, int index, ViewGroup.LayoutParams params)
Adds a child view with the specified layout parameters.
ActionInterfaces.Layout.ActionLayoutInterface beginLayout()
Begins the layout process to define the ActionInterfaces.Item.ActionItem that should be hosted by this action container.
void onEndLayout(ActionInterfaces.Layout.ActionLayoutInterface layout)
Called when the layout process has ended (for internal use only, you normally don't need to call/override this method).
Protected Methods
boolean getMultiPageMode()
[Expand]
Inherited Methods
From class android.widget.LinearLayout
From class android.view.ViewGroup
From class android.view.View
From class java.lang.Object
From interface android.graphics.drawable.Drawable.Callback
From interface android.view.KeyEvent.Callback
From interface android.view.ViewManager
From interface android.view.ViewParent
From interface android.view.accessibility.AccessibilityEventSource

XML Attributes

dux_columns

Since: API Level

Specifies the number of columns in a page, when the screen is in 'portrait' mode. When the screen orientation is changed to 'landscape', this value will define the number of rows instead of columns.

Related Methods

dux_drawableEffect_colors

Since: API Level

Specifies the colors for the effect to be applied to the action drawable.

May be a reference to another resource, in the form "@[+][package:]type:name" or to a theme attribute in the form "?[package:][type:]name".

May be a color value, in the form of "#rgb", "#argb", "#rrggbb", or "#aarrggbb".

Related Methods

dux_drawableEffect_type

Since: API Level

Specifies the effect to be applied to an action's icon/drawable. The colors of the effect can be specified using the dux_drawableEffect_colors attribute.

Default is none.

Must be one of the following constant values.

ConstantValueDescription
none0 No effect will be applied.
glow1 The 'glow' effect will be applied to the action drawable.
colorize2 The 'colorize' effect will be applied to the action drawable.

Related Methods

dux_glow_radius

Since: API Level

Specifies the radius of the glow around the action icon when the dux_drawableEffect_type is set to glow.

Related Methods

dux_item_layoutId

Since: API Level

Specifies the layout resource identifier to be used for the dashboard item.

Important: the custom layout must contain a TextView, or its descendants, with the identifier set to "dux_dashButton".

Must be a reference to another resource, in the form "@[+][package:]type:name" or to a theme attribute in the form "?[package:][type:]name".

Related Methods

dux_page_width

Since: API Level

Specifies the width of the workspace/dashboard. Its value may be a dimension (such as "480dip") for a constant width or one of the special constants.

May be a dimension value, which is a floating point number appended with a unit such as "480.0sp". Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size), in (inches), mm (millimeters).

This may also be a reference to a resource (in the form "@[package:]type:name") or theme attribute (in the form "?[package:][type:]name") containing a value of this type.

May be one of the following constant values.

ConstantValueDescription
fill_parent-1 Fill the parent space.

Related Methods

dux_rows

Since: API Level

Specifies the number of rows in a page, when the screen is in 'portrait' mode. When the screen orientation is changed to 'landscape', this value will define the number of columns instead of rows.

Related Methods

Public Constructors

public StandardDashboard (Context context)

Since: API Level 2.5

public StandardDashboard (Context context, AttributeSet attrs)

Since: API Level 2.5

Public Methods

public void addView (View child, int index, ViewGroup.LayoutParams params)

Since: API Level

Adds a child view with the specified layout parameters.

Note: do not invoke this method from draw(android.graphics.Canvas), onDraw(android.graphics.Canvas), dispatchDraw(android.graphics.Canvas) or any related method.

Parameters
child the child view to add
index the position at which to add the child
params the layout parameters to set on the child

public ActionInterfaces.Layout.ActionLayoutInterface beginLayout ()

Since: API Level 2.5

Begins the layout process to define the ActionInterfaces.Item.ActionItem that should be hosted by this action container.

Important: When you finish adding the ActionInterfaces.Item.ActionItem to the container, you need to call the endLayout() to end the layout process.

public void onEndLayout (ActionInterfaces.Layout.ActionLayoutInterface layout)

Since: API Level 2.5

Called when the layout process has ended (for internal use only, you normally don't need to call/override this method).

Protected Methods

protected boolean getMultiPageMode ()

Since: API Level