android_translation_layer/src/api-impl/android/widget/PopupMenu.java

/*
 * Copyright (C) 2010 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package android.widget;

import android.content.Context;
import android.content.res.TypedArray;
import android.content.res.XmlResourceParser;
import android.graphics.drawable.Drawable;
import android.view.Gravity;
import android.view.Menu;
import android.view.MenuInflater;
import android.view.MenuItem;
import android.view.SubMenu;
import android.view.View;
import android.view.View.OnTouchListener;

import org.xmlpull.v1.XmlPullParser;

import com.android.internal.R;

/**
 * A PopupMenu displays a {@link Menu} in a modal popup window anchored to a
 * {@link View}. The popup will appear below the anchor view if there is room,
 * or above it if there is not. If the IME is visible the popup will not
 * overlap it until it is touched. Touching outside of the popup will dismiss
 * it.
 */

public class PopupMenu {
	private final Context mContext;
	private final View mAnchor;
	private OnMenuItemClickListener mMenuItemClickListener;
	private OnDismissListener mOnDismissListener;
	private OnTouchListener mDragListener;
	private long popover;

	/**
	 * 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.
	 */
	public PopupMenu(Context context, View anchor) {
		this(context, anchor, Gravity.NO_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.
	 */
	public PopupMenu(Context context, View anchor, int gravity) {
		this(context, anchor, gravity, R.attr.popupMenuStyle, 0);
	}
	/**
	 * 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.
	 */
	public PopupMenu(Context context, View anchor, int gravity, int popupStyleAttr,
			int popupStyleRes) {
		mContext = context;
		mAnchor = anchor;
	}

	/**
	 * @return a {@link MenuInflater} that can be used to inflate menu items
	 *         from XML into the menu returned by {@link #getMenu()}
	 * @see #getMenu()
	 */
	public MenuInflater getMenuInflater() {
		return new MenuInflater(mContext);
	}

	/**
	 * Sets a listener that will be notified when the user selects an item from
	 * the menu.
	 *
	 * @param listener the listener to notify
	 */
	public void setOnMenuItemClickListener(OnMenuItemClickListener listener) {
		mMenuItemClickListener = listener;
	}

	/**
	 * Sets a listener that will be notified when this menu is dismissed.
	 *
	 * @param listener the listener to notify
	 */
	public void setOnDismissListener(OnDismissListener listener) {
		mOnDismissListener = listener;
	}

	protected native long native_init();
	protected native void native_appendItem(long menu, String item, int id);
	protected native long native_buildPopover(long menu);
	protected native void native_show(long popover, long anchor);

	// callback from native code
	protected void menuItemClickCallback(final int id) {
		if (mMenuItemClickListener != null) {
			mMenuItemClickListener.onMenuItemClick(new MenuItem() {

				@Override
				public MenuItem setIcon(int iconRes) {
					// TODO Auto-generated method stub
					throw new UnsupportedOperationException("Unimplemented method 'setIcon'");
				}

				@Override
				public MenuItem setVisible(boolean visible) {
					// TODO Auto-generated method stub
					throw new UnsupportedOperationException("Unimplemented method 'setVisible'");
				}

				@Override
				public MenuItem setChecked(boolean checked) {
					// TODO Auto-generated method stub
					throw new UnsupportedOperationException("Unimplemented method 'setChecked'");
				}

				@Override
				public MenuItem setEnabled(boolean enabled) {
					// TODO Auto-generated method stub
					throw new UnsupportedOperationException("Unimplemented method 'setEnabled'");
				}

				@Override
				public MenuItem setCheckable(boolean checkable) {
					// TODO Auto-generated method stub
					throw new UnsupportedOperationException("Unimplemented method 'setCheckable'");
				}

				@Override
				public MenuItem setTitleCondensed(CharSequence titleCondensed) {
					// TODO Auto-generated method stub
					throw new UnsupportedOperationException("Unimplemented method 'setTitleCondensed'");
				}

				@Override
				public MenuItem setTitle(CharSequence title) {
					// TODO Auto-generated method stub
					throw new UnsupportedOperationException("Unimplemented method 'setTitle'");
				}

				@Override
				public MenuItem setActionView(View actionView) {
					// TODO Auto-generated method stub
					throw new UnsupportedOperationException("Unimplemented method 'setActionView'");
				}

				@Override
				public void setShowAsAction(int action) {
					// TODO Auto-generated method stub
					throw new UnsupportedOperationException("Unimplemented method 'setShowAsAction'");
				}

				@Override
				public int getItemId() {
					return id;
				}

				@Override
				public int getGroupId() {
					// TODO Auto-generated method stub
					throw new UnsupportedOperationException("Unimplemented method 'getGroupId'");
				}

				@Override
				public MenuItem setOnMenuItemClickListener(OnMenuItemClickListener listener) {
					// TODO Auto-generated method stub
					throw new UnsupportedOperationException("Unimplemented method 'setOnMenuItemClickListener'");
				}

				@Override
				public MenuItem setTitle(int resId) {
					// TODO Auto-generated method stub
					throw new UnsupportedOperationException("Unimplemented method 'setTitle'");
				}

				@Override
				public boolean isVisible() {
					// TODO Auto-generated method stub
					throw new UnsupportedOperationException("Unimplemented method 'isVisible'");
				}

				@Override
				public Drawable getIcon() {
					// TODO Auto-generated method stub
					throw new UnsupportedOperationException("Unimplemented method 'getIcon'");
				}

				@Override
				public SubMenu getSubMenu() {
					// TODO Auto-generated method stub
					throw new UnsupportedOperationException("Unimplemented method 'getSubMenu'");
				}
			});
		}
	}

	/**
	 * Inflate a menu resource into this PopupMenu. This is equivalent to
	 * calling {@code popupMenu.getMenuInflater().inflate(menuRes, popupMenu.getMenu())}.
	 *
	 * @param menuRes Menu resource to inflate
	 * @throws Exception 
	 */
	public void inflate(int menuRes) throws Exception {
		XmlResourceParser parser = mContext.getResources().getXml(menuRes);
		int type;
		while ((type=parser.next()) != XmlPullParser.START_TAG && type != XmlPullParser.END_DOCUMENT);
		if (type == XmlPullParser.START_TAG && "menu".equals(parser.getName())) {
			long menu = native_init();
			while ((type = parser.next()) != XmlPullParser.END_DOCUMENT) {
				if (type == XmlPullParser.START_TAG && "item".equals(parser.getName())) {
					final TypedArray a = mContext.getResources().obtainAttributes(parser, R.styleable.MenuItem);
					native_appendItem(menu, a.getString(R.styleable.MenuItem_title), a.getResourceId(R.styleable.MenuItem_id, -1));
					a.recycle();
				}
			}
			popover = native_buildPopover(menu);
		}
	}

	/**
	* Show the menu popup anchored to the view specified during construction.
	*
	* @see #dismiss()
	*/
	public void show() {
		System.out.println("PopupMenu.show() called");
		native_show(popover, mAnchor.widget);
	}

	/**
	 * Interface responsible for receiving menu item click events if the items
	 * themselves do not have individual item click listeners.
	 */
	public interface OnMenuItemClickListener {
		/**
		 * This method will be invoked when a menu item is clicked if the item
		 * itself did not already handle the event.
		 *
		 * @param item the menu item that was clicked
		 * @return {@code true} if the event was handled, {@code false}
		 *         otherwise
		 */
		boolean onMenuItemClick(MenuItem item);
	}

	/**
	 * Callback interface used to notify the application that the menu has closed.
	 */
	public interface OnDismissListener {
		/**
		 * Called when the associated menu has been dismissed.
		 *
		 * @param menu the popup menu that was dismissed
		 */
		void onDismiss(PopupMenu menu);
	}

}