com.facebook.widget

Class FacebookDialog.PhotoMessageDialogBuilder

java.lang.Object

com.facebook.widget.FacebookDialog.PhotoMessageDialogBuilder

Enclosing class:

FacebookDialog

public static class FacebookDialog.PhotoMessageDialogBuilder
extends Object

Provides a builder which can construct a FacebookDialog instance suitable for presenting the native Message dialog for sharing photos. This builder will throw an exception if the Messenger application is not installed, so it should only be used if FacebookDialog.canPresentMessageDialog(android.content.Context, com.facebook.widget.FacebookDialog.MessageDialogFeature...) indicates the capability is available.

Field Summary

Fields

Modifier and Type	Field and Description
protected android.app.Activity	activity
protected FacebookDialog.PendingCall	appCall
protected String	applicationId
protected String	applicationName
protected android.support.v4.app.Fragment	fragment
protected HashMap<String,File>	imageAttachmentFiles
protected HashMap<String,android.graphics.Bitmap>	imageAttachments

Constructor Summary

Constructors

Constructor and Description
PhotoMessageDialogBuilder(android.app.Activity activity) Constructor.

Method Summary

Modifier and Type	Method and Description
protected CONCRETE	addImageAttachment(String imageName, android.graphics.Bitmap bitmap)
protected CONCRETE	addImageAttachment(String imageName, File attachment)
protected List<String>	addImageAttachmentFiles(Collection<File> bitmapFiles)
protected List<String>	addImageAttachments(Collection<android.graphics.Bitmap> bitmaps)
FacebookDialog	build() Constructs a FacebookDialog with an Intent that is correctly populated to present the dialog within the Facebook application.
boolean	canPresent() Determines whether the native dialog can be presented (i.e., whether the required version of the Facebook application is installed on the device, and whether the installed version supports all of the parameters specified for the dialog).
CONCRETE	setApplicationName(String applicationName) Sets the name of the application to be displayed in the dialog.
CONCRETE	setFragment(android.support.v4.app.Fragment fragment) Sets the fragment that should launch the dialog.
CONCRETE	setRequestCode(int requestCode) Sets the request code that will be passed to handleActivityResult when this activity completes; the default is NativeProtocol.DIALOG_REQUEST_CODE.

Methods inherited from class java.lang.Object

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

Field Detail

activity

protected final android.app.Activity activity

applicationId

protected final String applicationId

appCall

protected final FacebookDialog.PendingCall appCall

fragment

protected android.support.v4.app.Fragment fragment

applicationName

protected String applicationName

imageAttachments

protected HashMap<String,android.graphics.Bitmap> imageAttachments

imageAttachmentFiles

protected HashMap<String,File> imageAttachmentFiles

Constructor Detail

PhotoMessageDialogBuilder

public PhotoMessageDialogBuilder(android.app.Activity activity)

Constructor.

Parameters:

activity - the Activity which is presenting the native Message dialog; must not be null

Method Detail

setRequestCode

public CONCRETE setRequestCode(int requestCode)

Sets the request code that will be passed to handleActivityResult when this activity completes; the default is NativeProtocol.DIALOG_REQUEST_CODE.

Parameters:

requestCode - the request code

Returns:

this instance of the builder

setApplicationName

public CONCRETE setApplicationName(String applicationName)

Sets the name of the application to be displayed in the dialog. If provided, this optimizes the user experience as a preview of a shared item, etc., can be displayed sooner.

Parameters:

applicationName - the name of the Facebook application

Returns:

this instance of the builder

setFragment

public CONCRETE setFragment(android.support.v4.app.Fragment fragment)

Sets the fragment that should launch the dialog. This allows the dialog to be launched from a Fragment, and will allow the fragment to receive the onActivityResult call rather than the Activity.

Parameters:

fragment - the fragment that contains this control

build

public FacebookDialog build()

Constructs a FacebookDialog with an Intent that is correctly populated to present the dialog within the Facebook application.

Returns:

a FacebookDialog instance

canPresent

public boolean canPresent()

Determines whether the native dialog can be presented (i.e., whether the required version of the Facebook application is installed on the device, and whether the installed version supports all of the parameters specified for the dialog).

Returns:

true if the dialog can be presented; false if not

addImageAttachments

protected List<String> addImageAttachments(Collection<android.graphics.Bitmap> bitmaps)

addImageAttachmentFiles

protected List<String> addImageAttachmentFiles(Collection<File> bitmapFiles)

addImageAttachment

protected CONCRETE addImageAttachment(String imageName,
                                      android.graphics.Bitmap bitmap)

addImageAttachment

protected CONCRETE addImageAttachment(String imageName,
                                      File attachment)