Adding an option ‘completion’ block parameter to popover presentation.

Author: hsoi

WYPopoverController/WYPopoverController.h

@@ -112,11 +112,18 @@ typedef NS_OPTIONS(NSUInteger, WYPopoverAnimationOptions) {
 
 - (void)presentPopoverAsDialogAnimated:(BOOL)animated;
 
+- (void)presentPopoverFromRect:(CGRect)aRect
+                        inView:(UIView *)aView
+      permittedArrowDirections:(WYPopoverArrowDirection)arrowDirections
+                      animated:(BOOL)aAnimated
+                       options:(WYPopoverAnimationOptions)aOptions;
+
 - (void)presentPopoverFromRect:(CGRect)rect
                         inView:(UIView *)view
       permittedArrowDirections:(WYPopoverArrowDirection)arrowDirections
                       animated:(BOOL)animated
-                       options:(WYPopoverAnimationOptions)options;
+                       options:(WYPopoverAnimationOptions)options
+                    completion:(void (^)(void))completion;
 
 - (void)presentPopoverFromBarButtonItem:(UIBarButtonItem *)item
                permittedArrowDirections:(WYPopoverArrowDirection)arrowDirections

WYPopoverController/WYPopoverController.m

@@ -1548,11 +1548,31 @@ - (void)presentPopoverAsDialogAnimated:(BOOL)aAnimated
                                  options:WYPopoverAnimationOptionFade];
 }
 
+
+- (void)presentPopoverFromRect:(CGRect)aRect
+                        inView:(UIView *)aView
+      permittedArrowDirections:(WYPopoverArrowDirection)arrowDirections
+                      animated:(BOOL)aAnimated
+                       options:(WYPopoverAnimationOptions)aOptions
+{
+    [self presentPopoverFromRect:aRect
+                          inView:aView
+        permittedArrowDirections:arrowDirections
+                        animated:aAnimated
+                         options:aOptions
+                      completion:nil];
+}
+
+
+// Hsoi 2014-01-24 - Added the 'completion' parameter: adding the parameter, the invocation
+// of it, and the compatiblity version of this method that lacks the 'completion' parameter
+// so existing code can function without change.
 - (void)presentPopoverFromRect:(CGRect)aRect
                         inView:(UIView *)aView
       permittedArrowDirections:(WYPopoverArrowDirection)arrowDirections
                       animated:(BOOL)aAnimated
                        options:(WYPopoverAnimationOptions)aOptions
+                    completion:(void (^)(void))completion
 {
     NSAssert((arrowDirections != WYPopoverArrowDirectionUnknown), @"WYPopoverArrowDirection must not be UNKNOWN");
 
@@ -1650,6 +1670,11 @@ - (void)presentPopoverFromRect:(CGRect)aRect
             {
                 [self->viewController viewDidAppear:YES];
             }
+            
+            if (completion)
+            {
+                completion();
+            }
         }];
     }
     else
@@ -1660,6 +1685,11 @@ - (void)presentPopoverFromRect:(CGRect)aRect
         {
             [viewController viewDidAppear:NO];
         }
+        
+        if (completion)
+        {
+            completion();
+        }
     }
 
     if (isListeningNotifications == NO)