WAFbImpl.git - Gitblit

			@@ -20,59 +20,60 @@

			#import <FBSDKCoreKit/FBSDKCopying.h>

			/*!
			@abstract A photo for sharing.
			/**
			A photo for sharing.
			*/
			@interface FBSDKSharePhoto : NSObject <FBSDKCopying, NSSecureCoding>

			/*!
			@abstract Convenience method to build a new photo object with an image.
			@param image If the photo is resident in memory, this method supplies the data
			@param userGenerated Specifies whether the photo represented by the receiver was generated by the user or by the
			/**
			Convenience method to build a new photo object with an image.
			- Parameter image: If the photo is resident in memory, this method supplies the data
			- Parameter userGenerated: Specifies whether the photo represented by the receiver was generated by the user or by the
			application
			*/
			+ (instancetype)photoWithImage:(UIImage *)image userGenerated:(BOOL)userGenerated;

			/*!
			@abstract Convenience method to build a new photo object with an imageURL.
			@param imageURL The URL to the photo
			@param userGenerated Specifies whether the photo represented by the receiver was generated by the user or by the
			/**
			Convenience method to build a new photo object with an imageURL.
			- Parameter imageURL: The URL to the photo
			- Parameter userGenerated: Specifies whether the photo represented by the receiver was generated by the user or by the
			application
			@discussion This method should only be used when adding photo content to open graph stories.

			This method should only be used when adding photo content to open graph stories.
			For example, if you're trying to share a photo from the web by itself, download the image and use
			`photoWithImage:userGenerated:` instead.
			*/
			+ (instancetype)photoWithImageURL:(NSURL *)imageURL userGenerated:(BOOL)userGenerated;

			/*!
			@abstract If the photo is resident in memory, this method supplies the data.
			@return UIImage representation of the photo
			/**
			If the photo is resident in memory, this method supplies the data.
			- Returns: UIImage representation of the photo
			*/
			@property (nonatomic, strong) UIImage *image;

			/*!
			@abstract The URL to the photo.
			@return URL that points to a network location or the location of the photo on disk
			/**
			The URL to the photo.
			- Returns: URL that points to a network location or the location of the photo on disk
			*/
			@property (nonatomic, copy) NSURL *imageURL;

			/*!
			@abstract Specifies whether the photo represented by the receiver was generated by the user or by the application.
			@return YES if the photo is user-generated, otherwise NO
			/**
			Specifies whether the photo represented by the receiver was generated by the user or by the application.
			- Returns: YES if the photo is user-generated, otherwise NO
			*/
			@property (nonatomic, assign, getter=isUserGenerated) BOOL userGenerated;

			/*!
			@abstract Compares the receiver to another photo.
			@param photo The other photo
			@return YES if the receiver's values are equal to the other photo's values; otherwise NO
			/**
			Compares the receiver to another photo.
			- Parameter photo: The other photo
			- Returns: YES if the receiver's values are equal to the other photo's values; otherwise NO
			*/
			- (BOOL)isEqualToSharePhoto:(FBSDKSharePhoto *)photo;

			/*!
			@abstract The user generated caption for the photo. Note that the 'caption' must come from
			/**
			The user generated caption for the photo. Note that the 'caption' must come from
			* the user, as pre-filled content is forbidden by the Platform Policies (2.3).
			@return the Photo's caption if exists else returns null.
			- Returns: the Photo's caption if exists else returns null.
			*/
			@property (nonatomic, copy) NSString *caption;