添加一个简单Share Action

在Android 4.0(API Level 14)中,通过ActionProvider的介绍,可以在ActionBar中更容易地实现一个有效且用户友好的share action。对于一个ActionProvider,一旦在操作栏中附加到一个菜单项,就要处理菜单项的样式和动作。ShareActionProvider的出现,使你可以提供一个共享的Intent,它会完成剩余的工作。

注意:ShareActionProvider只能在API版本为14或更高的版本中使用。

更新菜单声明:

在使用ShareActionProvider时,首先在你的菜单资源文件中的item标签下定义android:actionProviderClass属性:

<menu xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:id="@+id/menu_item_share"
        android:showAsAction="ifRoom"
        android:title="Share"
        android:actionProviderClass="android.widget.ShareActionProvider" />
    ...
</menu>

这会向ShareActionProvider声明菜单项的外观和功能所需的职责。然而,你也需要告诉提供者(provider)你想要共享的内容。

设置共享Intent:

为了使ShareActionProvider运用到功能中,必须提供一个共享Intent。共享Intent应该与SendingContent to Other Apps课程所描述的一致,要用到ACTION_SEND动作,并且通过类似EXTRA_TEXTEXTRA_STREAM的extras设置附加数据。要想指定一个共享Intent,首先在ActivityFragment中填充menu资源时找到相匹配的MenuItem。然后调用MenuItem.getActionProvider()方法检索ShareActionProvider的实例。使用setShareIntent()更新与action条目相关的共享Intent。下面是一个例子:

private ShareActionProvider mShareActionProvider;
...

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    // Inflate menu resource file.
    getMenuInflater().inflate(R.menu.share_menu, menu);

    // Locate MenuItem with ShareActionProvider
    MenuItem item = menu.findItem(R.id.menu_item_share);

    // Fetch and store ShareActionProvider
    mShareActionProvider = (ShareActionProvider) item.getActionProvider();

    // Return true to display menu
    return true;
}

// Call to update the share intent
private void setShareIntent(Intent shareIntent) {
    if (mShareActionProvider != null) {
        mShareActionProvider.setShareIntent(shareIntent);
    }
}

在创建菜单期间,设置共享Intent可能只需要一次;或者在设置之后随着UI的改变而更新。例如,在Gallery应用中,当你全屏浏览照片时,共享Intent就会随着照片切换而不断更新。


对于ShareActionProvider更深入的探讨,参考Action Bar指南。

原文链接:https://developer.android.com/training/sharing/shareaction.html#set-share-intent

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值