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.
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 | |
|---|---|
java.lang.Object
| |
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:
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:
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:
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:
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:
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:
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 |
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 |
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 |
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 |
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 |
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 |
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:
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:
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:
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:
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:
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:
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:
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:
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.