ShareActionProvider.java revision e290ed32f85ff6307a53922a78684b31d30b8dc5
1e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes/* 2e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * Copyright (C) 2013 The Android Open Source Project 3e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * 4e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * Licensed under the Apache License, Version 2.0 (the "License"); 5e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * you may not use this file except in compliance with the License. 6e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * You may obtain a copy of the License at 7e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * 8e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * http://www.apache.org/licenses/LICENSE-2.0 9e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * 10e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * Unless required by applicable law or agreed to in writing, software 11e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * distributed under the License is distributed on an "AS IS" BASIS, 12e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * See the License for the specific language governing permissions and 14e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * limitations under the License. 15e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes */ 16e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 17e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banespackage android.support.v7.widget; 18e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 19e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banesimport android.content.Context; 20e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banesimport android.content.Intent; 21e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banesimport android.content.pm.PackageManager; 22e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banesimport android.content.pm.ResolveInfo; 23e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banesimport android.graphics.drawable.Drawable; 24e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banesimport android.support.v4.view.ActionProvider; 25e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banesimport android.support.v7.appcompat.R; 26e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banesimport android.support.v7.internal.widget.ActivityChooserModel; 27e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banesimport android.support.v7.internal.widget.ActivityChooserView; 28e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banesimport android.util.TypedValue; 29e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banesimport android.view.Menu; 30e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banesimport android.view.MenuItem; 31e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banesimport android.view.MenuItem.OnMenuItemClickListener; 32e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banesimport android.view.SubMenu; 33e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banesimport android.view.View; 34e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banesimport android.support.v7.internal.widget.ActivityChooserModel.OnChooseActivityListener; 35e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 36e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes/** 37e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * This is a provider for a share action. It is responsible for creating views 38e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * that enable data sharing and also to show a sub menu with sharing activities 39e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * if the hosting item is placed on the overflow menu. 40e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * <p> 41e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * Here is how to use the action provider with custom backing file in a {@link MenuItem}: 42e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * </p> 43e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * <p> 44e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * <pre> 45e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * <code> 46e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * // In Activity#onCreateOptionsMenu 47e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * public boolean onCreateOptionsMenu(Menu menu) { 48e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * // Get the menu item. 49e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * MenuItem menuItem = menu.findItem(R.id.my_menu_item); 50e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * // Get the provider and hold onto it to set/change the share intent. 51e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * mShareActionProvider = (ShareActionProvider) MenuItemCompat.getActionProvider(menuItem); 52e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * // Set history different from the default before getting the action 53e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * // view since a call to {@link android.support.v4.view.MenuItemCompat#getActionView(android.view.MenuItem) MenuItemCompat.getActionView()} calls 54e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * // {@link ActionProvider#onCreateActionView()} which uses the backing file name. Omit this 55e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * // line if using the default share history file is desired. 56e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * mShareActionProvider.setShareHistoryFileName("custom_share_history.xml"); 57e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * . . . 58e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * } 59e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * 60e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * // Somewhere in the application. 61e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * public void doShare(Intent shareIntent) { 62e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * // When you want to share set the share intent. 63e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * mShareActionProvider.setShareIntent(shareIntent); 64e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * } 65e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * </pre> 66e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * </code> 67e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * </p> 68e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * <p> 69e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * <strong>Note:</strong> While the sample snippet demonstrates how to use this provider 70e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * in the context of a menu item, the use of the provider is not limited to menu items. 71e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * </p> 72e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * 73e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * @see ActionProvider 74e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes */ 75e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banespublic class ShareActionProvider extends ActionProvider { 76e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 77e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes /** 78e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * Listener for the event of selecting a share target. 79e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes */ 80e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes public interface OnShareTargetSelectedListener { 81e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 82e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes /** 83e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * Called when a share target has been selected. The client can 84e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * decide whether to perform some action before the sharing is 85e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * actually performed. 86e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * <p> 87e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * <strong>Note:</strong> Modifying the intent is not permitted and 88e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * any changes to the latter will be ignored. 89e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * </p> 90e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * <p> 91e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * <strong>Note:</strong> You should <strong>not</strong> handle the 92e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * intent here. This callback aims to notify the client that a 93e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * sharing is being performed, so the client can update the UI 94e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * if necessary. 95e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * </p> 96e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * 97e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * @param source The source of the notification. 98e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * @param intent The intent for launching the chosen share target. 99e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * @return The return result is ignored. Always return false for consistency. 100e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes */ 101e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes public boolean onShareTargetSelected(ShareActionProvider source, Intent intent); 102e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes } 103e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 104e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes /** 105e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * The default for the maximal number of activities shown in the sub-menu. 106e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes */ 107e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes private static final int DEFAULT_INITIAL_ACTIVITY_COUNT = 4; 108e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 109e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes /** 110e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * The the maximum number activities shown in the sub-menu. 111e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes */ 112e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes private int mMaxShownActivityCount = DEFAULT_INITIAL_ACTIVITY_COUNT; 113e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 114e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes /** 115e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * Listener for handling menu item clicks. 116e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes */ 117e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes private final ShareMenuItemOnMenuItemClickListener mOnMenuItemClickListener = 118e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes new ShareMenuItemOnMenuItemClickListener(); 119e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 120e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes /** 121e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * The default name for storing share history. 122e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes */ 123e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes public static final String DEFAULT_SHARE_HISTORY_FILE_NAME = "share_history.xml"; 124e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 125e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes /** 126e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * Context for accessing resources. 127e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes */ 128e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes private final Context mContext; 129e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 130e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes /** 131e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * The name of the file with share history data. 132e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes */ 133e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes private String mShareHistoryFileName = DEFAULT_SHARE_HISTORY_FILE_NAME; 134e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 135e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes private OnShareTargetSelectedListener mOnShareTargetSelectedListener; 136e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 137e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes private OnChooseActivityListener mOnChooseActivityListener; 138e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 139e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes /** 140e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * Creates a new instance. 141e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * 142e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * @param context Context for accessing resources. 143e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes */ 144e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes public ShareActionProvider(Context context) { 145e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes super(context); 146e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes mContext = context; 147e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes } 148e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 149e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes /** 150e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * Sets a listener to be notified when a share target has been selected. 151e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * The listener can optionally decide to handle the selection and 152e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * not rely on the default behavior which is to launch the activity. 153e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * <p> 154e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * <strong>Note:</strong> If you choose the backing share history file 155e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * you will still be notified in this callback. 156e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * </p> 157e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * @param listener The listener. 158e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes */ 159e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes public void setOnShareTargetSelectedListener(OnShareTargetSelectedListener listener) { 160e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes mOnShareTargetSelectedListener = listener; 161e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes setActivityChooserPolicyIfNeeded(); 162e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes } 163e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 164e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes /** 165e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * {@inheritDoc} 166e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes */ 167e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes @Override 168e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes public View onCreateActionView() { 169e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes // Create the view and set its data model. 170e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes ActivityChooserModel dataModel = ActivityChooserModel.get(mContext, mShareHistoryFileName); 171e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes ActivityChooserView activityChooserView = new ActivityChooserView(mContext); 172e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes activityChooserView.setActivityChooserModel(dataModel); 173e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 174e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes // Lookup and set the expand action icon. 175e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes TypedValue outTypedValue = new TypedValue(); 176e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes mContext.getTheme().resolveAttribute(R.attr.actionModeShareDrawable, outTypedValue, true); 177e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes Drawable drawable = mContext.getResources().getDrawable(outTypedValue.resourceId); 178e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes activityChooserView.setExpandActivityOverflowButtonDrawable(drawable); 179e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes activityChooserView.setProvider(this); 180e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 181e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes // Set content description. 182e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes activityChooserView.setDefaultActionButtonContentDescription( 183e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes R.string.abc_shareactionprovider_share_with_application); 184e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes activityChooserView.setExpandActivityOverflowButtonContentDescription( 185e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes R.string.abc_shareactionprovider_share_with); 186e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 187e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes return activityChooserView; 188e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes } 189e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 190e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes /** 191e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * {@inheritDoc} 192e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes */ 193e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes @Override 194e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes public boolean hasSubMenu() { 195e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes return true; 196e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes } 197e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 198e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes /** 199e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * {@inheritDoc} 200e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes */ 201e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes @Override 202e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes public void onPrepareSubMenu(SubMenu subMenu) { 203e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes // Clear since the order of items may change. 204e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes subMenu.clear(); 205e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 206e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes ActivityChooserModel dataModel = ActivityChooserModel.get(mContext, mShareHistoryFileName); 207e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes PackageManager packageManager = mContext.getPackageManager(); 208e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 209e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes final int expandedActivityCount = dataModel.getActivityCount(); 210e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes final int collapsedActivityCount = Math.min(expandedActivityCount, mMaxShownActivityCount); 211e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 212e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes // Populate the sub-menu with a sub set of the activities. 213e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes for (int i = 0; i < collapsedActivityCount; i++) { 214e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes ResolveInfo activity = dataModel.getActivity(i); 215e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes subMenu.add(0, i, i, activity.loadLabel(packageManager)) 216e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes .setIcon(activity.loadIcon(packageManager)) 217e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes .setOnMenuItemClickListener(mOnMenuItemClickListener); 218e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes } 219e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 220e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes if (collapsedActivityCount < expandedActivityCount) { 221e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes // Add a sub-menu for showing all activities as a list item. 222e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes SubMenu expandedSubMenu = subMenu.addSubMenu(Menu.NONE, collapsedActivityCount, 223e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes collapsedActivityCount, 224e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes mContext.getString(R.string.abc_activity_chooser_view_see_all)); 225e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes for (int i = 0; i < expandedActivityCount; i++) { 226e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes ResolveInfo activity = dataModel.getActivity(i); 227e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes expandedSubMenu.add(0, i, i, activity.loadLabel(packageManager)) 228e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes .setIcon(activity.loadIcon(packageManager)) 229e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes .setOnMenuItemClickListener(mOnMenuItemClickListener); 230e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes } 231e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes } 232e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes } 233e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 234e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes /** 235e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * Sets the file name of a file for persisting the share history which 236e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * history will be used for ordering share targets. This file will be used 237e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * for all view created by {@link #onCreateActionView()}. Defaults to 238e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * {@link #DEFAULT_SHARE_HISTORY_FILE_NAME}. Set to <code>null</code> 239e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * if share history should not be persisted between sessions. 240e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * <p> 241e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * <strong>Note:</strong> The history file name can be set any time, however 242e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * only the action views created by {@link #onCreateActionView()} after setting 243e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * the file name will be backed by the provided file. Therefore, if you want to 244e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * use different history files for sharing specific types of content, every time 245e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * you change the history file {@link #setShareHistoryFileName(String)} you must 246e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * call {@link android.app.Activity#invalidateOptionsMenu()} to recreate the 247e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * action view. You should <strong>not</strong> call 248e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * {@link android.app.Activity#invalidateOptionsMenu()} from 249e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * {@link android.app.Activity#onCreateOptionsMenu(Menu)}." 250e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * <p> 251e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * <code> 252e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * private void doShare(Intent intent) { 253e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * if (IMAGE.equals(intent.getMimeType())) { 254e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * mShareActionProvider.setHistoryFileName(SHARE_IMAGE_HISTORY_FILE_NAME); 255e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * } else if (TEXT.equals(intent.getMimeType())) { 256e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * mShareActionProvider.setHistoryFileName(SHARE_TEXT_HISTORY_FILE_NAME); 257e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * } 258e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * mShareActionProvider.setIntent(intent); 259e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * invalidateOptionsMenu(); 260e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * } 261e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * <code> 262e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * 263e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * @param shareHistoryFile The share history file name. 264e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes */ 265e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes public void setShareHistoryFileName(String shareHistoryFile) { 266e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes mShareHistoryFileName = shareHistoryFile; 267e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes setActivityChooserPolicyIfNeeded(); 268e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes } 269e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 270e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes /** 271e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * Sets an intent with information about the share action. Here is a 272e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * sample for constructing a share intent: 273e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * <p> 274e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * <pre> 275e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * <code> 276e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * Intent shareIntent = new Intent(Intent.ACTION_SEND); 277e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * shareIntent.setType("image/*"); 278e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * Uri uri = Uri.fromFile(new File(getFilesDir(), "foo.jpg")); 279e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * shareIntent.putExtra(Intent.EXTRA_STREAM, uri.toString()); 280e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * </pre> 281e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * </code> 282e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * </p> 283e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * 284e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * @param shareIntent The share intent. 285e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * 286e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * @see Intent#ACTION_SEND 287e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * @see Intent#ACTION_SEND_MULTIPLE 288e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes */ 289e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes public void setShareIntent(Intent shareIntent) { 290e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes ActivityChooserModel dataModel = ActivityChooserModel.get(mContext, 291e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes mShareHistoryFileName); 292e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes dataModel.setIntent(shareIntent); 293e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes } 294e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 295e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes /** 296e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * Reusable listener for handling share item clicks. 297e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes */ 298e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes private class ShareMenuItemOnMenuItemClickListener implements OnMenuItemClickListener { 299e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes @Override 300e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes public boolean onMenuItemClick(MenuItem item) { 301e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes ActivityChooserModel dataModel = ActivityChooserModel.get(mContext, 302e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes mShareHistoryFileName); 303e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes final int itemId = item.getItemId(); 304e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes Intent launchIntent = dataModel.chooseActivity(itemId); 305e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes if (launchIntent != null) { 306e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes launchIntent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET); 307e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes mContext.startActivity(launchIntent); 308e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes } 309e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes return true; 310e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes } 311e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes } 312e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 313e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes /** 314e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * Set the activity chooser policy of the model backed by the current 315e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * share history file if needed which is if there is a registered callback. 316e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes */ 317e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes private void setActivityChooserPolicyIfNeeded() { 318e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes if (mOnShareTargetSelectedListener == null) { 319e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes return; 320e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes } 321e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes if (mOnChooseActivityListener == null) { 322e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes mOnChooseActivityListener = new ShareActivityChooserModelPolicy(); 323e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes } 324e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes ActivityChooserModel dataModel = ActivityChooserModel.get(mContext, mShareHistoryFileName); 325e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes dataModel.setOnChooseActivityListener(mOnChooseActivityListener); 326e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes } 327e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes 328e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes /** 329e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes * Policy that delegates to the {@link OnShareTargetSelectedListener}, if such. 330e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes */ 331e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes private class ShareActivityChooserModelPolicy implements OnChooseActivityListener { 332e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes @Override 333e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes public boolean onChooseActivity(ActivityChooserModel host, Intent intent) { 334e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes if (mOnShareTargetSelectedListener != null) { 335e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes mOnShareTargetSelectedListener.onShareTargetSelected( 336e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes ShareActionProvider.this, intent); 337e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes } 338e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes return false; 339e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes } 340e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes } 341e290ed32f85ff6307a53922a78684b31d30b8dc5Chris Banes}