File	Doc	Category	Size	Date	Package
PopupMenu.java	API Doc	Android 5.1 API	9418	Thu Mar 12 22:22:10 GMT 2015	android.widget

PopupMenu

• java.lang.Object

Fields Summary
private final android.content.Context	mContext
private final com.android.internal.view.menu.MenuBuilder	mMenu
private final android.view.View	mAnchor
private final com.android.internal.view.menu.MenuPopupHelper	mPopup
private OnMenuItemClickListener	mMenuItemClickListener
private OnDismissListener	mDismissListener
private android.view.View.OnTouchListener	mDragListener

Constructors Summary
public PopupMenu(android.content.Context context, android.view.View anchor) Constructor to create a new popup menu with an anchor view. param context Context the popup menu is running in, through which it can access the current theme, resources, etc. param anchor Anchor view for this popup. The popup will appear below the anchor if there is room, or above it if there is not. this(context, anchor, Gravity.NO_GRAVITY);
public PopupMenu(android.content.Context context, android.view.View anchor, int gravity) Constructor to create a new popup menu with an anchor view and alignment gravity. param context Context the popup menu is running in, through which it can access the current theme, resources, etc. param anchor Anchor view for this popup. The popup will appear below the anchor if there is room, or above it if there is not. param gravity The {@link Gravity} value for aligning the popup with its anchor. this(context, anchor, gravity, R.attr.popupMenuStyle, 0);
public PopupMenu(android.content.Context context, android.view.View anchor, int gravity, int popupStyleAttr, int popupStyleRes) Constructor a create a new popup menu with a specific style. param context Context the popup menu is running in, through which it can access the current theme, resources, etc. param anchor Anchor view for this popup. The popup will appear below the anchor if there is room, or above it if there is not. param gravity The {@link Gravity} value for aligning the popup with its anchor. param popupStyleAttr An attribute in the current theme that contains a reference to a style resource that supplies default values for the popup window. Can be 0 to not look for defaults. param popupStyleRes A resource identifier of a style resource that supplies default values for the popup window, used only if popupStyleAttr is 0 or can not be found in the theme. Can be 0 to not look for defaults. mContext = context; mMenu = new MenuBuilder(context); mMenu.setCallback(this); mAnchor = anchor; mPopup = new MenuPopupHelper(context, mMenu, anchor, false, popupStyleAttr, popupStyleRes); mPopup.setGravity(gravity); mPopup.setCallback(this);

Methods Summary
public void	dismiss() Dismiss the menu popup. see #show() mPopup.dismiss();
public android.view.View.OnTouchListener	getDragToOpenListener() Returns an {@link OnTouchListener} that can be added to the anchor view to implement drag-to-open behavior. When the listener is set on a view, touching that view and dragging outside of its bounds will open the popup window. Lifting will select the currently touched list item. Example usage: PopupMenu myPopup = new PopupMenu(context, myAnchor); myAnchor.setOnTouchListener(myPopup.getDragToOpenListener()); return a touch listener that controls drag-to-open behavior if (mDragListener == null) { mDragListener = new ForwardingListener(mAnchor) { @Override protected boolean onForwardingStarted() { show(); return true; } @Override protected boolean onForwardingStopped() { dismiss(); return true; } @Override public ListPopupWindow getPopup() { // This will be null until show() is called. return mPopup.getPopup(); } }; } return mDragListener;
public android.view.Menu	getMenu() return the {@link Menu} associated with this popup. Populate the returned Menu with items before calling {@link #show()}. see #show() see #getMenuInflater() return mMenu;
public android.view.MenuInflater	getMenuInflater() return a {@link MenuInflater} that can be used to inflate menu items from XML into the menu returned by {@link #getMenu()}. see #getMenu() return new MenuInflater(mContext);
public void	inflate(int menuRes) Inflate a menu resource into this PopupMenu. This is equivalent to calling popupMenu.getMenuInflater().inflate(menuRes, popupMenu.getMenu()). param menuRes Menu resource to inflate getMenuInflater().inflate(menuRes, mMenu);
public void	onCloseMenu(com.android.internal.view.menu.MenuBuilder menu, boolean allMenusAreClosing) hide if (mDismissListener != null) { mDismissListener.onDismiss(this); }
public void	onCloseSubMenu(com.android.internal.view.menu.SubMenuBuilder menu) hide
public boolean	onMenuItemSelected(com.android.internal.view.menu.MenuBuilder menu, android.view.MenuItem item) hide if (mMenuItemClickListener != null) { return mMenuItemClickListener.onMenuItemClick(item); } return false;
public void	onMenuModeChange(com.android.internal.view.menu.MenuBuilder menu) hide
public boolean	onOpenSubMenu(com.android.internal.view.menu.MenuBuilder subMenu) hide if (subMenu == null) return false; if (!subMenu.hasVisibleItems()) { return true; } // Current menu will be dismissed by the normal helper, submenu will be shown in its place. new MenuPopupHelper(mContext, subMenu, mAnchor).show(); return true;
public void	setOnDismissListener(android.widget.PopupMenu$OnDismissListener listener) Set a listener that will be notified when this menu is dismissed. param listener Listener to notify mDismissListener = listener;
public void	setOnMenuItemClickListener(android.widget.PopupMenu$OnMenuItemClickListener listener) Set a listener that will be notified when the user selects an item from the menu. param listener Listener to notify mMenuItemClickListener = listener;
public void	show() Show the menu popup anchored to the view specified during construction. see #dismiss() mPopup.show();