TweetFollow Us on Twitter

Nov 97 - Getting Started

Volume Number: 13 (1997)
Issue Number: 11
Column Tag: Getting Started

VerySimpleText, Version 2

by Dave Mark , Copyright1997, All Rights Reserved

Three months ago, the August Getting Started column featured a program called VerySimpleText. We built this first version of VerySimpleText using ProjectBuilder and InterfaceBuilder. We started off by editing the nib file (the first version of VerySimpleText wrapped its entire user interface into a single nib file).

We added a Format submenu to the application's default menu, thus adding a series of powerful font, text, and page manipulation features to VerySimpleText. This was done by dragging a Format menu from the menu palette in the palette window.

We also added a scrollable text area (implemented by the NSScrollView class) to the default application window. We did this by dragging a scrollable text view from the DataViews portion of the palette window. We used the NSScrollView inspector to set the autosizing for this view so the scrollable text view grew and shrank along with its containing window. We used InterfaceBuilder's Test Interface feature to test out the window, making sure it looked and behaved as we wanted it to.

Next, we added an info panel (an about box) to VerySimpleText, along with a menu item to bring up the info panel. We edited an existing menu item (Info Panel...) to create our "About VerySimpleText..." item. We used the NSMenuItem inspector to enable the item (unchecking the disabled checkbox, actually). To create the panel itself, we used the Windows portion of the palette window and dragged out our new window, changing the name of the window instance in the nib window and the window's title in the inspector. We also used the palette window to drag some default text into the new info panel.

Once the about panel was built, we created an AboutPanelController class which brought up the about panel when the "About VerySimpleText..." item was selected. Working in the Classes tab within the nib window, we first subclassed NSObject, then created one outlet (abtWindow) and one action (show:). As a reminder, think of an outlet as a variable or object you want associated with your class. When InterfaceBuilder generates the source code for this class, outlets are declared in the header file as type id. An action is a method. In this case, the show: method will bring up the about panel.

Once we were done with our nib file, we told InterfaceBuilder to generate the source files for this project and to add them to the project.

Our next step was to link the "About VerySimpleText..." menu item to the AboutPanelController so when it was selected, the show: method would get called and the panel would appear. First, we instantiated our newly created AboutWindowController class. The instance appeared in the nib window's Instances tab. We then control-dragged from the "About VerySimpleText..." menu item (it's in the menu itself) to the AboutWindowController instance in the nib window. In the inspector window, we clicked the connect button to establish this link. Now, when the "About VerySimpleText..." item is selected, the AboutWindowController's show: method will be called.

Next, we control-dragged from the AboutWindowController instance to our AboutWindow instance. When the link appeared, we moved to the inspector window and clicked on the abtWindow outlet and clicked the Connect button to establish the link. This links the AboutWindowController's abtWindow variable to the AboutWindow. We added a line to the show: method to bring up the window:

- (void)show:(id)sender
{
	[abtWindow makeKeyAndOrderFront:self];
}

The Model, View, Controller Paradigm

Before we move on to this month's additions to VerySimpleText, I thought it might be useful to talk about the Model, View, Controller paradigm, described in Discovering OpenStep: A Developer Tutorial. The Model, View, Controller paradigm is also known as MVC. MVC originated with Smalltalk-80. It categorizes objects as either models, views, or controllers.

Models are objects that emulate some process or represent some knowledge-base. For example, an Employee object represents the knowledge or data associated with an employee. It is a model of an employee. A waterworks object might model the process of converting waste water to clean water and might include the data associated with that process. In general, a model object does not have a user interface. A model object may be distributable and persistent. A model class may be reusable and portable.

View objects are the user interface of your application. Anything displayed by your application is displayed in a view. For example, a window, editable, static, or scrolling text area, button, and scroll bar are all examples of view objects. View objects have no special knowledge of the data they display. In OpenStep, the Application Kit contains a complete set of view objects, all of them designed independent of any model objects. As is evidenced by the Application Kit, view objects are reusable.

Controller objects are the mediators between model objects and view objects. Typically, you'll have one controller object per window (or, possibly, a single controller for your entire application). Your controller object communicates between a model object and its representative view object. For example, an employeeController might use data from an employee object and use that data to create a visible representation of that employee within a view object. At the application level, a controller object would take care of tasks such as loading nib files and acting as a delegate for a window or application.

Delegates

Delegates allow you to provide methods that get called by a class without actually having to subclass the class. Classes which allow delegates feature a set of delegation methods. For example, the NSWindow class features a delegation method called windowWillClose. In this month's sample program, we're going to create a class called Document which will act as an NSWindow delegate. When the NSWindow object gets ready to close, it first calls the delegate's windowWillClose method (assuming the delegate provides such a method). When we define the Document class, we'll provide a windowWillClose method so you can see how this works. You might want to take a look at the NSApplication and NSWindow classes. Their delegation methods are listed at the end of their respective files.

Loading A Nib File

As you've already seen, every application comes with at least one nib file. The nib file is similar to a Macintosh resource file, though it has much more of an object orientation. In fact, one of the primary things stored in a nib file is a set of archived objects. The information in the nib file includes information about each object (like object size and location). It also reflects the position of each object in the overall object hierarchy as well as details about connections between objects in the hierarchy (connections such as the ones we created in the August version of VerySimpleText).

An important part of the object hierarchy is the File's Owner object. Figure 1 shows VerySimpleText's main nib file with the icon representing the File's Owner object in the upper left corner of the Instances tab. The File's Owner sits at the top of each nib file's archived object hierarchy and comes into play when you want to load a nib file other than the main nib file (which is loaded for you automatically).

Figure 1. VerySimpleText's main nib file, showing the File's Owner object.

This line of code:

[NSBundle loadNibNamed:@"NEXTSTEP_Document" owner:self]

loads a nib file named "NEXTSTEP_Document.nib" and sets the File's Owner of the loaded nib file to point to the specified File's Owner. For example, in this month's sample program, we'll define a Document class and we'll tell InterfaceBuilder that the Document class will act as the File's Owner in "NEXTSTEP_Document.nib". Before the nib file can be loaded, we instantiate a Document object. In the Document's init method, we'll call the method loadNibNamed, passing in the nib file name "NEXTSTEP_Document.nib", as well as the object reference self, which refers to the Document object. This second parameter is used as the newly opened nib file's owner.

And Now, Addint to Verysimpletext

Hopefully, the quick review above brought you back up to speed on the overall structure of the August version of VerySimpleText and gave you enough background to follow this month's changes. This month, we're going to add the ability to handle multiple documents to VerySimpleText. We'll tie this functionality to the Document menu's New item. You'll want to start off with a copy of the August version of VerySimpleText. Be sure to keep a copy of the original around just in case. I named my original folder VerySimpleText.01 and named the copy VerySimpleText.02. Once you've made your copy, open the ProjectBuilder project in the duplicate.

  • Find the file PB.project in the duplicate directory and double-click it to launch ProjectBuilder.
  • Next, we're going to create a new nib file.
  • Click the ProjectBuilder Interfaces item, then double-click the NEXTSTEP_VerySimpleText.01.nib file.
  • The selected nib file will be opened in InterfaceBuilder. Now to create the new file:
  • In InterfaceBuilder, select Document/New Module/New Empty.

A new, untitled nib window will appear (See Figure 2). If you click on the Instances tab, you'll see two instances. One is the File's Owner. If you click on the File's Owner icon, the inspector window (attributes popup) will list a set of classes and the NSObject class will be selected. We'll revisit this a bit later in the column.

Figure 2. The new, untitled nib file.

  • Click on the Classes tab in the new nib window.
  • Select NSObject.
  • Select Classes/Subclass.
  • Rename the new subclass from MyNSObject to Document.
  • Save the new nib file.

You'll name your new nib file as NEXTSTEP_Document.nib (you can leave off the .nib if you like). Be sure to save the new nib file in the same directory as the main nib file, NEXTSTEP_VerySimpleText.01.nib (Figure 3).

Figure 3. Saving the new nib file.

  • When asked, say yes to insert the file in the project.

You will now be in ProjectBuilder.

  • Go back to InterfaceBuilder.
  • Be sure the Document line in the nib file's Classes tab is hilited.
  • Click on the outlet icon (the left of the two icons).
  • Be sure that the Outlets line is highlighted.
  • Select Classes/Add Outlet.
  • Change the outlet name myOutlet to window.
  • Click on the outlet icon to get out of outlet mode.
  • Select Classes/Create Files.
  • When asked whether we want to create a Document.h and .m file, click Yes.
  • When asked to insert files in project, click Yes.
  • We'll be back in Project Builder.

Go back to InterfaceBuilder.

  • Back in the nib window, click on the Instances tab.
  • Click on File's Owner.

In the inspector window, the class NSObject will be selected.

  • Scroll up to Document and select it.

Document will now be highlighted when you click on File's Owner.

  • Bring the original nib file to the front.
  • In the Instances tab, select the MyWindow icon.
  • Select Edit/Cut.
  • When you are asked Do you really want to delete the window?", click Delete.
  • Bring the new nib file to the front.
  • Select Edit/Paste.

The MyWindow icon should appear in the new nib window and the window itself should reappear.

  • Hold down the control key and drag from File's Owner icon to MyWindow icon.
  • When you let go, go to the inspector window and click Connect.

You've just connect MyWindow to the File Owner's outlet (in this case, the Document classes' window variable).

  • In the NEXTSTEP_Document.nib window, control drag from MyWindow to File's Owner.
  • Select the word delegate in the left-hand column.
  • Click the Connect button.

You've just made Document MyWindow's delegate.

  • Select Document/Save.

We are now done with this nib window.

  • Bring the old nib file to the front.
  • Click on the nextstep menu to bring it to the front.
  • Select Tools/Palettes/Palettes.
  • Select the leftmost palette (Menus).
  • Drag a Document menu into the nextstep menu, just below Info

The new Document menu will appear, just to the right of the nextstep menu.

  • In the Document menu, click on New.
  • In the inspector window, select attributes from the popup menu.
  • Click the Disabled checkbox so it is unchecked.
  • In the Document menu, click on Close.
  • In the inspector window, click the Disabled checkbox so it is unchecked.
  • Click on the old nib window and select the Classes tab.
  • Click on NSObject.
  • Select Classes/Subclass.
  • Rename subclass to AppDelegate.
  • Click on action icon (on right).
  • Click on Actions line, select Classes/Add Action.
  • Rename new Action to new:.
  • Click off the Actions icon.
  • Click Classes/CreateFiles.
  • Create the files (answer yes to create files and add to project).

We are now back in ProjectBuilder.

  • Go back to InterfaceBuilder.
  • In the old nib file's classes tab, select AppDelegate line.
  • Select Classes/Instantiate.
  • In the instances tab, control-drag from File's Owner to AppDelegate.
  • In the inspector window, be sure delegate is selected, then click Connect.

We have just marked AppDelegate as the NSApplication delegate. We won't implement any of the NSApplication delegate methods in our AppDelegate code, but we could. Take a look at NSApplication and take a few of the delegation methods for a spin.

  • Go to the nextstep menu and control-drag from New to AppDelegate in the old nib window.
  • In the inspector window, select new from the actions list, then click Connect.

We've just connected the new menu item to the AppDelegate's new: method.

  • Select Document/Save.

OK. That's it for the nib files. Now all we need to do is add a bit of code and we are on our way.

  • Go to ProjectBuilder.
  • Under Classes, select Document.m.

Here's what the code looks like now:

#import "Document.h"

@implementation Document

@end
  • Edit the code so it looks like this:
#import "Document.h"

@implementation Document

- init
{
	//Find the nib and load it in.  This instance will be the
	//File's Owner object, so we pass ourself as owner
	if (![NSBundle loadNibNamed:
					@"NEXTSTEP_Document" owner:self])
	{
		//for whatever reason, we failed.  Clean up and go
		NSLog(@"Failed to load Document.nib");
		[self release];
		return nil;
	}
	return self;
}

//Since the Document is the Windows's delegate,
//it will get the following
//method called whenever the window closes.  
- (void)windowWillClose:(NSNotification *)aNotification
{
	//We remove ourself as the delegate as
	//we are going to release ourselves
	[window setDelegate:nil];
	//Let garbage collection do the actual deletion
	[self autorelease];
}

@end
  • Under Classes, select AppDelegate.m.

Here's what the code looks like now:

#import "AppDelegate.h"

@implementation AppDelegate

- (void)new:(id)sender
{
}

@end

Edit the code so it looks like this:

#import "AppDelegate.h"

@implementation AppDelegate

- (void)new:(id)sender
{
}

@end

Change it to look like this:

#import "AppDelegate.h"
#import "Document.h"

@implementation AppDelegate

- (void)new:(id)sender
{
	//Just instantiate a Document. It will know what to do.
	[[Document alloc] init];
}

@end
  • Click on the hammer icon to bring up the project build window.
  • Click on the hammer again to build the project.
  • When prompted with the Save Modified Files dialog, click Save and build.
  • Assuming the build succeeds, click on the monitor icon to bring up the launch window.
  • Click on the monitor icon in the launch window to run the application.

When the application runs, select Document/New to create new windows.

Till Next Month...

Between delegates, File's Owner, and nib file loading, you've learned a lot this month. Be sure to spend some time looking at NSWindow and NSApplication to get a feel for the power of delegation. This will give you something to chew on until we have releases of Rhapsody and Rhapsody developer tools.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

EtreCheck Pro 6.0.2 - For troubleshootin...
EtreCheck is an app that displays the important details of your system configuration and allow you to copy that information to the Clipboard. It is meant to be used with Apple Support Communities to... Read more
BitTorrent 7.4.3 - Official client of th...
BitTorrent is a protocol for distributing files. It identifies content by URL and is designed to integrate seamlessly with the web. Its advantage over plain HTTP is that when multiple downloads of... Read more
Adobe Premiere Pro CC 2019 13.1.3 - Digi...
Premiere Pro CC 2019 is available as part of Adobe Creative Cloud for as little as $52.99/month. The price on display is a price for annual by-monthly plan for Adobe Premiere Pro only Adobe Premiere... Read more
ffWorks 1.3.1 - Convert multimedia files...
ffWorks, focused on simplicity, brings a fresh approach to the use of FFmpeg, allowing you to create ultra-high-quality movies without the need to write a single line of code on the command-line.... Read more
BetterTouchTool 3.134 - Customize multi-...
BetterTouchTool adds many new, fully customizable gestures to the Magic Mouse, Multi-Touch MacBook trackpad, and Magic Trackpad. These gestures are customizable: Magic Mouse: Pinch in / out (zoom)... Read more
TextMate 2.0.rc.28 - Code/markup editor...
TextMate is a versatile plain text editor with a unique and innovative feature set which caused it to win an Apple Design Award for Best Mac OS X Developer Tool in August 2006 A rapidly growing... Read more
BetterTouchTool 3.132 - Customize multi-...
BetterTouchTool adds many new, fully customizable gestures to the Magic Mouse, Multi-Touch MacBook trackpad, and Magic Trackpad. These gestures are customizable: Magic Mouse: Pinch in / out (zoom)... Read more
calibre 3.45.2 - Complete e-book library...
Calibre is a complete e-book library manager. Organize your collection, convert your books to multiple formats, and sync with all of your devices. Let Calibre be your multi-tasking digital librarian... Read more
calibre 3.45.2 - Complete e-book library...
Calibre is a complete e-book library manager. Organize your collection, convert your books to multiple formats, and sync with all of your devices. Let Calibre be your multi-tasking digital librarian... Read more
BetterTouchTool 3.132 - Customize multi-...
BetterTouchTool adds many new, fully customizable gestures to the Magic Mouse, Multi-Touch MacBook trackpad, and Magic Trackpad. These gestures are customizable: Magic Mouse: Pinch in / out (zoom)... Read more

Latest Forum Discussions

See All

TEPPEN guide - Tips and tricks for new p...
TEPPEN is a wild game that nobody asked for, but I’m sure glad it exists. Who would’ve thought that a CCG featuring Capcom characters could be so cool and weird? In case you’re not completely sure what TEPPEN is, make sure to check out our review... | Read more »
Dr. Mario World guide - Other games that...
We now live in a post-Dr. Mario World world, and I gotta say, things don’t feel too different. Nintendo continues to squirt out bad games on phones, causing all but the most stalwart fans of mobile games to question why they even bother... | Read more »
Strategy RPG Brown Dust introduces its b...
Epic turn-based RPG Brown Dust is set to turn 500 days old next week, and to celebrate, Neowiz has just unveiled its biggest and most exciting update yet, offering a host of new rewards, increased gacha rates, and a brand new feature that will... | Read more »
Dr. Mario World is yet another disappoin...
As soon as I booted up Dr. Mario World, I knew I wasn’t going to have fun with it. Nintendo’s record on phones thus far has been pretty spotty, with things trending downward as of late. [Read more] | Read more »
Retro Space Shooter P.3 is now available...
Shoot-em-ups tend to be a dime a dozen on the App Store, but every so often you come across one gem that aims to shake up the genre in a unique way. Developer Devjgame’s P.3 is the latest game seeking to do so this, working as a love letter to the... | Read more »
Void Tyrant guide - Guildins guide
I’ve still been putting a lot of time into Void Tyrant since it officially released last week, and it’s surprising how much stuff there is to uncover in such a simple-looking game. Just toray, I finished spending my Guildins on all available... | Read more »
Tactical RPG Brown Dust celebrates the s...
Neowiz is set to celebrate the summer by launching a 2-month long festival in its smash-hit RPG Brown Dust. The event kicks off today, and it’s divided into 4 parts, each of which will last two weeks. Brown Dust is all about collecting, upgrading,... | Read more »
Flappy Royale is an incredibly clever ta...
I spent the better part of my weekend playing Flappy Royale. I didn’t necessarily want to. I just felt like I had to. It’s a hypnotic experience that’s way too easy to just keep playing. | Read more »
Void Tyrant guide - General tips and tri...
Void Tyrant is a card-based dungeon-crawler that doesn’t fit in the mold of other games in the genre. Between the Blackjack-style combat and strange gear system alone, you’re left to your own devices to figure out how best to use everything to your... | Read more »
Webzen’s latest RPG First Hero is offici...
You might be busy sending your hulking Dark Knight into the midst of battle in Webzen’s other recent release: the long-anticipated MU Origin 2. But for something a little different, the South Korean publisher has launched First Hero. Released today... | Read more »

Price Scanner via MacPrices.net

Price drop! Clearance 12″ 1.2GHz Silver MacBo...
Amazon has dropped their price on the recently-discontinued 12″ 1.2GHz Silver MacBook to $849.99 shipped. That’s $450 off Apple’s original MSRP for this model, and it’s the cheapest price available... Read more
Apple’s 21″ 3.0GHz 4K iMac drops to only $936...
Abt Electronics has dropped their price on clearance, previous-generation 21″ 3.0GHz 4K iMacs to only $936 shipped. That’s $363 off Apple’s original MSRP, and it’s the cheapest price we’ve seen so... Read more
Amazon’s Prime Day savings on Apple 11″ iPad...
Amazon has new 2018 Apple 11″ iPad Pros in stock today and on sale for up to $250 off Apple’s MSRP as part of their Prime Day sale (but Prime membership is NOT required for these savings). These are... Read more
Prime Day Apple iPhone deal: $100 off all iPh...
Boost Mobile is offering Apple’s new 2018 iPhone Xr, iPhone Xs, and Xs Max for $100 off MSRP. Their discount reduces the cost of an Xs to $899 for the 64GB models and $999 for the 64GB Xs Max. Price... Read more
Clearance 13″ 2.3GHz Dual-Core MacBook Pros a...
Focus Camera has clearance 2017 13″ 2.3GHz/128GB non-Touch Bar Dual-Core MacBook Pros on sale for $169 off Apple’s original MSRP. Shipping is free. Focus charges sales tax for NY & NJ residents... Read more
Amazon Prime Day deal: 9.7″ Apple iPads for $...
Amazon is offering new 9.7″ WiFi iPads with Apple Pencil support for $80-$100 off MSRP as part of their Prime Day sale, starting at only $249. These are the same iPads found in Apple’s retail and... Read more
Amazon Prime Day deal: 10% (up to $20) off Ap...
Amazon is offering discounts on new 2019 Apple AirPods ranging up to $20 (10%) off MSRP as part of their Prime Day sales. Shipping is free: – AirPods with Charging Case: $144.99 $15 off MSRP –... Read more
Amazon Prime Day deal: $50-$80 off Apple Watc...
Amazon has Apple Watch Series 4 and Series 3 models on sale for $50-$80 off Apple’s MSRP as part of their Prime Day deals with prices starting at only $199. Choose Amazon as the seller rather than a... Read more
Amazon Prime Day deal: 50% discount on Apple...
Amazon has Apple Smart Keyboards for current-generation 10″ iPad Airs and previous-generation 10″ iPad Pros on sale today for $79.50 shipped as part of their early Prime Day deals. That’s a 50%... Read more
Abt drops prices on clearance 2018 MacBook Ai...
Abt Electronics has dropped prices on clearance 2018 13″ MacBook Airs by $201 with models now available starting at only $998. Shipping is free: – 13″ 1.6GHz/128GB MacBook Air (Space Gray, Silver, or... Read more

Jobs Board

*Apple* Graders/Inspectors (Seasonal/Hourly/...
…requirements. #COVAentryleveljobs ## Minimum Qualifications Some knowledge of agricultural and/or the apple industry is helpful as well as the ability to comprehend, Read more
Best Buy *Apple* Computing Master - Best Bu...
**710003BR** **Job Title:** Best Buy Apple Computing Master **Job Category:** Store Associates **Location Number:** 000171-Winchester Road-Store **Job Description:** Read more
Best Buy *Apple* Computing Master - Best Bu...
**709786BR** **Job Title:** Best Buy Apple Computing Master **Job Category:** Sales **Location Number:** 000430-Orange Park-Store **Job Description:** **What does a Read more
Geek Squad *Apple* Master Consultation Agen...
**709918BR** **Job Title:** Geek Squad Apple Master Consultation Agent **Job Category:** Services/Installation/Repair **Location Number:** 000106-Palmdale-Store Read more
*Apple* Systems Architect/Engineer, Vice Pre...
…its vision to be the world's most trusted financial group. **Summary:** Apple Systems Architect/Engineer with strong knowledge of products and services related to Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.