FBPlacePickerViewController

Questa classe non è più disponibile nella versione più recente dell'SDK.
Non è disponibile una versione più recente di questa classe. Controlla la versione più recente.

The FBPlacePickerViewController class creates a controller object that manages the user interface for displaying and selecting nearby places.

Discussion:

When the FBPlacePickerViewController view loads it creates a UITableView object where the places near a given location will be displayed. You can access this view through the tableView property.

The place data can be pre-fetched and cached prior to using the view controller. The cache is setup using an FBCacheDescriptor object that can trigger the data fetch. Any place data requests will first check the cache and use that data. If the place picker is being displayed cached data will initially be shown before a fresh copy is retrieved.

The delegate property may be set to an object that conforms to the FBPlacePickerDelegate protocol. The delegate object will receive updates related to place selection and data changes. The delegate can also be used to filter the places to display in the picker.

Inherits from:	`FBViewController`
Declared in:	`FBPlacePickerViewController.h`

Proprietà

fieldsForRequest

Addtional fields to fetch when making the Graph API call to get place data.

@property (nonatomic,
    copy) NSSet *fieldsForRequest;

Tipo dichiarato in: FBPlacePickerViewController.h

itemPicturesEnabled

A Boolean value that indicates whether place profile pictures are displayed.

@property (nonatomic) BOOL itemPicturesEnabled;

Tipo dichiarato in: FBPlacePickerViewController.h

locationCoordinate

The coordinates to use for place discovery.

@property (nonatomic) CLLocationCoordinate2D locationCoordinate;

Tipo dichiarato in: FBPlacePickerViewController.h

radiusInMeters

The radius to use for place discovery.

@property (nonatomic) NSInteger radiusInMeters;

Tipo dichiarato in: FBPlacePickerViewController.h

resultsLimit

The maximum number of places to fetch.

@property (nonatomic) NSInteger resultsLimit;

Tipo dichiarato in: FBPlacePickerViewController.h

searchText

The search words used to narrow down the results returned.

@property (nonatomic,
    copy) NSString *searchText;

Tipo dichiarato in: FBPlacePickerViewController.h

selection

The place that is currently selected in the view. This is nil if nothing is selected.

@property (nonatomic,
    retain,
    readonly) id<FBGraphPlace> selection;

Tipo dichiarato in: FBPlacePickerViewController.h

session

The session that is used in the request for place data.

@property (nonatomic,
    retain) FBSession *session;

Tipo dichiarato in: FBPlacePickerViewController.h

spinner

Returns an outlet for the spinner used in the view controller.

@property (nonatomic,
    retain) IBOutlet UIActivityIndicatorView *spinner;

Tipo dichiarato in: FBPlacePickerViewController.h

tableView

Returns an outlet for the table view managed by the view controller.

@property (nonatomic,
    retain) IBOutlet UITableView *tableView;

Tipo dichiarato in: FBPlacePickerViewController.h

Metodi di classe

cacheDescriptorWithLocationCoordinate:radiusInMeters:searchText:resultsLimit:fieldsForRequest:

Creates a cache descriptor with additional fields and a profile ID for use with the FBPlacePickerViewController object.

Parametro	Descrizione
`locationCoordinate`	The coordinates to use for place discovery.
`radiusInMeters`	The radius to use for place discovery.
`searchText`	The search words used to narrow down the results returned.
`resultsLimit`	The maximum number of places to fetch.
`fieldsForRequest`	Addtional fields to fetch when making the Graph API call to get place data.

+ (FBCacheDescriptor*)

	`cacheDescriptorWithLocationCoordinate`
	`CLLocationCoordinate`
	`D`
	`locationCoordinate`
`radiusInMeters:`	`(NSInteger)radiusInMeters`
`searchText:`	`(NSString*)searchText`
`resultsLimit:`	`(NSInteger)resultsLimit`
`fieldsForRequest:`	`(NSSet*)fieldsForRequest;`

Discussion:

An FBCacheDescriptor object may be used to pre-fetch data before it is used by the view controller. It may also be used to configure the FBPlacePickerViewController object.

Tipo dichiarato in: FBPlacePickerViewController.h

Metodi di istanza

clearSelection

Clears the current selection, so the picker is ready for a fresh use.

- (void) clearSelection;

Tipo dichiarato in: FBPlacePickerViewController.h

configureUsingCachedDescriptor:

Configures the properties used in the caching data queries.

Parametro	Descrizione
`cacheDescriptor`	The containing the cache query properties.

- (void) configureUsingCachedDescriptor:(FBCacheDescriptor*)cacheDescriptor;

Discussion:

Cache descriptors are used to fetch and cache the data used by the view controller. If the view controller finds a cached copy of the data, it will first display the cached content then fetch a fresh copy from the server.

Tipo dichiarato in: FBPlacePickerViewController.h

init

Initializes a place picker view controller.

- (id) init;

Tipo dichiarato in: FBPlacePickerViewController.h

initWithCoder:

Initializes a place picker view controller.

Parametro	Descrizione
`aDecoder`	An unarchiver object.

- (id) initWithCoder:(NSCoder *)aDecoder;

Tipo dichiarato in: FBPlacePickerViewController.h

initWithNibName:bundle:

Initializes a place picker view controller.

Parametro	Descrizione
`nibNameOrNil`	The name of the nib file to associate with the view controller. The nib file name should not contain any leading path information. If you specify nil, the nibName property is set to nil.
`nibBundleOrNil`	The bundle in which to search for the nib file. This method looks for the nib file in the bundle's language-specific project directories first, followed by the Resources directory. If nil, this method looks for the nib file in the main bundle.

- (id)

`initWithNibName:`	`(NSString *)nibNameOrNil`
`bundle:`	`(NSBundle *)nibBundleOrNil;`

Tipo dichiarato in: FBPlacePickerViewController.h

loadData

Initiates a query to get place data the first time or in response to changes in the search criteria, filter, or location information.

- (void) loadData;

Discussion:

A cached copy will be returned if available. The cached view is temporary until a fresh copy is retrieved from the server. It is legal to call this more than once.

Tipo dichiarato in: FBPlacePickerViewController.h

updateView

Updates the view locally without fetching data from the server or from cache.

- (void) updateView;

Discussion:

Use this if the filter properties change. This may affect the order or display of information.

Tipo dichiarato in: FBPlacePickerViewController.h