Establishing iOS 6 Outlets and Actions using the Xcode Assistant Editor

From Techotopia
Jump to: navigation, search
PreviousTable of ContentsNext
Writing iOS 6 Code to Hide the iPhone KeyboardUnderstanding iPhone iOS 6 Views, Windows and the View Hierarchy


Learn SwiftUI and take your iOS Development to the Next Level
SwiftUI Essentials – iOS 16 Edition book is now available in Print ($39.99) and eBook ($29.99) editions. Learn more...

Buy Print Preview Book


In the preceding few chapters we have looked at the concepts of actions and outlets and subsequently worked through a simple example application intended to put this theory into practice. Within the example project outlined in the chapter entitled Creating an Interactive iOS 6 iPhone App, we manually entered the declarations for both the outlets and actions contained within the application code. In practice, however, Xcode provides a second mechanism for implementing actions and outlets via a feature of Xcode known as the Assistant Editor.

The goal of this chapter is to outline how the Xcode Assistant Editor can be used to implement actions and outlets within an application project.

Having covered this topic, the choice of whether to create those actions and outlets manually or using the Assistant Editor will be left to the discretion and preference of the individual reader for a number of reasons.

Firstly, some developers still prefer to manually implement actions and outlets. Secondly, the Assistant Editor approach to action and outlet declaration makes the assumption that the user interface will always be the first part of an application to be developed. In practice, it is often the case that the back end logic of an application will be developed before the user interface is implemented. In fact, in many software development teams the user interface will be implemented by a human interface specialist or graphic designer while the code is written by the developer, with the two elements being combined in a later stage of the development process. That said, for the average developer the Assistant Editor can save considerable amounts of effort when implementing actions and outlets. For this reason, most tutorials in the remainder of this book will use the Assistant Editor when establishing outlet and action connections.


Contents


Displaying the Assistant Editor

The Assistant Editor is not displayed by default when Xcode is initially started. It may, however, be displayed on demand by selecting the View -> Assistant Editor -> Show Assistant Editor menu option. Alternatively, it may also be displayed by selecting the center button (the one containing an image of a bow tie and tuxedo) of the row of Editor toolbar buttons in the top right hand corner of the main Xcode window as illustrated in the following figure:


The Xcode 4.5 Assistant Editor toolbar button

Figure 13-1


In the event that multiple Assistant Editor panels are required, additional tiles may be added using the View -> Assistant Editor -> Add Assistant Editor menu option.

By default, the editor panel will appear to the right of the main editing panel in the Xcode window. For example, in Figure 13-2 the panel to the immediate right of the Interface Builder panel is the Assistant Editor:


The Xcode Assistant Editor

Figure 13-2


By default, the Assistant Editor will be in Automatic mode, whereby it automatically attempts to display the correct source file based on the currently selected item in Interface Builder. If the correct file is not displayed, use the toolbar along the top of the editor panel to select the correct file. The small instance of the tuxedo icon in this toolbar can be used to switch to Manual mode allowing the file to be selected from a pull-right menu containing all the source files in the project

Using the Assistant Editor

In the remainder of this chapter we will create a simple project and use it to demonstrate the ease with which outlets and actions may be declared using the Assistant Editor. For the purposes of this example, create a new Xcode iPhone project named Assistant using the Single View Application template. Once the project has been created, select the AssistantViewController.xib file so that the Interface Builder panel appears, and then drag and drop a button and label onto the view canvas:

Xcode assistant editor ui.png

Figure 13-3


The ultimate goal of the application is to display a message on the label when the button is touched. In order to achieve this it will be necessary to implement an action method for the button to call and an outlet to provide access to the text property of the label. As outlined in the chapter entitled Creating an Interactive iOS 6 iPhone App, this can be achieved by manually adding the appropriate declarations to the interface and implementation files of the view controller. This time, however, the Assistant Editor is going to do the work for us.


Adding an Outlet using the Assistant Editor

Assuming that the Interface Builder panel is still visible, select the label object in the view canvas and display the Assistant Editor panel as outlined earlier in the chapter, verifying that the panel is displaying the contents of the AssistantViewController.h file. In order to establish an outlet for the label object, simply Ctrl-click on the label object in the view and drag the resulting line to the area immediately beneath the @interface directive in the Assistant Editor panel as illustrated in Figure 13-4:


Creating an outlet connection using the Xcode Assistant Editor

Figure 13-4


Upon releasing the line, the configuration panel illustrated in Figure 13 5 will appear requesting details about the outlet to be defined.


The Xcode Assistant Editor outlet connection panel

Figure 13-5


Since this is an outlet the Connection menu should be left as Outlet. The type and storage values are also correct for this type of outlet. The only task that remains is to enter a name for the outlet, so in the Name field enter statusLabel before clicking on the Connect button.

Once the connection has been established, select the AssistantViewController.h file and note that the outlet property has been declared for us by the assistant:

#import <UIKit/UIKit.h>

@interface AssistantViewController : UIViewController
@property (strong, nonatomic) IBOutlet UILabel *statusLabel;

@end

Clearly, this saves a considerable amount of effort when declaring outlets. The same is also true of actions.

Adding an Action using the Assistant Editor

The steps to declare an action using the Assistant Editor are essentially the same as those for an outlet. Once again, select the AssistantViewController.xib file, but this time Ctrl-click on the button object. Drag the resulting line to the area beneath the @interface line in the Assistant Editor panel before releasing it. The connection box will once again appear. Since we are creating an action rather than an outlet, change the Connection menu to Action. Name the action buttonTouched and make sure the Event type is set to Touch Up Inside. Since we will not need access to the button object within our action method change the Arguments menu to None:


Establishing an Xcode action connection

Figure 13-6


Click on the Connect button to create the action.

Select the AssistantViewController.h file and note that the action has now been declared for us by the assistant:

#import <UIKit/UIKit.h>

@interface AssistantViewController : UIViewController
- (IBAction)buttonTouched;
@property (strong, nonatomic) IBOutlet UILabel *statusLabel;

@end

Next, select the AssistantViewController.m file and note that a stub method for the action has also been added automatically:

- (IBAction)buttonTouched {
}

All that remains, therefore, is to implement the code in the action method to display some text on the label via the statusLabel outlet:

- (IBAction)buttonTouched {
    _statusLabel.text = @”Hello";
}

Compile and run the application and touch the button to display the “Hello” text on the label.

Summary

The task of implementing actions and outlets can be significantly eased by making use of the Xcode Assistant Editor. This chapter has worked through the use of the Assistant Editor to establish both outlet and action connections. Since both this method and hand coding are valid options for implementing actions and outlets, feel free to use the mechanism with which you are most comfortable in the remainder of this book.


Learn SwiftUI and take your iOS Development to the Next Level
SwiftUI Essentials – iOS 16 Edition book is now available in Print ($39.99) and eBook ($29.99) editions. Learn more...

Buy Print Preview Book



PreviousTable of ContentsNext
Writing iOS 6 Code to Hide the iPhone KeyboardUnderstanding iPhone iOS 6 Views, Windows and the View Hierarchy