com.actionbarsherlock.internal.view.menu

Class ListMenuPresenter

java.lang.Object

com.actionbarsherlock.internal.view.menu.ListMenuPresenter

All Implemented Interfaces:

android.widget.AdapterView.OnItemClickListener, MenuPresenter

public class ListMenuPresenter
extends Object
implements MenuPresenter, android.widget.AdapterView.OnItemClickListener

Nested Class Summary

Nested classes/interfaces inherited from interface com.actionbarsherlock.internal.view.menu.MenuPresenter

MenuPresenter.Callback

Field Summary

Fields

Modifier and Type	Field and Description
static String	VIEWS_TAG

Constructor Summary

Constructors

Constructor and Description
ListMenuPresenter(android.content.Context context, int itemLayoutRes)
ListMenuPresenter(int itemLayoutRes, int themeRes)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	collapseItemActionView(MenuBuilder menu, MenuItemImpl item) Called when a menu item with a collapsable action view should collapse its action view.
boolean	expandItemActionView(MenuBuilder menu, MenuItemImpl item) Called when a menu item with a collapsable action view should expand its action view.
boolean	flagActionItems() Called by Menu implementations to flag items that will be shown as actions.
android.widget.ListAdapter	getAdapter()
int	getId() Returns an ID for determining how to save/restore instance state.
MenuView	getMenuView(android.view.ViewGroup root) Retrieve a MenuView to display the menu specified in #initForMenu(Context, Menu).
void	initForMenu(android.content.Context context, MenuBuilder menu) Initialize this presenter for the given context and menu.
void	onCloseMenu(MenuBuilder menu, boolean allMenusAreClosing) Called by Menu implementations to indicate that a menu or submenu is closing.
void	onItemClick(android.widget.AdapterView<?> parent, android.view.View view, int position, long id)
void	onRestoreInstanceState(android.os.Parcelable state) Supplies the previously saved instance state to be restored.
android.os.Parcelable	onSaveInstanceState() Returns a Parcelable describing the current state of the presenter.
boolean	onSubMenuSelected(SubMenuBuilder subMenu) Called by Menu implementations to indicate that a submenu item has been selected.
void	restoreHierarchyState(android.os.Bundle inState)
void	saveHierarchyState(android.os.Bundle outState)
void	setCallback(MenuPresenter.Callback cb) Set a callback object that will be notified of menu events related to this specific presentation.
void	setId(int id)
void	setItemIndexOffset(int offset)
void	updateMenuView(boolean cleared) Update the menu UI in response to a change.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

VIEWS_TAG

public static final String VIEWS_TAG

See Also:

Constant Field Values

Constructor Detail

ListMenuPresenter

public ListMenuPresenter(android.content.Context context,
                 int itemLayoutRes)

ListMenuPresenter

public ListMenuPresenter(int itemLayoutRes,
                 int themeRes)

Method Detail

collapseItemActionView

public boolean collapseItemActionView(MenuBuilder menu,
                             MenuItemImpl item)

Description copied from interface: MenuPresenter

Called when a menu item with a collapsable action view should collapse its action view.

Specified by:

collapseItemActionView in interface MenuPresenter

Parameters:

menu - Menu containing the item to be collapsed

item - Item to be collapsed

Returns:

true if this presenter collapsed the action view, false otherwise.

expandItemActionView

public boolean expandItemActionView(MenuBuilder menu,
                           MenuItemImpl item)

Description copied from interface: MenuPresenter

Called when a menu item with a collapsable action view should expand its action view.

Specified by:

expandItemActionView in interface MenuPresenter

Parameters:

menu - Menu containing the item to be expanded

item - Item to be expanded

Returns:

true if this presenter expanded the action view, false otherwise.

flagActionItems

public boolean flagActionItems()

Description copied from interface: MenuPresenter

Called by Menu implementations to flag items that will be shown as actions.

Specified by:

flagActionItems in interface MenuPresenter

Returns:

true if this presenter changed the action status of any items.

getAdapter

public android.widget.ListAdapter getAdapter()

getId

public int getId()

Description copied from interface: MenuPresenter

Returns an ID for determining how to save/restore instance state.

Specified by:

getId in interface MenuPresenter

Returns:

a valid ID value.

getMenuView

public MenuView getMenuView(android.view.ViewGroup root)

Description copied from interface: MenuPresenter

Retrieve a MenuView to display the menu specified in #initForMenu(Context, Menu).

Specified by:

getMenuView in interface MenuPresenter

Parameters:

root - Intended parent of the MenuView.

Returns:

A freshly created MenuView.

initForMenu

public void initForMenu(android.content.Context context,
               MenuBuilder menu)

Description copied from interface: MenuPresenter

Initialize this presenter for the given context and menu. This method is called by MenuBuilder when a presenter is added. See MenuBuilder.addMenuPresenter(MenuPresenter)

Specified by:

initForMenu in interface MenuPresenter

Parameters:

context - Context for this presenter; used for view creation and resource management

menu - Menu to host

onCloseMenu

public void onCloseMenu(MenuBuilder menu,
               boolean allMenusAreClosing)

Description copied from interface: MenuPresenter

Called by Menu implementations to indicate that a menu or submenu is closing. Presenter implementations should close the representation of the menu indicated as necessary and notify a registered callback.

Specified by:

onCloseMenu in interface MenuPresenter

Parameters:

menu - Menu or submenu that is closing.

allMenusAreClosing - True if all associated menus are closing.

onItemClick

public void onItemClick(android.widget.AdapterView<?> parent,
               android.view.View view,
               int position,
               long id)

Specified by:

onItemClick in interface android.widget.AdapterView.OnItemClickListener

onRestoreInstanceState

public void onRestoreInstanceState(android.os.Parcelable state)

Description copied from interface: MenuPresenter

Supplies the previously saved instance state to be restored.

Specified by:

onRestoreInstanceState in interface MenuPresenter

Parameters:

state - The previously saved instance state

onSaveInstanceState

public android.os.Parcelable onSaveInstanceState()

Description copied from interface: MenuPresenter

Returns a Parcelable describing the current state of the presenter. It will be passed to the MenuPresenter.onRestoreInstanceState(Parcelable) method of the presenter sharing the same ID later.

Specified by:

onSaveInstanceState in interface MenuPresenter

Returns:

The saved instance state

onSubMenuSelected

public boolean onSubMenuSelected(SubMenuBuilder subMenu)

Description copied from interface: MenuPresenter

Called by Menu implementations to indicate that a submenu item has been selected. An active Callback should be notified, and if applicable the presenter should present the submenu.

Specified by:

onSubMenuSelected in interface MenuPresenter

Parameters:

subMenu - SubMenu being opened

Returns:

true if the the event was handled, false otherwise.

restoreHierarchyState

public void restoreHierarchyState(android.os.Bundle inState)

saveHierarchyState

public void saveHierarchyState(android.os.Bundle outState)

setCallback

public void setCallback(MenuPresenter.Callback cb)

Description copied from interface: MenuPresenter

Set a callback object that will be notified of menu events related to this specific presentation.

Specified by:

setCallback in interface MenuPresenter

Parameters:

cb - Callback that will be notified of future events

setId

public void setId(int id)

setItemIndexOffset

public void setItemIndexOffset(int offset)

updateMenuView

public void updateMenuView(boolean cleared)

Description copied from interface: MenuPresenter

Update the menu UI in response to a change. Called by MenuBuilder during the normal course of operation.

Specified by:

updateMenuView in interface MenuPresenter

Parameters:

cleared - true if the menu was entirely cleared