TweetFollow Us on Twitter

Rhapsody SimpleText

Volume Number: 13 (1997)
Issue Number: 11
Column Tag: Rhapsody

A Simple Word Processor...on Rhapsody

by Andrew Stone, Chief Executive Haquer, Stone Design Corp

Here is a Simple Rich Text and Graphics Word Processor you can build yourself in 20 minutes on Rhapsody

Leveraging the power of Rhapsody is your key to building cool apps quickly. If I asked you "How many lines of code would you have to write to implement a word procesor that reads/writes rich text files (including full support for graphics of EPS, TIFF, JPEG, PICT, GIF, etc type), full font support, full rulers with tabs and hanging indents, full support for color, printing, faxing and saving as PS with embedded fonts".

But wait, before you answer, that's not all (can you hear the Ginzu knife salesman yet?)... "What if it also had ligatures, kerning, superscripting, justification, underlining, ability to drag out graphics, copy and paste of contents and copy and paste of font styles? Don't answer yet, because it will also run on Windows95 and Windows NT, and has a built-in spell checker."

If I said 13 lines of code and that you'll be done in 20 minutes, would you believe it? This is why I quit developing on the Mac in 1989 when I saw my first NeXT demo, and why I'm happy as heck to be developing on a Mac in 1997!

First look at Rhapsody

The week before Macworld Boston 97, the Rhapsody Group at Apple invited several key OpenStep developers out to Cupertino to port their wares to Rhapsody running on the PowerPC. It was a great privilege to be included in this 3 day Kitchen - a MacHack with the Apple engineers dropping in and helping us at all hours. And, as promised, create, compile, and it "just worked".

This article will take you step-by-step through the process of creating a new application, building the user interface, generating the skeleton class code, filling in the 13 lines required, compiling and testing your word processor. If you encounter terms you don't recognize, please refer to the online documentation for developers, especially /NextLibrary/Documentation/NextDev/TasksAndConcepts/DevEnvGuide/DevGuide.rtfd.

Note that this article was written before the Developer release, so be aware that the screenshots may be a bit out-of-date! Note also that the purpose is to show how easy it is to get going, not good application architecture!

How to Build It

Step 0: Install the Rhapsody Developer release on your Power Mac, if you haven't done so already. Refer to Apple's instructions on how to do this.

1. Launch ProjectBuilder.app (aka "PB").

It's in /NextDeveloper/Apps, just double-click it.

2. Click Project - New...

An OpenPanel will come up - select "Application" for project type in the pop-up menu, type in "sWord" and "OK".

This will create a new directory named "sWord" with various project files:

PB.project: the file which maintains your makefiles.
Makefile, Makefile.preamble, Makefile.postamble: the makefiles.
sWord_main.m: the source file which defines main().
English.lproj: the directory with localized interface files (NIBs)
sWord.iconheader: the file which keeps track of App and Doc icons.

All of these files are created and maintained by ProjectBuilder - you don't have to write a single line of code to get your app skeleton.

3. In the sWord ProjectBuilder window, click "Interfaces", and then double-click "sWord.nib" to automatically launch InterfaceBuilder - where you will design your interface, create new classes, and test your application.

Note also the sWord-windows.nib file, which is for deploying your application on WindowNT and Window95, with no changes to your code! Since Windows organizes its menus differently, this NIB file will be different, according to Windows human interface (or lack thereof) design.

4. In InterfaceBuilder's Palette window, click the "Text" icon to load "DataViews", the palette containing Text in a ScrollView. Drag the ScrollView onto your main window, "My Window".

5. Move the ScrollView to the upper left hand corner of your window, and drag its bottom right knob to resize the ScrollView to fill your window.

6. We will now add the ability for the Text to be able to accept drag and drop graphics, as well as display and save them. Bring up InterfaceBuilder's Inspector Panel with Tools - Inspector. Be sure that the ScrollView is selected. All you have to do is click the "Graphics Allowed" switch!

7. InterfaceBuilder allows you to specify how objects behave when the window they are in is resized. For our ScrollView with our Text object to automatically fill the window, we must set its "autosizing". IB allows to visually set these constraints. This eliminates us having to write code to deal with window size changes.

Choose "Size" from the pop-up menu at the top of the inspector. The Size inspector allows you to specify how objects behave when a user resizes the window. Lines mean "stays fixed", springs means "size to fit". click the middle vertical and horizontal lines to allow the ScrollView to expand and contract with the window:

8. It's time to add power to our app, which we will get for free by adding various menus to our app. By default, IB gives your app some lightweight menus without the depth of functionality that is possible. For example, the stock "Edit" menu just has copy,cut,delete and paste. However, if you drag off an "Edit" menu from the IB palette, it will contain the full range of menu items and associated functionality, including the SpellChecker and a Find Menu.

First, delete some of the stock ones provided by clicking the menu item, and choosing Edit - Cut. (This may change for Rhapsody Developer Release.) Your menu should look something like this now:

9. In IB's Palette window, click the Menu icon to load the Menus. Drag over the following menus from the Palette to the sWord Menu window:

Apple
	Document (rename this to "File")
	Edit (replace the other one - this one has a Spell Checker in it!)
	Font
	Text

Click the File menu to drop it down. From the IB Palette window, click and drag from the "Item" button to the sWord File menu. Rename the new menu item to "Page Setup...". Drag over another menu item, and rename this one to "Print...". These items may be there automatically in the Rhapsody Developer Release.

10. Now we are going to design a simple object, add its outlets (technically speaking, "instance variables") and actions (Objective C methods), and have InterfaceBuilder automatically create the source files for this new class. All you will have to do is add the few lines of code reproduced below to make these custom actions do something useful.

Click the "Classes" tab in the window with the "Instances" of objects in your interface, and an outline of the class hierarchy will be displayed.

Click "NSObject". Select "Classes - Subclass" from the menu bar.

Rename "MyNSObject" to "WordDelegate".

11. We will now add an instance of this new class, WordDelegate to our app. Choose "Classes- Instantiate".

Click the "Instances" tab to reveal what we've added:

12. Now, return to the "Classes" tab to add the actions (the objC method called when you click a menu item or button) and outlets (the instances of objects that your WordDelegate knows about) to the WordDelegate Class.

13. Click the "outlet plug" icon to the right of the WordDelegate, and click "Outlets" when it appears. Hit the RETURN key to create a new outlet, "myOutlet". Double-click to select the text and rename this outlet to "theText". This outlet will become an instance variable in our new WordDelegate class, so we can refer to the NSTextView object programmatically and send messages to it, but we'll "hook it up" in InterfaceBuilder. "Hooking Up" is the visual programming equivalent of assigning both an action and a target for menu items, buttons, controls, etc.

14. Connect the WordDelegate's outlet "theText" to the NSTextView which is inside of the ScrollView by control-dragging from the WordDelegate instance. Double-click "theText" in the Inspector's Outlets Browser.

15. Now, we'll add the functionality to our WordDelegate by adding the actions to which it can respond.

a. Click the small cross icon on the right to drop down the "Actions".

b.Select Actions, and type RETURN to add a new action.

c. Rename it "newText:".

d. Again, type RETURN and rename the new action to "openText:".

e. Again, for "saveText:".

16. Now, we'll connect our menu items to the object which performs the action and select the action to be performed.

Click the File menu to drop it down. Hold down the Control-Key, and click-drag from the Open... menu to the instance of WordDelegate, and release the mouse. Black lines will connect them up. Select "openText:" in the Actions browser, and click "Connect" in the NSMenuItem Inspector (double-click openText: to avoid this second step).

Repeat this for "Save" and "New", but double-click the actions "saveText:" and "newText:" respectively.

17. In the same control-drag manner, connect the Page Setup... to "First Responder" object in the Instance Browser. This is a very cool "placeholder" object which will send the method to the most appropriate object for the current context of the application. In Rhapsody, there is this notion of a responder chain which begins with the active user interface object (such as the Text if your cursor is blinking there), the window's delegate, the window, then the Application's delegate, and finally, the Application itself. The action is sent to the first object in the chain that responds to it (ie First Responder), and if none do, the menu item is automatically dimmed and disabled. For a full description of the Responder chain, you can access the online documentation via ProjectBuilder: click "Frameworks" - "AppKit.framework" - "Documentation" - "Reference" - "Classes" - "NSResponder.rtf". You will quickly learn how useful these docs are!

For our WordDelegate object to get these First Responder method calls, we'll must insert our WordDelegate into the First Responder chain.

Control-Drag from the "My window" icon in the Instance Browser to the "WordDelegate" instance, and select "delegate" outlet in the Outlets browser of the Window Inspector.

18. Control drag from "Page Setup..." menu item in the dropped down File menu to the First Responder icon in the Instances browser. Double-click "runPageLayout:" in the Inspector's Actions browser.

Likewise, Control-drag from "Print..." menu item to the Text portion of the ScrollView. Double-click "print:" in the Actions browser.

19. Now, let's test drive our app within InterfaceBuilder by choosing "Document- Test Interface". This then "runs" our application in an interpreted environment, so you can try out typing text, changing fonts, bringing up the ruler, dragging in graphics and so on. You won't be able to save or open yet, because we need to write that code, compile it, and run the compiled version to see additional functionality over what is already part of the runtime system.

20. We've designed an object, hooked it up, now let's ask IB to make the skeletal source files. Click the "Classes" tab and select the WordDelegate Class. Choose "Classes- Create Files..." from the menu bar.

After verifying that creating classes is what you want to do, InterfaceBuilder will then ask you if you want insert these new files into your sWord project.

Click "OK", and then ProjectBuilder will come up showing you the new source files.

21. Click "WordDelegate.m" under the Classes category in ProjectBuilder. The skeletal source file will be displayed, now it's time to write those 13 lines of code, and you'll see the beauty and elegance of Rhapsody!

22. Type in this code, I added the comments for your edification, so they don't count in the number of lines of code!

 ***** WordDelegte.m *****

#import "WordDelegate.h"
@implementation WordDelegate
- (void)newText:(id)sender
{
// empty out the text with the empty NSString:
    [theText setString:@""];

// Set the window's title to be untitled:
    [[theText window]setTitle:@"Untitled"];
// bring the window up in case the user has closed it:
    [[theText window] makeKeyAndOrderFront:self];
}

- (void)openText:(id)sender
{
// Get a new Open Panel
    NSOpenPanel *openPanel = [NSOpenPanel openPanel];

// Have it run modal and look for files of "rtf" or "rtfd" type:
    if ([openPanel runModalForTypes:[NSArray arrayWithObjects:@"rtf",@"rtfd",NULL]]) {
// we have a valid file, ask theText to read it in
        [theText readRTFDFromFile:[openPanel filename]];
// Update the window's name with the filename, but in a readable way:
        [[theText window]setTitleWithRepresentedFilename:[openPanel filename]];
// bring the window up in case the user has closed it:
        [[theText window] makeKeyAndOrderFront:self];
    }
}

- (void)saveText:(id)sender
{
// Get a new Save Panel:
    NSSavePanel *savePanel = [NSSavePanel savePanel];

// Set it to save "rtfd" files:
    [savePanel setRequiredFileType:@"rtfd"];

// Run modal, which returns YES if a valid path is chosen:
    if ([savePanel runModal]) {

// Ask the text to write itself to the chosen filename
// But don't make it back up before
// Set atomically:YES if you want "save backups", slower but more secure
        [theText writeRTFDToFile:[savePanel filename] atomically:NO];

// Update the title bar of the window
        [[theText window]setTitleWithRepresentedFilename:[savePanel filename]];
   }
}


@end
*************************

23. Click PB's Build icon, which brings up the "sWord - Project Build" panel. Click the Hammer icon again, and your app will get compiled. You can run it from within PB, or simply double-click the sWord.app in your sWord directory.

24. To build an installed version, click the "Options" panel button, and choose "Install" for the make target, then select the architectures you wish your app to run on. Build again. This will install the sWord.app into your ~/Apps directory, after "stripping" it to its smallest possible size.

25. Launch sWord.app and try it out!

Epilogue

That was easy, eh? Here are some things you can do to enhance your word processor:

  1. Rename "My Window" to "Untitled" so that the title starts in the right state. This is trivial to do in IB's Inspector, "Attributes" when the window is selected in the Instance browser.
  2. Add multiple documents to your app by creating a separate nib file which is owned by the WordDelegate class. See /NextDeveloper/Examples/AppKit/TextEdit for a very powerful, yet simple TextEditor which allows multiple docs (Document.h & Document.m).
  3. Add an Application Icon by creating a 48*48 icon (/NextDeveloper/Apps/IconBuilder.app), saving it, and then dragging it from the FileViewer to the "Project" icon well in ProjectBuilder's inspector, and recompiling.
  4. Add Find - TextFinder.h, TextFinder.m and FindPanel.nib and FindPanel.strings from TextEdit contain the functionality you need. This is much vaunted "code reuse" of object programming!
  5. Create methods for SaveAs... Again, look at the document architecture in the /NextDeveloper/Examples/Appkit folder.
  6. Add an "About..." panel. Drag in a panel from the IB palette and connect the "About..." menu item to this panel, with an action of "orderFront:".
  7. Add Tool Tips. Simply create an rtf file for each object that you want give popup help to, and attach to the user interface object in IB, Inspector- Help.
  8. Make the OpenPanel and SavePanel remember their last opened directory by making those variables static, and "retaining" them.
 - (void)saveText:(id)sender
{
// Create a static variable lives between invocations:
    static NSSavePanel *savePanel = nil;
// If it's the first time through, get a new Save Panel:
    if (savePanel == nil) {
   	 NSSavePanel *savePanel = [[NSSavePanel savePanel] retain];
    }
// Now, it will 'remember' it's last chosen directory...

Anyway, I hope this gives you a taste for the elegance and comfort of finely integrated Rhapsody development tools.


Andrew Stone, an early HyperTalk developer and coauthor of "Tricks of the HyperTalk Masters" emigrated to the NeXT community in 1989, going on to write such NeXT classics as TextArt, Create, DataPhile and 3Dreality.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Duet 1.6.7.0 - Use your iPad as an exter...
Duet is the first app that allows you to use your iDevice as an extra display for your Mac using the Lightning or 30-pin cable. Note: This app requires a $14.99 iOS companion app. Version 1.6.7.0:... Read more
iExplorer 4.1.5 - View and transfer file...
iExplorer is an iPhone browser for Mac lets you view the files on your iOS device. By using a drag and drop interface, you can quickly copy files and folders between your Mac and your iPhone or... Read more
Alarm Clock Pro 10.3 - $19.95
Alarm Clock Pro isn't just an ordinary alarm clock. Use it to wake you up in the morning, send and compose e-mails, remind you of appointments, randomize the iTunes selection, control an internet... Read more
Tor Browser Bundle 7.0.7 - Anonymize Web...
The Tor Browser Bundle is an easy-to-use portable package of Tor, Vidalia, Torbutton, and a Firefox fork preconfigured to work together out of the box. It contains a modified copy of Firefox that... Read more
Data Rescue 5.0.1 - Powerful hard drive...
Data Rescue’s new and improved features let you scan, search, and recover your files faster than ever before. We have modernized the file-preview capabilities, added new files types to the recovery... Read more
Alfred 3.5.1 - Quick launcher for apps a...
Alfred is an award-winning productivity application for OS X. Alfred saves you time when you search for files online or on your Mac. Be more productive with hotkeys, keywords, and file actions at... Read more
Tunnelblick 3.7.3 - GUI for OpenVPN.
Tunnelblick is a free, open source graphic user interface for OpenVPN on OS X. It provides easy control of OpenVPN client and/or server connections. It comes as a ready-to-use application with all... Read more
DEVONthink Pro 2.9.16 - Knowledge base,...
Save 10% with our exclusive coupon code: MACUPDATE10 DEVONthink Pro is your essential assistant for today's world, where almost everything is digital. From shopping receipts to important research... Read more
AirRadar 4.0 - $9.95
With AirRadar, scanning for wireless networks is now easier and more personalized! It allows you to scan for open networks and tag them as favourites or filter them out. View detailed network... Read more
ForkLift 3.0.8 Beta - Powerful file mana...
ForkLift is a powerful file manager and ferociously fast FTP client clothed in a clean and versatile UI that offers the combination of absolute simplicity and raw power expected from a well-executed... Read more

Wheels of Aurelia (Games)
Wheels of Aurelia 1.0.1 Device: iOS Universal Category: Games Price: $3.99, Version: 1.0.1 (iTunes) Description: | Read more »
Halcyon 6: Starbase Commander guide - ti...
Halcyon 6 is a well-loved indie RPG with stellar tactical combat and some pretty good writing, too. It's now landed on the App Store, so mobile fans, if you're itching for a good intergalactic adventure, here's your game. Being a strategy RPG, the... | Read more »
Game of Thrones: Conquest guide - how to...
Fans of base building games might be excited to know that yet another entry in the genre has materialized - Game of Thrones: Conquest. Yes, you can now join the many kingdoms of the famed book series, or create your own, as you try to conquer... | Read more »
Halcyon 6: Starbase Commander (Games)
Halcyon 6: Starbase Commander 1.4.2.0 Device: iOS Universal Category: Games Price: $6.99, Version: 1.4.2.0 (iTunes) Description: An epic space strategy RPG with base building, deep tactical combat, crew management, alien diplomacy,... | Read more »
Legacy of Discord celebrates its 1 year...
It’s been a thrilling first year for fans of Legacy of Discord, the stunning PvP dungeon-crawling ARPG from YOOZOO Games, and now it’s time to celebrate the game’s first anniversary. The developers are amping up the festivities with some exciting... | Read more »
3 reasons to play Thunder Armada - the n...
The bygone days of the Battleship board game might have past, but naval combat simulators still find an audience on mobile. Thunder Armada is Chinese developer Chyogames latest entry into the genre, drawing inspiration from the explosive exchanges... | Read more »
Experience a full 3D fantasy MMORPG, as...
Those hoping to sink their teeth into a meaty hack and slash RPG that encourages you to fight with others might want to check out EZFun’s new Eternity Guardians. Available to download for iOS and Android, Eternity Guardians is an MMORPG that lets... | Read more »
Warhammer Quest 2 (Games)
Warhammer Quest 2 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: Dungeon adventures in the Warhammer World are back! | Read more »
4 of the best Halloween updates for mobi...
Halloween is certainly one of our favorite times for mobile game updates. Many popular titles celebrate this spooky season with fun festivities that can stretch from one week to even the whole month. As we draw closer and closer to Halloween, we'... | Read more »
Fire Rides guide - how to swing to succe...
It's another day, which means another Voodoo game has come to glue our hands to our mobile phones. Yes, it's been an especially prolific month for this particular mobile publisher, but we're certainly not complaining. Fire Rides is yet another... | Read more »

Price Scanner via MacPrices.net

Apple restocks full line of refurbished 13″ M...
Apple has restocked a full line of Apple Certified Refurbished 2017 13″ MacBook Pros for $200-$300 off MSRP. A standard Apple one-year warranty is included with each MacBook, and shipping is free.... Read more
13″ 3.1GHz/256GB MacBook Pro on sale for $167...
Amazon has the 2017 13″ 3.1GHz/256GB Space Gray MacBook Pro on sale today for $121 off MSRP including free shipping: – 13″ 3.1GHz/256GB Space Gray MacBook Pro (MPXV2LL/A): $1678 $121 off MSRP Keep an... Read more
13″ MacBook Pros on sale for up to $120 off M...
B&H Photo has 2017 13″ MacBook Pros in stock today and on sale for up to $120 off MSRP, each including free shipping plus NY & NJ sales tax only: – 13-inch 2.3GHz/128GB Space Gray MacBook... Read more
15″ MacBook Pros on sale for up to $200 off M...
B&H Photo has 15″ MacBook Pros on sale for up to $200 off MSRP. Shipping is free, and B&H charges sales tax in NY & NJ only: – 15″ 2.8GHz MacBook Pro Space Gray (MPTR2LL/A): $2249, $150... Read more
Roundup of Apple Certified Refurbished iMacs,...
Apple has a full line of Certified Refurbished 2017 21″ and 27″ iMacs available starting at $1019 and ranging up to $350 off original MSRP. Apple’s one-year warranty is standard, and shipping is free... Read more
Sale! 27″ 3.8GHz 5K iMac for $2098, save $201...
Amazon has the 27″ 3.8GHz 5K iMac (MNED2LL/A) on sale today for $2098 including free shipping. Their price is $201 off MSRP, and it’s the lowest price available for this model (Apple’s $1949... Read more
Sale! 10″ Apple WiFi iPad Pros for up to $100...
B&H Photo has 10.5″ WiFi iPad Pros in stock today and on sale for $50-$100 off MSRP. Each iPad includes free shipping, and B&H charges sales tax in NY & NJ only: – 10.5″ 64GB iPad Pro: $... Read more
Apple iMacs on sale for up to $130 off MSRP w...
B&H Photo has 21-inch and 27-inch iMacs in stock and on sale for up to $130 off MSRP including free shipping. B&H charges sales tax in NY & NJ only: – 27″ 3.8GHz iMac (MNED2LL/A): $2179 $... Read more
2017 3.5GHz 6-Core Mac Pro on sale for $2799,...
B&H Photo has the 2017 3.5GHz 6-Core Mac Pro (MD878LL/A) on sale today for $2799 including free shipping plus NY & NJ sales tax only . Their price is $200 off MSRP. Read more
12″ 1.2GHz Space Gray MacBook on sale for $11...
Amazon has the 2017 12″ 1.2GHz Space Gray Retina MacBook on sale for $100 off MSRP. Shipping is free: 12″ 1.2GHz Space Gray MacBook: $1199.99 $100 off MSRP Read more

Jobs Board

Product Manager - *Apple* Pay on the *Appl...
Job Summary Apple is looking for a talented product manager to drive the expansion of Apple Pay on the Apple Online Store. This position includes a unique Read more
*Apple* Retail - Multiple Positions - Farmin...
Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, you're also the Read more
Frameworks Engineer, *Apple* Watch - Apple...
Job Summary Join the team that is shaping the future of software development for Apple Watch! As a software engineer on the Apple Watch Frameworks team you will Read more
*Apple* News Product Marketing Mgr., Publish...
Job Summary The Apple News Product Marketing Manager will work closely with a cross-functional group to assist in defining and marketing new features and services. Read more
Fraud Analyst, *Apple* Advertising Platform...
Job Summary Apple Ad Platforms has an opportunity to redefine advertising on mobile devices. Apple reaches hundreds of millions of iPhone, iPod touch, and iPad Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.