<AGSPopupsContainerDelegate> Protocol Reference

---

Description

A protocol that must be adopted by any class wishing to be notified when AGSPopupsContainerViewController detects user interaction with popups or if a user tries to edit a popup. An instance of the class must then be set as the delegate of AGSPopupsContainerViewController.

All methods of this protocol are optional.

Since:

2.0

List of all members.

Public Member Functions
(void)	- popupsContainer:didCancelEditingGraphicForPopup:
(void)	- popupsContainer:didChangeToCurrentPopup:
(void)	- popupsContainer:didFinishEditingGraphicForPopup:
(void)	- popupsContainer:didStartEditingGraphicForPopup:
(void)	- popupsContainer:readyToEditGraphicGeometry:forPopup:
(BOOL)	- popupsContainer:shouldAutorotateToInterfaceOrientation:forViewController:ofType:
(AGSGeometry *)	- popupsContainer:wantsNewMutableGeometryForPopup:
(void)	- popupsContainer:wantsToDeleteGraphicForPopup:
(void)	- popupsContainer:wantsToHideViewController:ofType:
(void)	- popupsContainer:wantsToShowViewController:ofType:fromViewController:atRect:
(void)	- popupsContainerDidFinishViewingPopups:

---

Member Function Documentation

- (void) popupsContainer:		(id< AGSPopupsContainer >)	popupsContainer
didCancelEditingGraphicForPopup:		(AGSPopup *)	popup
				[optional]

The method called by the AGSPopupsContainer when the user cancels editing the current popup.

Parameters:

	popupsContainer	The popup view controller
	popup	whose graphic was started to be edited but later cancelled

Since:

2.0

- (void) popupsContainer:		(id< AGSPopupsContainer >)	popupsContainer
didChangeToCurrentPopup:		(AGSPopup *)	popup
				[optional]

The AGSPopupsContainer will call this method when the currently showing popup changes.

Parameters:

	popupsContainer	The popup view controller
	popup	which is currently being displayed

Since:

2.0

- (void) popupsContainer:		(id< AGSPopupsContainer >)	popupsContainer
didFinishEditingGraphicForPopup:		(AGSPopup *)	popup
				[optional]

The method called by the AGSPopupsContainer when the user is done editing the current popup.

Parameters:

	popupsContainer	The popup view controller
	popup	whose graphic was edited

Since:

2.0

- (void) popupsContainer:		(id< AGSPopupsContainer >)	popupsContainer
didStartEditingGraphicForPopup:		(AGSPopup *)	popup
				[optional]

The method called by the AGSPopupsContainer when the user begins editing the current popup.

Parameters:

	popupsContainer	The popup view controller
	popup	whose graphic needs to be edited

Since:

2.0

- (void) popupsContainer:		(id< AGSPopupsContainer >)	popupsContainer
readyToEditGraphicGeometry:		(AGSGeometry *)	geometry
forPopup:		(AGSPopup *)	popup
				[optional]

Tells the delegate that a user is ready to edit the geometry for the current popup. This will happen when the user clicks the toolbar item for editing the geometry. Or if the editing mode is "Geometry Inline", it will happen when editing begins.

Parameters:

	popupsContainer	The popup view controller
	geometry	If you are using an AGSSketchGraphicsLayer, this will be the same geometry that you give the AGSSketchGraphicsLayer.
	popup	whose graphic's geometry needs to be edited

Since:

2.0

- (BOOL) popupsContainer:		(id< AGSPopupsContainer >)	popupsContainer
shouldAutorotateToInterfaceOrientation:		(UIInterfaceOrientation)	interfaceOrientation
forViewController:		(UIViewController *)	vc
ofType:		(AGSPopupViewType)	viewType
				[optional]

The AGSPopupsContainer will call this delegate method when it one of it's view controllers needs to know if it can auto-rotate to an certain interface orientation. If you don't implement this method then we just always return YES.

Parameters:

	popupsContainer	The popup view controller
	interfaceOrientation	The orientation to change to
	vc	The view controller that needs to respond to orientation change
	viewType	the predefined type of the view controller

Since:

2.0

- (AGSGeometry*) popupsContainer:		(id< AGSPopupsContainer >)	popupsContainer
wantsNewMutableGeometryForPopup:		(AGSPopup *)	popup
				[optional]

Tells the delegate that a new mutable geometry is required for a graphic that currently has no geometry. Must return a mutable geometry.

Parameters:

	popupsContainer	The popup view controller
	popup	Popup for who's graphic we need a geometry for.

Since:

2.0

- (void) popupsContainer:		(id< AGSPopupsContainer >)	popupsContainer
wantsToDeleteGraphicForPopup:		(AGSPopup *)	popup
				[optional]

The method called by the AGSPopupsContainer when the user presses the delete button. The implementer of this method must actually delete the graphic.

Parameters:

	popupsContainer	The popup view controller
	popup	whose graphic needs to be deleted

Since:

2.0

- (void) popupsContainer:		(id< AGSPopupsContainer >)	popupsContainer
wantsToHideViewController:		(UIViewController *)	vc
ofType:		(AGSPopupViewType)	viewType
				[optional]

The AGSPopupsContainer will call this method on the delegate when a view controller needs to be hidden. You need to implement this if you implement popupsContainer:wantsToShowViewController:fromViewController:atRect, so that you can hide a view controller in the proper way if you've shown it in a custom manner.

Parameters:

	popupsContainer	The popup view controller
	vc	The view controller that needs to be hidden
	viewType	the predefined type of the view controller

Since:

2.0

- (void) popupsContainer:		(id< AGSPopupsContainer >)	popupsContainer
wantsToShowViewController:		(UIViewController *)	svc
ofType:		(AGSPopupViewType)	viewType
fromViewController:		(UIViewController *)	fvc
atRect:		(CGRect)	rect
				[optional]

The AGSPopupsContainer will call this method on the delegate when a view controller needs to be presented. This method is optional, but if you want to show view controllers in different ways than the standard modal way, then you need to implement this method.

Parameters:

	popupsContainer	The popup view controller
	svc	The view controller that needs to be displayed
	viewType	The predefined type of the view controller
	fvc	The view controller that is currently being displayed
	rect	The rect is in the coordinate space of the fromViewController. Only applicable if viewType is AGSPopupViewTypeUIImagePicker

Since:

2.0

- (void) popupsContainerDidFinishViewingPopups:

(id< AGSPopupsContainer >)

popupsContainer

[optional]

The method that is called when the user is done viewing the popups.

Parameters:

popupsContainer

The popup view controller

Since:

2.0