Most visited

Recently visited

ShareCompat.IntentBuilder

public static class ShareCompat.IntentBuilder
extends Object

java.lang.Object
   ↳ android.support.v4.app.ShareCompat.IntentBuilder


IntentBuilder is a helper for constructing ACTION_SEND and ACTION_SEND_MULTIPLE sharing intents and starting activities to share content. The ComponentName and package name of the calling activity will be included.

Summary

Public methods

ShareCompat.IntentBuilder addEmailBcc(String address)

Add an email address to be used in the "bcc" field of the final Intent.

ShareCompat.IntentBuilder addEmailBcc(String[] addresses)

Add an array of email addresses to be used in the "bcc" field of the final Intent.

ShareCompat.IntentBuilder addEmailCc(String[] addresses)

Add an array of email addresses to be used in the "cc" field of the final Intent.

ShareCompat.IntentBuilder addEmailCc(String address)

Add an email address to be used in the "cc" field of the final Intent.

ShareCompat.IntentBuilder addEmailTo(String[] addresses)

Add an array of email addresses to be used in the "to" field of the final Intent.

ShareCompat.IntentBuilder addEmailTo(String address)

Add an email address to be used in the "to" field of the final Intent.

ShareCompat.IntentBuilder addStream(Uri streamUri)

Add a stream URI to the data that should be shared.

Intent createChooserIntent()

Create an Intent that will launch the standard Android activity chooser, allowing the user to pick what activity/app on the system should handle the share.

static ShareCompat.IntentBuilder from(Activity launchingActivity)

Create a new IntentBuilder for launching a sharing action from launchingActivity.

Intent getIntent()

Retrieve the Intent as configured so far by the IntentBuilder.

ShareCompat.IntentBuilder setChooserTitle(int resId)

Set the title that will be used for the activity chooser for this share.

ShareCompat.IntentBuilder setChooserTitle(CharSequence title)

Set the title that will be used for the activity chooser for this share.

ShareCompat.IntentBuilder setEmailBcc(String[] addresses)

Set an array of email addresses to BCC on this share.

ShareCompat.IntentBuilder setEmailCc(String[] addresses)

Set an array of email addresses to CC on this share.

ShareCompat.IntentBuilder setEmailTo(String[] addresses)

Set an array of email addresses as recipients of this share.

ShareCompat.IntentBuilder setHtmlText(String htmlText)

Set an HTML string to be sent as part of the share.

ShareCompat.IntentBuilder setStream(Uri streamUri)

Set a stream URI to the data that should be shared.

ShareCompat.IntentBuilder setSubject(String subject)

Set a subject heading for this share; useful for sharing via email.

ShareCompat.IntentBuilder setText(CharSequence text)

Set the literal text data to be sent as part of the share.

ShareCompat.IntentBuilder setType(String mimeType)

Set the type of data being shared

void startChooser()

Start a chooser activity for the current share intent.

Inherited methods

From class java.lang.Object

Public methods

addEmailBcc

ShareCompat.IntentBuilder addEmailBcc (String address)

Add an email address to be used in the "bcc" field of the final Intent.

Parameters
address String: Email address to BCC
Returns
ShareCompat.IntentBuilder This IntentBuilder for method chaining

See also:

addEmailBcc

ShareCompat.IntentBuilder addEmailBcc (String[] addresses)

Add an array of email addresses to be used in the "bcc" field of the final Intent.

Parameters
addresses String: Email addresses to BCC
Returns
ShareCompat.IntentBuilder This IntentBuilder for method chaining

See also:

addEmailCc

ShareCompat.IntentBuilder addEmailCc (String[] addresses)

Add an array of email addresses to be used in the "cc" field of the final Intent.

Parameters
addresses String: Email addresses to CC
Returns
ShareCompat.IntentBuilder This IntentBuilder for method chaining

See also:

addEmailCc

ShareCompat.IntentBuilder addEmailCc (String address)

Add an email address to be used in the "cc" field of the final Intent.

Parameters
address String: Email address to CC
Returns
ShareCompat.IntentBuilder This IntentBuilder for method chaining

See also:

addEmailTo

ShareCompat.IntentBuilder addEmailTo (String[] addresses)

Add an array of email addresses to be used in the "to" field of the final Intent.

Parameters
addresses String: Email addresses to send to
Returns
ShareCompat.IntentBuilder This IntentBuilder for method chaining

See also:

addEmailTo

ShareCompat.IntentBuilder addEmailTo (String address)

Add an email address to be used in the "to" field of the final Intent.

Parameters
address String: Email address to send to
Returns
ShareCompat.IntentBuilder This IntentBuilder for method chaining

See also:

addStream

ShareCompat.IntentBuilder addStream (Uri streamUri)

Add a stream URI to the data that should be shared. If this is not the first stream URI added the final intent constructed will become an ACTION_SEND_MULTIPLE intent. Not all apps will handle both ACTION_SEND and ACTION_SEND_MULTIPLE.

Parameters
streamUri Uri: URI of the stream to share
Returns
ShareCompat.IntentBuilder This IntentBuilder for method chaining

See also:

createChooserIntent

Intent createChooserIntent ()

Create an Intent that will launch the standard Android activity chooser, allowing the user to pick what activity/app on the system should handle the share.

Returns
Intent A chooser Intent for the currently configured sharing action

from

ShareCompat.IntentBuilder from (Activity launchingActivity)

Create a new IntentBuilder for launching a sharing action from launchingActivity.

Parameters
launchingActivity Activity: Activity that the share will be launched from
Returns
ShareCompat.IntentBuilder a new IntentBuilder instance

getIntent

Intent getIntent ()

Retrieve the Intent as configured so far by the IntentBuilder. This Intent is suitable for use in a ShareActionProvider or chooser dialog.

To create an intent that will launch the activity chooser so that the user may select a target for the share, see createChooserIntent().

Returns
Intent The current Intent being configured by this builder

setChooserTitle

ShareCompat.IntentBuilder setChooserTitle (int resId)

Set the title that will be used for the activity chooser for this share.

Parameters
resId int: Resource ID of the title string to use
Returns
ShareCompat.IntentBuilder This IntentBuilder for method chaining

setChooserTitle

ShareCompat.IntentBuilder setChooserTitle (CharSequence title)

Set the title that will be used for the activity chooser for this share.

Parameters
title CharSequence: Title string
Returns
ShareCompat.IntentBuilder This IntentBuilder for method chaining

setEmailBcc

ShareCompat.IntentBuilder setEmailBcc (String[] addresses)

Set an array of email addresses to BCC on this share. This replaces all current "BCC" recipients that have been set so far.

Parameters
addresses String: Email addresses to BCC on the share
Returns
ShareCompat.IntentBuilder This IntentBuilder for method chaining

See also:

setEmailCc

ShareCompat.IntentBuilder setEmailCc (String[] addresses)

Set an array of email addresses to CC on this share. This replaces all current "CC" recipients that have been set so far.

Parameters
addresses String: Email addresses to CC on the share
Returns
ShareCompat.IntentBuilder This IntentBuilder for method chaining

See also:

setEmailTo

ShareCompat.IntentBuilder setEmailTo (String[] addresses)

Set an array of email addresses as recipients of this share. This replaces all current "to" recipients that have been set so far.

Parameters
addresses String: Email addresses to send to
Returns
ShareCompat.IntentBuilder This IntentBuilder for method chaining

See also:

setHtmlText

ShareCompat.IntentBuilder setHtmlText (String htmlText)

Set an HTML string to be sent as part of the share. If EXTRA_TEXT has not already been supplied, a styled version of the supplied HTML text will be added as EXTRA_TEXT as parsed by Html.fromHtml.

Parameters
htmlText String: A string containing HTML markup as a richer version of the text provided by EXTRA_TEXT.
Returns
ShareCompat.IntentBuilder This IntentBuilder for method chaining

See also:

setStream

ShareCompat.IntentBuilder setStream (Uri streamUri)

Set a stream URI to the data that should be shared.

This replaces all currently set stream URIs and will produce a single-stream ACTION_SEND intent.

Parameters
streamUri Uri: URI of the stream to share
Returns
ShareCompat.IntentBuilder This IntentBuilder for method chaining

See also:

setSubject

ShareCompat.IntentBuilder setSubject (String subject)

Set a subject heading for this share; useful for sharing via email.

Parameters
subject String: Subject heading for this share
Returns
ShareCompat.IntentBuilder This IntentBuilder for method chaining

See also:

setText

ShareCompat.IntentBuilder setText (CharSequence text)

Set the literal text data to be sent as part of the share. This may be a styled CharSequence.

Parameters
text CharSequence: Text to share
Returns
ShareCompat.IntentBuilder This IntentBuilder for method chaining

See also:

setType

ShareCompat.IntentBuilder setType (String mimeType)

Set the type of data being shared

Parameters
mimeType String: mimetype of the shared data
Returns
ShareCompat.IntentBuilder This IntentBuilder for method chaining

See also:

startChooser

void startChooser ()

Start a chooser activity for the current share intent.

Note that under most circumstances you should use ShareCompat.configureMenuItem() to add a Share item to the menu while presenting a detail view of the content to be shared instead of invoking this directly.

Hooray!