Alternative UISplitViewController (display MasterView in the portrait orientation of the device)

As noted in the article “Pop-ups. Work with UIPopoverController ” in the iPhone SDK 3.2 new interface elements were added: UIPopoverController and UISplitViewController. About the first of them already quite extensively described in Habré. I want to talk about UISplitViewController, or rather about some alternative.

“Why is this alternative needed?”, You ask, “what is the reason?”. It’s all a matter of the behavior of SplitView, here's an excerpt from the SDK: “It’s a view of the landscape orientation”. Those. in portrait orientation, the right side (MasterView) is simply hidden (see fig. 1)


Figure 1 - SplitView in landscape (a) and portrait (b) orientation
')
Looking at the main settings of the iPad, we will see a completely different picture: in the portrait and landscape orientation, the left side (MasterView) is displayed the same way (it does not hide)


Figure 2 - Basic iPad Settings

Well, let's build our SplitView, where the left side would not hide with blackjack and whores, although to hell with SplitView and blackjack .

Start by creating a new project in Xcode (View-based Application). I gave it the name AlternativeSplit (see Figure 3).


Figure 3- Creating a new project

Next, add two new MasterViewController (subclass of UITableViewController) and DetailViewController (subclass of UIViewController) classes to the project by selecting File-> New file ... -> Cocoa Touch Class-> UIViewController subclass from the menu.

Open AlternativeSplitViewController.xib in InterfaceBuilder and “draw something like this”:


Figure 4 - Editing AlternativeSplitViewController.xib

Set up Autosizing so that our view doesn't “float” when switching from one orientation to another. For the left side of the Master (NavigationBar and TableView), we specify the same parameters as in Figure 5.a, and for the right Detail (NavigationBar and View), as in fig. 5 B


Figure 5 - Autosizing options

Add a new IBOutlet variable to the AlternativeSplitViewControlle.h class by editing the file
AlternativeSplitViewController.h as follows

// // AlternativeSplitViewController.h // AlternativeSplit // #import <UIKit/UIKit.h> @ class MasterViewController; @ interface AlternativeSplitViewController : UIViewController { IBOutlet MasterViewController* masterViewController; } @end * This source code was highlighted with Source Code Highlighter .

1. // // AlternativeSplitViewController.h // AlternativeSplit // #import <UIKit/UIKit.h> @ class MasterViewController; @ interface AlternativeSplitViewController : UIViewController { IBOutlet MasterViewController* masterViewController; } @end * This source code was highlighted with Source Code Highlighter .
2. // // AlternativeSplitViewController.h // AlternativeSplit // #import <UIKit/UIKit.h> @ class MasterViewController; @ interface AlternativeSplitViewController : UIViewController { IBOutlet MasterViewController* masterViewController; } @end * This source code was highlighted with Source Code Highlighter .
3. // // AlternativeSplitViewController.h // AlternativeSplit // #import <UIKit/UIKit.h> @ class MasterViewController; @ interface AlternativeSplitViewController : UIViewController { IBOutlet MasterViewController* masterViewController; } @end * This source code was highlighted with Source Code Highlighter .
4. // // AlternativeSplitViewController.h // AlternativeSplit // #import <UIKit/UIKit.h> @ class MasterViewController; @ interface AlternativeSplitViewController : UIViewController { IBOutlet MasterViewController* masterViewController; } @end * This source code was highlighted with Source Code Highlighter .
5. // // AlternativeSplitViewController.h // AlternativeSplit // #import <UIKit/UIKit.h> @ class MasterViewController; @ interface AlternativeSplitViewController : UIViewController { IBOutlet MasterViewController* masterViewController; } @end * This source code was highlighted with Source Code Highlighter .
6. // // AlternativeSplitViewController.h // AlternativeSplit // #import <UIKit/UIKit.h> @ class MasterViewController; @ interface AlternativeSplitViewController : UIViewController { IBOutlet MasterViewController* masterViewController; } @end * This source code was highlighted with Source Code Highlighter .
7. // // AlternativeSplitViewController.h // AlternativeSplit // #import <UIKit/UIKit.h> @ class MasterViewController; @ interface AlternativeSplitViewController : UIViewController { IBOutlet MasterViewController* masterViewController; } @end * This source code was highlighted with Source Code Highlighter .
8. // // AlternativeSplitViewController.h // AlternativeSplit // #import <UIKit/UIKit.h> @ class MasterViewController; @ interface AlternativeSplitViewController : UIViewController { IBOutlet MasterViewController* masterViewController; } @end * This source code was highlighted with Source Code Highlighter .
9. // // AlternativeSplitViewController.h // AlternativeSplit // #import <UIKit/UIKit.h> @ class MasterViewController; @ interface AlternativeSplitViewController : UIViewController { IBOutlet MasterViewController* masterViewController; } @end * This source code was highlighted with Source Code Highlighter .
10. // // AlternativeSplitViewController.h // AlternativeSplit // #import <UIKit/UIKit.h> @ class MasterViewController; @ interface AlternativeSplitViewController : UIViewController { IBOutlet MasterViewController* masterViewController; } @end * This source code was highlighted with Source Code Highlighter .

// // AlternativeSplitViewController.h // AlternativeSplit // #import <UIKit/UIKit.h> @ class MasterViewController; @ interface AlternativeSplitViewController : UIViewController { IBOutlet MasterViewController* masterViewController; } @end * This source code was highlighted with Source Code Highlighter .

The MasterViewController class will be responsible for the table containing the menu items. Let's rewrite it as follows (briefly: we fill the table below in the code and when the user selects a table cell (didSelectRowAtIndexPath), we send a DetailView message):

1. //
2. // MasterViewController.h
3. // AlternativeSplit
4. //
5. #import <UIKit / UIKit.h>
6. @ class DetailViewController;
8. @ interface MasterViewController: UITableViewController {
9. IBOutlet DetailViewController * detailViewController;
10. }
12. @end

* This source code was highlighted with Source Code Highlighter .

2. //
3. // MasterViewController.m
4. // AlternativeSplit
5. //
6. #import "MasterViewController.h"
7. #import "DetailViewController.h"
9. @implementation MasterViewController
11. #pragma mark -
12. #pragma mark View lifecycle
14. - (BOOL) shouldAutorotateToInterfaceOrientation: (UIInterfaceOrientation) interfaceOrientation {
15. // Override to allow orientations.
16. return YES;
17. }
18. #pragma mark -
19. #pragma mark Table view data source
20. - (NSInteger) numberOfSectionsInTableView: (UITableView *) tableView {
21. // Return the number of sections.
22. return 1;
23. }
24. - (NSInteger) tableView: (UITableView *) tableView numberOfRowsInSection: (NSInteger) section {
25. // Return the number of rows in the section.
26. return 5;
27. }
28. // Customize the appearance of the table view cells.
29. - (UITableViewCell *) tableView: (UITableView *) tableView cellForRowAtIndexPath: (NSIndexPath *) indexPath {
31. static NSString * CellIdentifier = @ "Cell" ;
33. UITableViewCell * cell = [tableView dequeueReusableCellWithIdentifier: CellIdentifier];
34. if (cell == nil) {
35. cell = [[[UITableViewCell alloc] initWithStyle: UITableViewCellStyleDefault reuseIdentifier: CellIdentifier] autorelease];
36. }
37. // Configure the cell ...
38. cell.textLabel.text = [NSString stringWithFormat: @ "Row% i" , indexPath.row];
39. return cell;
40. }
41. #pragma mark -
42. #pragma mark Table view delegate
44. - ( void ) tableView: (UITableView *) tableView didSelectRowAtIndexPath: (NSIndexPath *) indexPath {
46. [detailViewController setNewText: [NSString stringWithFormat: @ "Row% i" , indexPath.row]];
47. }
50. #pragma mark -
51. #pragma mark Memory management
53. - ( void ) didReceiveMemoryWarning {
54. // Releases the view if it doesn't have a superview.
55. [super didReceiveMemoryWarning];
57. // Relinquish ownership any cached data, images, etc that are not use.
58. }
60. - ( void ) dealloc {
61. [super dealloc];
62. }
63. @end

* This source code was highlighted with Source Code Highlighter .

DetailViewController will be responsible for the right side. Edit the DetailViewController class (add a new IBOutlet variable UILabel * lbl and a new method setNewText, which will change the text of our lbl)

1. //
2. // DetailViewController.h
3. // AlternativeSplit
4. //
5. #import <UIKit / UIKit.h>
7. @ interface DetailViewController: UIViewController {
8. IBOutlet UILabel * lbl;
9. }
10. - ( void ) setNewText: (NSString *) text;
11. @end

* This source code was highlighted with Source Code Highlighter .

1. //
2. // DetailViewController.m
3. // AlternativeSplit
4. //
6. #import "DetailViewController.h"
7. @implementation DetailViewController
8. - ( void ) setNewText: (NSString *) text {
9. lbl.text = text;
10. }
11. - (BOOL) shouldAutorotateToInterfaceOrientation: (UIInterfaceOrientation) interfaceOrientation {
12. // Overriden to allow any orientation.
13. return YES;
14. }
15. - ( void ) didReceiveMemoryWarning {
16. // Releases the view if it doesn't have a superview.
17. [super didReceiveMemoryWarning];
19. // Release any cached data, images, etc that are not in use.
20. }
21. - ( void ) viewDidUnload {
22. [super viewDidUnload];
23. // Release any retained subviews of the main view.
24. // eg self.myOutlet = nil;
25. }
26. - ( void ) dealloc {
27. [super dealloc];
28. }
29. @end

* This source code was highlighted with <a href="http://virtser.net/blog/post/source-code-highlighter.aspx"> Source Code Highlighter .

All we have to do is bind our IBOutlet variables in interfaceBuildere (see Figure 6). And it's in the hat.


Figure 6 - Binding IBOutlet Variables

Result:


Figure 7 - Alternate SplitView

Source code can be downloaded here or here .

Thanks for attention.
PS There is a certain continuation of this article: “With a flick of the wrist, the UITabBar pants turn, the UITabBar pants turn… into elegant UISplitView shorts ” (a kind of crutch when porting an iPhone application to an iPad). Should I write?