public class MediaRouteActionProvider
extends ActionProvider
java.lang.Object | ||
↳ | android.view.ActionProvider | |
↳ | android.app.MediaRouteActionProvider |
媒体路由操作提供显示 media route button
在应用程序的 ActionBar
,允许用户选择路线和控制当前选择的路线。
应用程序必须指定允许用户通过使用 setRouteTypes(int)
方法指定路线类型来选择的路线种类。
有关将出现在操作栏菜单中的按钮的说明,请参阅MediaRouteButton
。 请注意,如果没有路线可用,则禁用该按钮,而不是使操作提供程序使菜单项不可见。 这样,只有当用户可以发现并选择匹配的路线时,该按钮才可见。
Public constructors |
|
---|---|
MediaRouteActionProvider(Context context) |
Public methods |
|
---|---|
boolean |
isVisible() 如果 |
View |
onCreateActionView() 此方法已弃用。 使用 |
View |
onCreateActionView(MenuItem item) 由Android框架调用的工厂方法来创建新的操作视图。 |
boolean |
onPerformDefaultAction() 执行可选的默认操作。 |
boolean |
overridesItemVisibility() 此方法的结果决定了 |
void |
setExtendedSettingsClickListener(View.OnClickListener listener) |
void |
setRouteTypes(int types) 设置将在由此按钮启动的媒体路径选择器对话框中显示的路线类型。 |
Inherited methods |
|
---|---|
From class android.view.ActionProvider
|
|
From class java.lang.Object
|
MediaRouteActionProvider (Context context)
Parameters | |
---|---|
context |
Context
|
boolean isVisible ()
如果 overridesItemVisibility()
返回true,则此方法的返回值将有助于确定此ActionProvider绑定到的 MenuItem
的可见性。
如果MenuItem的可见性被应用程序显式设置为false,则即使此方法返回true,MenuItem也不会显示。
Returns | |
---|---|
boolean |
true if the MenuItem this ActionProvider is bound to is visible, false if it is invisible. The default implementation returns true. |
View onCreateActionView ()
此方法已弃用。
使用onCreateActionView(MenuItem)
由Android框架调用的工厂方法来创建新的操作视图。
此方法已被弃用,以支持onCreateActionView(MenuItem)
。 希望支持API 16之前的平台版本的新应用程序也应实现此方法以返回有效的操作视图。
Returns | |
---|---|
View |
A new action view. |
View onCreateActionView (MenuItem item)
由Android框架调用的工厂方法来创建新的操作视图。 此方法为给定的MenuItem返回一个新的操作视图。
如果您的ActionProvider实现覆盖已弃用的无参数过载onCreateActionView()
,则推荐使用运行API 16或更高版本的设备的此方法,但可选。 默认实现调用onCreateActionView()
以与为较旧平台版本编写的应用程序兼容。
Parameters | |
---|---|
item |
MenuItem : MenuItem to create the action view for |
Returns | |
---|---|
View |
the new action view |
boolean onPerformDefaultAction ()
执行可选的默认操作。
对于放置在未显示为菜单项的操作提供者的情况,如果先前用于处理菜单选择的回调处理了该事件,则调用此方法。
菜单项选择按以下顺序处理:
MenuItem.OnMenuItemClickListener.onMenuItemClick
. Activity.onOptionsItemSelected(MenuItem)
Fragment.onOptionsItemSelected(MenuItem)
Intent
set via MenuItem.setIntent(android.content.Intent)
默认实现不执行任何操作并返回false。
Returns | |
---|---|
boolean |
boolean overridesItemVisibility ()
此方法的结果决定了 isVisible()
将被此ActionProvider绑定的 MenuItem
使用,以帮助确定其可见性。
Returns | |
---|---|
boolean |
true if this ActionProvider overrides the visibility of the MenuItem it is bound to, false otherwise. The default implementation returns false. |
void setExtendedSettingsClickListener (View.OnClickListener listener)
Parameters | |
---|---|
listener |
View.OnClickListener
|
void setRouteTypes (int types)
设置将在由此按钮启动的媒体路径选择器对话框中显示的路线类型。
Parameters | |
---|---|
types |
int : The route types to match. |