added in version 22.1.0
belongs to Maven artifact com.android.support:support-compat:28.0.0-alpha1

Summary: Methods | Inherited Methods | [Expand All]

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

added in version 22.1.0

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:

EXTRA_BCC

addEmailBcc

added in version 22.1.0

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:

EXTRA_BCC

addEmailCc

added in version 22.1.0

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:

EXTRA_CC

addEmailCc

added in version 22.1.0

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:

EXTRA_CC

addEmailTo

added in version 22.1.0

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:

EXTRA_EMAIL

addEmailTo

added in version 22.1.0

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:

EXTRA_EMAIL

addStream

added in version 22.1.0

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

added in version 22.1.0

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

added in version 22.1.0

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

added in version 22.1.0

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

added in version 22.1.0

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

added in version 22.1.0

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

added in version 22.1.0

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:

EXTRA_BCC

setEmailCc

added in version 22.1.0

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:

EXTRA_CC

setEmailTo

added in version 22.1.0

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:

EXTRA_EMAIL

setHtmlText

added in version 22.1.0

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:

setText(CharSequence)

setStream

added in version 22.1.0

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:

EXTRA_STREAM

setSubject

added in version 22.1.0

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:

EXTRA_SUBJECT