/*
* 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, ei
ther express or implied.
* See
the License for
the specific language governing permissions and
* limitations under
the License.
*/
package android.widget;
import android.annotation.
MenuRes;
import android.annotation.TestApi;
import android.compat.annotation.UnsupportedAppUsage;
import android.content.Context;
import android.os.Build;
import android.view.Gravity;
import android.view.
Menu;
import android.view.
MenuInflater;
import android.view.
MenuItem;
import android.view.View;
import android.view.View.OnTouchListener;
import com.android.internal.R;
import com.android.internal.view.
menu.
MenuBuilder;
import com.android.internal.view.
menu.
MenuPopupHelper;
import com.android.internal.view.
menu.ShowableList
Menu;
/**
* A Popup
Menu 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 Popup
Menu {
@UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553)
private final Context mContext;
private final
MenuBuilder m
Menu;
private final View mAnchor;
@UnsupportedAppUsage
private final
MenuPopupHelper mPopup;
private On
MenuItemClickListener m
MenuItemClickListener;
private OnDismissListener mOnDismissListener;
private OnTouchListener mDragListener;
/**
* 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 Popup
Menu(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 Popup
Menu(Context context, View anchor, int gravity) {
this(context, anchor, gravity, R.attr.popup
MenuStyle, 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 Popup
Menu(Context context, View anchor, int gravity, int popupStyleAttr,
int popupStyleRes) {
mContext = context;
mAnchor = anchor;
m
Menu = new
MenuBuilder(context);
m
Menu.setCallback(new
MenuBuilder.Callback() {
@Override
public boolean on
MenuItemSelected(
MenuBuilder
menu,
MenuItem item) {
if (m
MenuItemClickListener != null) {
return m
MenuItemClickListener.on
MenuItemClick(item);
}
return false;
}
@Override
public void on
MenuModeChange(
MenuBuilder
menu) {
}
});
mPopup = new
MenuPopupHelper(context, m
Menu, anchor, false, popupStyleAttr, popupStyleRes);
mPopup.setGravity(gravity);
mPopup.setOnDismissListener(new PopupWindow.OnDismissListener() {
@Override
public void onDismiss() {
if (mOnDismissListener != null) {
mOnDismissListener.onDismiss(Popup
Menu.this);
}
}
});
}
/**
* Sets
the gravity used to align
the popup window to its anchor view.
* <p>
* If
the popup is showing, calling this method will take effect only
*
the next time
the popup is shown.
*
* @param gravity
the gravity used to align
the popup window
* @see #getGravity()
*/
public void setGravity(int gravity) {
mPopup.setGravity(gravity);
}
/**
* @return
the gravity used to align
the popup window to its anchor view
* @see #setGravity(int)
*/
public int getGravity() {
return mPopup.getGravity();
}
/**
* Returns an {@link OnTouchListener} that can be added to
the anchor view
* to implement drag-to-open behavior.
* <p>
* 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.
* <p>
* Example usage:
* <pre>
* Popup
Menu myPopup = new Popup
Menu(context, myAnchor);
* myAnchor.setOnTouchListener(myPopup.getDragToOpenListener());
* </pre>
*
* @return a touch listener that controls drag-to-open behavior
*/
public OnTouchListener getDragToOpenListener() {
if (mDragListener == null) {
mDragListener = new ForwardingListener(mAnchor) {
@Override
protected boolean onForwardingStarted() {
show();
return true;
}
@Override
protected boolean onForwardingStopped() {
dismiss();
return true;
}
@Override
public ShowableList
Menu getPopup() {
// This will be null until show() is called.
return mPopup.getPopup();
}
};
}
return mDragListener;
}
/**
* Returns
the {@link
Menu} associated with this popup. Populate
the
* returned
Menu with items before calling {@link #show()}.
*
* @return
the {@link
Menu} associated with this popup
* @see #show()
* @see #get
MenuInflater()
*/
public
Menu get
Menu() {
return m
Menu;
}
/**
* @return a {@link
MenuInflater} that can be used to inflate
menu items
* from XML into
the menu returned by {@link #get
Menu()}
* @see #get
Menu()
*/
public
MenuInflater get
MenuInflater() {
return new
MenuInflater(mContext);
}
/**
* Inflate a
menu resource into this Popup
Menu. This is equivalent to
* calling {@code popup
Menu.get
MenuInflater().inflate(
menuRes, popup
Menu.get
Menu())}.
*
* @param
menuRes
Menu resource to inflate
*/
public void inflate(@
MenuRes int
menuRes) {
get
MenuInflater().inflate(
menuRes, m
Menu);
}
/**
* Show
the menu popup anchored to
the view specified during construction.
*
* @see #dismiss()
*/
public void show() {
mPopup.show();
}
/**
* Dismiss
the menu popup.
*
* @see #show()
*/
public void dismiss() {
mPopup.dismiss();
}
/**
* Sets a listener that will be notified when
the user selects an item from
*
the menu.
*
* @param listener
the listener to notify
*/
public void setOn
MenuItemClickListener(On
MenuItemClickListener listener) {
m
MenuItemClickListener = 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;
}
/**
* Sets whe
ther
the popup
menu's adapter is forced to show icons in
the
*
menu item views.
* <p>
* Changes take effect on
the next call to show().
*
* @param forceShowIcon {@code true} to force icons to be shown, or
* {@code false} for icons to be optionally shown
*/
public void setForceShowIcon(boolean forceShowIcon) {
mPopup.setForceShowIcon(forceShowIcon);
}
/**
* Interface responsible for receiving
menu item click events if
the items
*
themselves do not have individual item click listeners.
*/
public interface On
MenuItemClickListener {
/**
* 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}
* o
therwise
*/
boolean on
MenuItemClick(
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(Popup
Menu menu);
}
/**
* Returns
the {@link ListView} representing
the list of
menu items in
the currently showing
*
menu.
*
* @return
The view representing
the list of
menu items.
* @
hide
*/
@TestApi
public ListView get
MenuListView() {
if (!mPopup.isShowing()) {
return null;
}
return mPopup.getPopup().getListView();
}
}
改成中文注释
扫一扫
1127
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
