com.facebook.share.widget

Class ShareDialog

java.lang.Object

com.facebook.internal.FacebookDialogBase<ShareContent,Sharer.Result>

com.facebook.share.widget.ShareDialog

All Implemented Interfaces:

FacebookDialog<ShareContent,Sharer.Result>, Sharer

public final class ShareDialog
extends FacebookDialogBase<ShareContent,Sharer.Result>
implements Sharer

Provides functionality to share content via the Facebook Share Dialog

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ShareDialog.Mode The mode for the share dialog.

Nested classes/interfaces inherited from class com.facebook.internal.FacebookDialogBase

FacebookDialogBase.ModeHandler

Nested classes/interfaces inherited from interface com.facebook.share.Sharer

Sharer.Result

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	WEB_SHARE_DIALOG

Fields inherited from class com.facebook.internal.FacebookDialogBase

BASE_AUTOMATIC_MODE

Constructor Summary

Constructors

Constructor and Description
ShareDialog(android.app.Activity activity) Constructs a new ShareDialog.
ShareDialog(android.support.v4.app.Fragment fragment) Constructs a new ShareDialog.
ShareDialog(android.app.Fragment fragment) Constructs a new ShareDialog.

Method Summary

Modifier and Type	Method and Description
static boolean	canShow(java.lang.Class<? extends ShareContent> contentType) Indicates whether it is possible to show the dialog for ShareContent of the specified type.
boolean	canShow(ShareContent content, ShareDialog.Mode mode) Call this to check if the Share Dialog can be shown in a specific mode.
protected AppCall	createBaseAppCall()
protected java.util.List<FacebookDialogBase.ModeHandler>	getOrderedModeHandlers()
boolean	getShouldFailOnDataError() Specifies whether the sharer should fail if it finds an error with the share content.
protected void	registerCallbackImpl(com.facebook.internal.CallbackManagerImpl callbackManager, FacebookCallback<Sharer.Result> callback)
void	setShouldFailOnDataError(boolean shouldFailOnDataError) Specifies whether the sharer should fail if it finds an error with the share content.
static void	show(android.app.Activity activity, ShareContent shareContent) Helper to show the provided ShareContent using the provided Activity.
static void	show(android.support.v4.app.Fragment fragment, ShareContent shareContent) Helper to show the provided ShareContent using the provided Fragment.
static void	show(android.app.Fragment fragment, ShareContent shareContent) Helper to show the provided ShareContent using the provided Fragment.
void	show(ShareContent content, ShareDialog.Mode mode) Call this to show the Share Dialog in a specific mode

Methods inherited from class com.facebook.internal.FacebookDialogBase

canShow, canShowImpl, getActivityContext, getRequestCode, registerCallback, registerCallback, setRequestCode, show, showImpl, startActivityForResult

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

WEB_SHARE_DIALOG

public static final java.lang.String WEB_SHARE_DIALOG

See Also:

Constant Field Values

Constructor Detail

ShareDialog

public ShareDialog(android.app.Activity activity)

Constructs a new ShareDialog.

Parameters:

activity - Activity to use to share the provided content.

ShareDialog

public ShareDialog(android.support.v4.app.Fragment fragment)

Constructs a new ShareDialog.

Parameters:

fragment - android.support.v4.app.Fragment to use to share the provided content.

ShareDialog

public ShareDialog(android.app.Fragment fragment)

Constructs a new ShareDialog.

Parameters:

fragment - android.app.Fragment to use to share the provided content.

Method Detail

show

public static void show(android.app.Activity activity,
                        ShareContent shareContent)

Helper to show the provided ShareContent using the provided Activity. No callback will be invoked.

Parameters:

activity - Activity to use to share the provided content

shareContent - Content to share

show

public static void show(android.support.v4.app.Fragment fragment,
                        ShareContent shareContent)

Helper to show the provided ShareContent using the provided Fragment. No callback will be invoked.

Parameters:

fragment - android.support.v4.app.Fragment to use to share the provided content

shareContent - Content to share

show

public static void show(android.app.Fragment fragment,
                        ShareContent shareContent)

Helper to show the provided ShareContent using the provided Fragment. No callback will be invoked.

Parameters:

fragment - android.app.Fragment to use to share the provided content

shareContent - Content to share

canShow

public static boolean canShow(java.lang.Class<? extends ShareContent> contentType)

Indicates whether it is possible to show the dialog for ShareContent of the specified type.

Parameters:

contentType - Class of the intended ShareContent to share.

Returns:

True if the specified content type can be shown via the dialog

registerCallbackImpl

protected void registerCallbackImpl(com.facebook.internal.CallbackManagerImpl callbackManager,
                                    FacebookCallback<Sharer.Result> callback)

Specified by:

registerCallbackImpl in class FacebookDialogBase<ShareContent,Sharer.Result>

getShouldFailOnDataError

public boolean getShouldFailOnDataError()

Description copied from interface: Sharer

Specifies whether the sharer should fail if it finds an error with the share content. If false, the share dialog will still be displayed without the data that was mis-configured. For example, an invalid placeID specified on the shareContent would produce a data error.

Specified by:

getShouldFailOnDataError in interface Sharer

Returns:

A Boolean value.

setShouldFailOnDataError

public void setShouldFailOnDataError(boolean shouldFailOnDataError)

Description copied from interface: Sharer

Specifies whether the sharer should fail if it finds an error with the share content. If false, the share dialog will still be displayed without the data that was mis-configured. For example, an invalid placeID specified on the shareContent would produce a data error.

Specified by:

setShouldFailOnDataError in interface Sharer

Parameters:

shouldFailOnDataError - whether the dialog should fail if it finds an error.

canShow

public boolean canShow(ShareContent content,
                       ShareDialog.Mode mode)

Call this to check if the Share Dialog can be shown in a specific mode.

Parameters:

mode - Mode of the Share Dialog

Returns:

True if the dialog can be shown in the passed in Mode

show

public void show(ShareContent content,
                 ShareDialog.Mode mode)

Call this to show the Share Dialog in a specific mode

Parameters:

mode - Mode of the Share Dialog

createBaseAppCall

protected AppCall createBaseAppCall()

Specified by:

createBaseAppCall in class FacebookDialogBase<ShareContent,Sharer.Result>

getOrderedModeHandlers

protected java.util.List<FacebookDialogBase.ModeHandler> getOrderedModeHandlers()

Specified by:

getOrderedModeHandlers in class FacebookDialogBase<ShareContent,Sharer.Result>