ShareCompat.IntentBuilder

public IntentBuilder(@NonNull Context launchingContext)

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

Note that builders that are not constructed with an Activity context (or a wrapped activity context) will not set the calling activity on the returned intent.

public @NonNull ShareCompat.IntentBuilder addEmailBcc(@NonNull String address)

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

public @NonNull ShareCompat.IntentBuilder addEmailBcc(@NonNull String[] addresses)

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

public @NonNull ShareCompat.IntentBuilder addEmailCc(@NonNull String address)

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

public @NonNull ShareCompat.IntentBuilder addEmailCc(@NonNull String[] addresses)

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

public @NonNull ShareCompat.IntentBuilder addEmailTo(@NonNull String address)

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

public @NonNull ShareCompat.IntentBuilder addEmailTo(@NonNull String[] addresses)

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

public @NonNull ShareCompat.IntentBuilder addStream(@NonNull 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.

public @NonNull 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.

public static @NonNull ShareCompat.IntentBuilder from(@NonNull Activity launchingActivity)

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

public @NonNull 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.

public @NonNull ShareCompat.IntentBuilder setChooserTitle(@StringRes int resId)

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

public @NonNull ShareCompat.IntentBuilder setChooserTitle(@Nullable CharSequence title)

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

public @NonNull ShareCompat.IntentBuilder setEmailBcc(@Nullable 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.

public @NonNull ShareCompat.IntentBuilder setEmailCc(@Nullable 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.

public @NonNull ShareCompat.IntentBuilder setEmailTo(@Nullable 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.

public @NonNull ShareCompat.IntentBuilder setHtmlText(@Nullable 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.

public @NonNull ShareCompat.IntentBuilder setStream(@Nullable 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.

public @NonNull ShareCompat.IntentBuilder setSubject(@Nullable String subject)

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

public @NonNull ShareCompat.IntentBuilder setText(@Nullable CharSequence text)

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

public @NonNull ShareCompat.IntentBuilder setType(@Nullable String mimeType)

Set the type of data being shared

public void startChooser()

Start a chooser activity for the current share intent.