ActionProvider

public abstract class ActionProvider
extends Object

Known Direct Subclasses MediaRouteActionProvider, ShareActionProvider MediaRouteActionProvider 媒体路由操作提供显示 media route button在应用程序的 ActionBar ，允许用户选择路线和控制当前选择的路线。 ShareActionProvider 提供适用于活动应用栏的分享操作。

这个类是完成给定任务的中介，例如共享文件。 它负责创建执行完成任务的操作的视图。 该类还实现了其他功能，例如执行默认操作。

注意：该类包含在support library中，以兼容API级别4和更高级别。 如果您开发的API级别14的应用程序和更高版本 ，您应该使用框架ActionProvider类。

可以为MenuItem指定一个MenuItem ，在这种情况下，它将负责创建在ActionBar中出现的操作视图，作为操作项目显示该项目时菜单项的替代。 如果选择放置在ActionBar的溢出菜单上的菜单项并且没有任何菜单项回调处理选择，则提供者负责执行默认操作。 对于这种情况，提供者还可以选择提供用于完成手头任务的子菜单。

使用动作提供者来创建和处理动作视图有两种方式：

• Setting the action provider on a MenuItem directly by calling setActionProvider(android.view.MenuItem, ActionProvider).
• Declaring the action provider in the menu XML resource. For example:

  
     <item android:id="@+id/my_menu_item"
       android:title="@string/my_menu_item_title"
       android:icon="@drawable/my_menu_item_icon"
       android:showAsAction="ifRoom"
       android:actionProviderClass="foo.bar.SomeActionProvider" />
   

Creating a custom action provider

要创建自定义操作提供程序，请根据需要扩展ActionProvider并实现其回调方法。 特别是实施以下方法：

ActionProvider() constructor

This constructor is passed the application context. You should save the context in a member field to use in the other callback methods.

onCreateActionView(MenuItem)

The system calls this method when the action provider is created. You define the action provider's layout through the implementation of this method. Use the context acquired from the constructor to instantiate a LayoutInflater and inflate your action provider's layout from an XML resource, then hook up event listeners for the view's components. For example:

 public View onCreateActionView(MenuItem forItem) {
     // Inflate the action provider to be shown on the action bar.
     LayoutInflater layoutInflater = LayoutInflater.from(mContext);
     View providerView =
         layoutInflater.inflate(R.layout.my_action_provider, null);
     ImageButton button =
         (ImageButton) providerView.findViewById(R.id.button);
     button.setOnClickListener(new View.OnClickListener() {
         @Override
         public void onClick(View v) {
             // Do something...
         }
     });
     return providerView;
 }

onPerformDefaultAction()

当用户从动作溢出中选择一个菜单项时，系统调用此方法。 操作提供者应该为菜单项执行默认操作。 如果菜单项打开子菜单，系统不会调用此方法。

如果您的行动提供商通过onPrepareSubMenu()回拨显示子菜单，即使行动提供商处于溢出菜单中，也会出现子菜单。 因此，如果有子菜单，系统不会调用onPerformDefaultAction() 。

注意：实现onOptionsItemSelected()的活动或片段可以通过处理项目选定事件并返回true来覆盖操作提供者的默认行为（除非它使用子菜单）。 在这种情况下，系统不会调用onPerformDefaultAction() 。

Summary

Inherited methods

From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为该对象调用 notify()方法或 notifyAll()方法，或者某个其他线程中断当前线程，或者经过一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 使当前线程等待，直到另一个线程调用此对象的方法 notify()或方法 notifyAll() 。

Public constructors

ActionProvider (Context context)

Public methods

Context getContext ()

boolean hasSubMenu ()

boolean isVisible ()

View onCreateActionView ()

View onCreateActionView (MenuItem forItem)

boolean onPerformDefaultAction ()

void onPrepareSubMenu (SubMenu subMenu)

boolean overridesItemVisibility ()

void refreshVisibility ()

void setVisibilityListener (ActionProvider.VisibilityListener listener)