Classes/DetailViewManager.m
/* |
File: DetailViewManager.m |
Abstract: The split view controller's delegate. It coordinates the display of detail view controllers. |
Version: 1.2 |
Disclaimer: IMPORTANT: This Apple software is supplied to you by Apple |
Inc. ("Apple") in consideration of your agreement to the following |
terms, and your use, installation, modification or redistribution of |
this Apple software constitutes acceptance of these terms. If you do |
not agree with these terms, please do not use, install, modify or |
redistribute this Apple software. |
In consideration of your agreement to abide by the following terms, and |
subject to these terms, Apple grants you a personal, non-exclusive |
license, under Apple's copyrights in this original Apple software (the |
"Apple Software"), to use, reproduce, modify and redistribute the Apple |
Software, with or without modifications, in source and/or binary forms; |
provided that if you redistribute the Apple Software in its entirety and |
without modifications, you must retain this notice and the following |
text and disclaimers in all such redistributions of the Apple Software. |
Neither the name, trademarks, service marks or logos of Apple Inc. may |
be used to endorse or promote products derived from the Apple Software |
without specific prior written permission from Apple. Except as |
expressly stated in this notice, no other rights or licenses, express or |
implied, are granted by Apple herein, including but not limited to any |
patent rights that may be infringed by your derivative works or by other |
works in which the Apple Software may be incorporated. |
The Apple Software is provided by Apple on an "AS IS" basis. APPLE |
MAKES NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION |
THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS |
FOR A PARTICULAR PURPOSE, REGARDING THE APPLE SOFTWARE OR ITS USE AND |
OPERATION ALONE OR IN COMBINATION WITH YOUR PRODUCTS. |
IN NO EVENT SHALL APPLE BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL |
OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF |
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS |
INTERRUPTION) ARISING IN ANY WAY OUT OF THE USE, REPRODUCTION, |
MODIFICATION AND/OR DISTRIBUTION OF THE APPLE SOFTWARE, HOWEVER CAUSED |
AND WHETHER UNDER THEORY OF CONTRACT, TORT (INCLUDING NEGLIGENCE), |
STRICT LIABILITY OR OTHERWISE, EVEN IF APPLE HAS BEEN ADVISED OF THE |
POSSIBILITY OF SUCH DAMAGE. |
Copyright (C) 2012 Apple Inc. All Rights Reserved. |
*/ |
#import "DetailViewManager.h" |
@interface DetailViewManager () |
// Holds a reference to the split view controller's bar button item |
// if the button should be shown (the device is in portrait). |
// Will be nil otherwise. |
@property (nonatomic, retain) UIBarButtonItem *navigationPaneButtonItem; |
// Holds a reference to the popover that will be displayed |
// when the navigation button is pressed. |
@property (nonatomic, retain) UIPopoverController *navigationPopoverController; |
@end |
@implementation DetailViewManager |
// ------------------------------------------------------------------------------- |
// setDetailViewController: |
// Custom implementation of the setter for the detailViewController property. |
// ------------------------------------------------------------------------------- |
- (void)setDetailViewController:(UIViewController<SubstitutableDetailViewController> *)detailViewController |
{ |
// Clear any bar button item from the detail view controller that is about to |
// no longer be displayed. |
self.detailViewController.navigationPaneBarButtonItem = nil; |
_detailViewController = detailViewController; |
// Set the new detailViewController's navigationPaneBarButtonItem to the value of our |
// navigationPaneButtonItem. If navigationPaneButtonItem is not nil, then the button |
// will be displayed. |
_detailViewController.navigationPaneBarButtonItem = self.navigationPaneButtonItem; |
// Update the split view controller's view controllers array. |
// This causes the new detail view controller to be displayed. |
UIViewController *navigationViewController = [self.splitViewController.viewControllers objectAtIndex:0]; |
NSArray *viewControllers = [[NSArray alloc] initWithObjects:navigationViewController, _detailViewController, nil]; |
self.splitViewController.viewControllers = viewControllers; |
[viewControllers release]; |
// Dismiss the navigation popover if one was present. This will |
// only occur if the device is in portrait. |
if (self.navigationPopoverController) |
[self.navigationPopoverController dismissPopoverAnimated:YES]; |
} |
#pragma mark - |
#pragma mark UISplitViewDelegate |
// ------------------------------------------------------------------------------- |
// splitViewController:shouldHideViewController:inOrientation: |
// ------------------------------------------------------------------------------- |
- (BOOL)splitViewController:(UISplitViewController *)svc |
shouldHideViewController:(UIViewController *)vc |
inOrientation:(UIInterfaceOrientation)orientation |
{ |
return UIInterfaceOrientationIsPortrait(orientation); |
} |
// ------------------------------------------------------------------------------- |
// splitViewController:willHideViewController:withBarButtonItem:forPopoverController: |
// ------------------------------------------------------------------------------- |
- (void)splitViewController:(UISplitViewController *)svc |
willHideViewController:(UIViewController *)aViewController |
withBarButtonItem:(UIBarButtonItem *)barButtonItem |
forPopoverController:(UIPopoverController *)pc |
{ |
// If the barButtonItem does not have a title (or image) adding it to a toolbar |
// will do nothing. |
barButtonItem.title = @"Navigation"; |
self.navigationPaneButtonItem = barButtonItem; |
self.navigationPopoverController = pc; |
// Tell the detail view controller to show the navigation button. |
self.detailViewController.navigationPaneBarButtonItem = barButtonItem; |
} |
// ------------------------------------------------------------------------------- |
// splitViewController:willShowViewController:invalidatingBarButtonItem: |
// ------------------------------------------------------------------------------- |
- (void)splitViewController:(UISplitViewController *)svc |
willShowViewController:(UIViewController *)aViewController |
invalidatingBarButtonItem:(UIBarButtonItem *)barButtonItem |
{ |
self.navigationPaneButtonItem = nil; |
self.navigationPopoverController = nil; |
// Tell the detail view controller to remove the navigation button. |
self.detailViewController.navigationPaneBarButtonItem = nil; |
} |
@end |
Copyright © 2012 Apple Inc. All Rights Reserved. Terms of Use | Privacy Policy | Updated: 2012-09-18