[TIMOB-6356] iOS: DashboardView change of page event

apidoc/Titanium/UI/DashboardView.yml

@@ -120,6 +120,15 @@ events:
         summary: List of items to be committed, possibly in new order, when edit mode ends.
         type: Array<Titanium.UI.DashboardItem>
 
+  - name: pagechanged
+    summary: Fired when the current page of the dashboard view changes.
+    properties:
+      - name: pageNo
+        summary: The current page number.
+        type: Number
+    since: '3.1.0'
+
+
 methods:
   - name: startEditing
     summary: Enable edit mode.

iphone/Classes/LauncherView.h

@@ -101,6 +101,8 @@
 
 - (BOOL)launcherViewShouldWobble:(LauncherView*)launcher;
 
+- (void)launcherView:(LauncherView*)launcher didChangePage:(NSNumber*)pageNo;
+
 @end
 
 #endif

iphone/Classes/LauncherView.m

@@ -198,7 +198,6 @@ - (void)updateContentSize:(NSInteger)numberOfPages
 	if (numberOfPages != pager.numberOfPages) 
 	{
 		pager.numberOfPages = numberOfPages;
-		[pager setCurrentPage:numberOfPages-1];
 	}
 }
 - (void)layoutButtons 
@@ -273,7 +272,13 @@ - (void)recreateButtons
 
 	[self layoutButtons];
 
-	[pager setCurrentPage:curIndex];
+    NSInteger oldPageNo = pager.currentPage;
+    [pager setCurrentPage:curIndex];
+    if (oldPageNo != curIndex) {
+        if ([delegate respondsToSelector:@selector(launcherView:didChangePage:)]) {
+            [delegate launcherView:self didChangePage:[NSNumber numberWithInteger:pager.currentPage]];
+        }
+    }
 }
 
 - (void)scrollToItem:(LauncherItem*)item animated:(BOOL)animated 
@@ -663,8 +668,13 @@ - (void)endEditing
 	}
 
 	[self layoutButtons];
-
+	NSInteger oldPageNo = pager.currentPage;
 	[pager setCurrentPage:curIndex];
+	if (oldPageNo != curIndex) {
+		if ([delegate respondsToSelector:@selector(launcherView:didChangePage:)]) {
+			[delegate launcherView:self didChangePage:[NSNumber numberWithInteger:pager.currentPage]];
+		}
+	}
 
 	if ([delegate respondsToSelector:@selector(launcherViewDidEndEditing:)]) 
 	{
@@ -755,8 +765,15 @@ - (void)checkButtonOverflow:(NSInteger)pageIndex
 
 - (void)updatePagerWithContentOffset:(CGPoint)contentOffset 
 {
-	CGFloat pageWidth = scrollView.frame.size.width;
-	pager.currentPage = floor((contentOffset.x - pageWidth / 2) / pageWidth) + 1;
+    CGFloat pageWidth = scrollView.frame.size.width;
+    NSInteger oldPageNo = pager.currentPage;
+    pager.currentPage = floor((contentOffset.x - pageWidth / 2) / pageWidth) + 1;
+    if (oldPageNo != pager.currentPage) {
+        if ([delegate respondsToSelector:@selector(launcherView:didChangePage:)]) {
+            [delegate launcherView:self didChangePage:[NSNumber numberWithInteger:pager.currentPage]];
+        }
+
+    }
 }
 
 - (void)springLoadTimer:(NSTimer*)timer 
@@ -917,7 +934,10 @@ - (BOOL)editing
 
 - (void)pageChanged 
 {
-	scrollView.contentOffset = CGPointMake(pager.currentPage * scrollView.frame.size.width, 0);
+    if ([delegate respondsToSelector:@selector(launcherView:didChangePage:)]) {
+        [delegate launcherView:self didChangePage:[NSNumber numberWithInteger:pager.currentPage]];
+    }
+    scrollView.contentOffset = CGPointMake(pager.currentPage * scrollView.frame.size.width, 0);
 }
 
 - (void)scrollViewWillBeginDragging:(UIScrollView*)scrollView 

iphone/Classes/TiUIDashboardView.m

@@ -100,6 +100,15 @@ -(void)stopEditing
 
 #pragma mark Delegates 
 
+- (void)launcherView:(LauncherView*)launcher didChangePage:(NSNumber*)pageNo;
+{
+    if ([self.proxy _hasListeners:@"pagechanged"]) {
+        NSMutableDictionary *event = [NSMutableDictionary dictionary];
+        [event setObject:pageNo forKey:@"pageNo"];
+        [self.proxy fireEvent:@"pagechanged" withObject:event propagate:NO];
+    }
+}
+
 - (void)launcherView:(LauncherView*)launcher didAddItem:(LauncherItem*)item
 {
 }