TweetFollow Us on Twitter

PP TextEdit
Volume Number:12
Issue Number:3
Column Tag:Getting Started

PowerPlant and TextEdit

By Dave Mark, MacTech Magazine Regular Contributing Author

Note: Source code files accompanying article are located on MacTech CD-ROM or source code disks.

Over the next few months, we’re going to implement a TextEdit application using PowerPlant. We’ll start off this month by implementing a classic TextEdit window with a single text style. Next month, we’ll add the code to save and open documents created with this application.

Planning Our Project

Let’s take a look at the steps we’ll need to take to implement a TextEdit window in a PowerPlant application. We’ll need to:

• Create a new project using the PowerPlant stationery.

• Replace the stationery Constructor file with a copy we saved in our project folder.

• Replace the stationery source code files in the project (both the main .cp file and its corresponding .h file) with copies of the files we save in our project folder.

• Use Constructor to create a TextEdit window view in our project resource file.

• Modify the source code to base the default window on the new view. This last change is only one line of code.

Before you read on, take some time to try this yourself. At this point, you should know enough about PowerPlant to implement the project yourself without step-by-step instructions (don’t worry, we’ll get to the step-by-step instructions in a minute, just in case). More than likely, if you need help, it will be with the fourth step, creating a TextEdit view in Constructor. Here’s a hint. First create an LWindow, then add an LScroller to the LWindow, then add an LTextEdit inside the LScroller. Go back and check out the PictScroller project (MacTech 11.12) if you need a refresher.

Before you continue, check to see which version of Constructor you have. You shoul;d be using Constructor 2.0.1 or later. CW7 shipped with Constructor 2.0, which has a bug which directly affects this project. Basically, Constructor 2.0 doesn’t always save ‘ppop’ resources correctly, and you can end up with some funky results. Fortunately, upgrading to Constructor 2.0.1 is painless. Get on the web and check out:

http://www.metrowerks.com/tools/software/updates/current

About halfway down the page, you’ll find and ftp URL for the Constructor 2.0.1 update. Donwload the updater and bring your Constructor back to the future.


Creating the PPEdit Project

OK, here are the step-by-step instructions I promised. We’ll start off by building our project and replacing the stationery files:

• Create a new folder called PPTextEdit.

• Launch CodeWarrior and create a new project named PPTextEdit.µ, using the PowerPlant stationery.

• In the project window, double-click on the file <PP Starter Resource>.rsrc. This will open the file in Constructor.

• In Constructor, do a Save As... and save the file in the PPTextEdit folder as PPTextEdit.rsrc.

As mentioned in last month’s column, this last step tells Constructor to completely duplicate the file, and not just the resources it uses. This is definitely the right way to replace the stationery resource file.

By the way, the new PowerPlant manual (you’ll find it on the CW8 CD) has a cool tip concerning PowerPlant resource files. When you create a new PowerPlant project, divide your resources into two groups. Put all the Constructor-related resources in one resource file (give it the creator code 'MWC2') and put all your other resources in a second resource file (give it the creator code 'RSED' if you use ResEdit or 'Doug' if you use Resorcerer). This way, when you double-click on your Constructor resource file, Constructor will be launched, and when you double-click on your regular resource file, your favorite resource editor will be launched.

• Quit Constructor and return to CodeWarrior.

• Add the file PPTextEdit.rsrc to the project.

• Delete the file <PP Starter Resource>.rsrc from the project.

• In the project window, double-click on the file <PP Starter Source>.cp.

• Select Save As... from the File menu and save the file as PPTextEdit.cp in the PPTextEdit folder.

• Scroll to the top of PPTextEdit.cp and find the line:

#include "<PP Starter Header>.h"

Select everything between the quotes (don’t select the quotes) and type AppleD (Open Selection from the File menu). This opens the stationery file <PP Starter Header>.h.

• Select Save As... from the File menu and save the header file as PPTextEdit.h in the PPTextEdit folder.

• Change the #include to read:

#include "PPTextEdit.h"

• Select Preferences... from the Edit menu and scroll to either the “68K Project” or “PPC Project” pane, depending on which machine you are developing for.

• In the “Application Info” area, change the File name to PPTextEdit and use the 'SIZE' flags popup to make the menu look like the one in Figure 1.

Figure 1. Be sure your SIZE flags are set like this in the CodeWarrior preferences (see the PPC Project or 68K Project pane).

This last step ensures that your application supports high level events. If your app supports high level events, PowerPlant sends an 'oapp' Apple event when the application starts up. This causes the function CPPStarterApp::StartUp() to get called which, in turn, issues a cmd_New command. Simply put, if your application’s 'SIZE' flags don’t indicate that your app is high level event-aware, a new window won’t appear at startup.

Creating the TextEdit View in Constructor

Our next step is to create the new TextEdit view in Constructor.

• In the CodeWarrior project window, double-click on the file PPTextEdit.rsrc to launch Constructor.

• In the main window, click on the default LWindow (ID 1) and press the Delete key to get rid of it. The main window should now be empty.

If you are using the version of Constructor that shipped with CW8 (2.1a1 or later), the main window looks a little different. Instead of a scrolling list of icons, each of which has an associated list of resources, the new Constructor (see Figure 2) features collapsing triangles, as well as a menu editor, so you can edit your menus without leaving Constructor. Very cool!

Figure 2. This month’s Constructor file, as seen in the version of Constructor that shipped on January’s CW8 CD.

• Select New Resource from the Edit menu to create a new LWindow view.

• Give the new view a resource ID of 1000 and a name of TextEdit.

In the old Constructor, you’ll need to click on the view in the main window and select Resource Info from the Edit menu (AppleI) to change the resource ID. In the new Constructor, you can enter the resource ID when you first create the view. Much better.

• In the main window, double-click on the new view to open the TextEdit view’s editing window.

• The view editing window will contain a single window. Double-click on the title bar of that window to bring up the TextEdit view’s pane info window.

• Change the pane info window to match the settings shown in Figure 3.

• Close the pane info window (leaving the view-editing window open).

PowerPlant terminology reminder: All things are panes. Some panes are also views. A view is a pane that can enclose other panes. So a window is a pane that happens to also be a view. A control is a pane and is never a view (you can’t embed a pane inside a control pane).

Figure 3. The resource info for the TextEdit LWindow view.

• Drag an LScroller from the palette onto the window in the view editing window.

• Double-click the LScroller to bring up its pane info window.

• Change the LScroller’s pane info window to match the settings shown in Figure 4.

Be sure to enter -1 in the horizontal scroll bar’s left indent field. This tells PowerPlant to leave out the scroll bar on the bottom of our TextEdit window.

Note that we assigned the LScroller a pane ID of 1001. Also, note that we entered a Scrolling View ID of 1002. This second ID tells Constructor and PowerPlant which pane we want controlled by this LScroller. We’ll create an LTextEdit pane next and give it an ID of 1002.

• Close the LScroller’s pane info window (leaving the view-editing window open).

Figure 4. The pane info for the LScroller. Note that the horizontal scroll bar was disabled.

• Drag an LTextEdit from the palette onto the LScroller in the view editing window.

• Double-click the LTextEdit to bring up its pane info window.

• Change the LTextEdit’s pane info window to match the settings shown in Figure 5.

Figure 5. The pane info for the LTextEdit pane. Note that the TextTraits ID is set to 1002. We’ll create a new Text Trait resource just for this LTextEdit.

Note that the LTextEdit has a pane ID of 1002. That’s to connect it to the LScroller. Note also that the Text Traits ID is set to 1002. In a moment, we’ll create a text trait resource (with an ID of 1002) that specifies the format of the text drawn in this LTextEdit pane.

• Close the LTextEdit’s pane info window (leaving the view editing window open).

• Close the view editing window for our LWindow, leaving the main window open.

• Select Show Hierarchy from the Display menu.

• When the hierarchy appears, be sure that it matches the hierarchy shown in Figure 6, with the LScroller embedded in the LWindow and the LTextEdit embedded in the LScroller.

Figure 6. The pane/view hierarchy, showing the LScroller embedded in the LWindow and the LTextEdit embedded in the LScroller.

• Close the hierarchy window.

• In the main window, click on the Text Traits icon (as opposed to the Views icon).

• Create a new text trait resource by selecting New Resource from the Edit menu.

• Change the text trait settings to match those shown in Figure 7.

Figure 7. The specifications for our text traits resource.

• Close the Text Traits window.

• In the main window, click on the new Text Trait you just created, then select Resource Info from the Edit menu.

• Change the resource ID of the new text traits resource to 1002.

• Close the resource info window.

If you are using the new Constructor, your method for creating a new text trait resource will be slightly different. In the main window, click on the main Text Traits heading, then select New Text Traits Resource from the Edit menu. When the new resource appears in the list, double-click on it to open the trait editing window, or click on it and select Resource Info from the Edit menu to edit the resource info.

• Save your changes, then quit Constructor.

One Slight Source Code Change

One slight source code change, then we’re done. All we have to do is change the constant that tells the application which view to open on startup. The PowerPlant stationery sets things up so the 'ppob' resource with an ID of 1 is used as the basis for the application’s default window. All we need to do is change the 1 to 1000, so our LWindow 1000 will get used instead.

• Back in CodeWarrior, open up the source code file PPTextEdit.cp.

• Towards the top of the file, you’ll find the line:

const ResIDTwindow_Sample = 1;// EXAMPLE

• Change the 1 to a 1000, so the line reads:

const ResIDTwindow_Sample = 1000;  // EXAMPLE

Running the Application

That’s it! Your application is now ready to rock and roll.

• Select Run from the Project menu.

After your source code is compiled and the project is linked, your new TextEdit application will run and a new TextEdit window will appear. Click in the window, then type in a bunch of text. Notice that the text appears in red, 9-point Geneva. As is, PowerPlant does not yet support styled TextEdit, though there are some third-party classes available that do. I’m guessing that we’ll see styled TextEdit built in to PowerPlant before too long.

Try creating multiple windows (select New from the File menu) and copy and paste between the windows. This is cool. You get a lot for free with PowerPlant.

Till Next Month...

One thing you’ll notice is that our application has no way of saving the text to disk or loading the contents of a file into a window. Guess what we’ll be doing next month. Till then, get hold of the PowerPlant manual (a great job of writing by Jim Trudeau, by the way), and start reading about the LDocument class.

 
AAPL
$102.50
Apple Inc.
+0.25
MSFT
$45.43
Microsoft Corpora
+0.55
GOOG
$571.60
Google Inc.
+2.40

MacTech Search:
Community Search:

Software Updates via MacUpdate

Skype 6.19.0.450 - Voice-over-internet p...
Skype allows you to talk to friends, family and co-workers across the Internet without the inconvenience of long distance telephone charges. Using peer-to-peer data transmission technology, Skype... Read more
VueScan 9.4.41 - Scanner software with a...
VueScan is a scanning program that works with most high-quality flatbed and film scanners to produce scans that have excellent color fidelity and color balance. VueScan is easy to use, and has... Read more
Cloud 3.0.0 - File sharing from your men...
Cloud is simple file sharing for the Mac. Drag a file from your Mac to the CloudApp icon in the menubar and we take care of the rest. A link to the file will automatically be copied to your clipboard... Read more
LibreOffice 4.3.1.2 - Free Open Source o...
LibreOffice is an office suite (word processor, spreadsheet, presentations, drawing tool) compatible with other major office suites. The Document Foundation is coordinating development and... Read more
SlingPlayer Plugin 3.3.20.505 - Browser...
SlingPlayer is the screen interface software that works hand-in-hand with the hardware inside the Slingbox to make your TV viewing experience just like that at home. It features an array of... Read more
Get Lyrical 3.8 - Auto-magically adds ly...
Get Lyrical auto-magically add lyrics to songs in iTunes. You can choose either a selection of tracks, or the current track. Or turn on "Active Tagging" to get lyrics for songs as you play them.... Read more
Viber 4.2.2 - Send messages and make cal...
Viber lets you send free messages and make free calls to other Viber users, on any device and network, in any country! Viber syncs your contacts, messages and call history with your mobile device,... Read more
Cocktail 7.6 - General maintenance and o...
Cocktail is a general purpose utility for OS X that lets you clean, repair and optimize your Mac. It is a powerful digital toolset that helps hundreds of thousands of Mac users around the world get... Read more
LaunchBar 6.1 - Powerful file/URL/email...
LaunchBar is an award-winning productivity utility that offers an amazingly intuitive and efficient way to search and access any kind of information stored on your computer or on the Web. It provides... Read more
Maya 2015 - Professional 3D modeling and...
Maya is an award-winning software and powerful, integrated 3D modeling, animation, visual effects, and rendering solution. Because Maya is based on an open architecture, all your work can be scripted... Read more

Latest Forum Discussions

See All

Rhonna Designs Magic (Photography)
Rhonna Designs Magic 1.0 Device: iOS Universal Category: Photography Price: $1.99, Version: 1.0 (iTunes) Description: Want to sprinkle *magic* on your photos? With RD Magic, you can add colors, filters, light leaks, bokeh, edges,... | Read more »
This Week at 148Apps: August 25-29, 2014
Shiny Happy App Reviews   | Read more »
Qube Kingdom – Tips, Tricks, Strategies,...
Qube Kingdom is a tower defense game from DeNA. You rally your troops – magicians, archers, knights, barbarians, and others – and fight against an evil menace looking to dominate your kingdom of tiny squares. Planning a war isn’t easy, so here are a... | Read more »
Qube Kingdom Review
Qube Kingdom Review By Nadia Oxford on August 29th, 2014 Our Rating: :: KIND OF A SQUARE KINGDOMUniversal App - Designed for iPhone and iPad Qube Kingdom has cute visuals, but it’s a pretty basic tower defense game at heart.   | Read more »
Fire in the Hole Review
Fire in the Hole Review By Rob Thomas on August 29th, 2014 Our Rating: :: WALK THE PLANKUniversal App - Designed for iPhone and iPad Seafoam’s Fire in the Hole looks like a bright, 8-bit throwback, but there’s not enough booty to... | Read more »
Alien Creeps TD is Now Available Worldwi...
Alien Creeps TD is Now Available Worldwide Posted by Ellis Spice on August 29th, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
Dodo Master Review
Dodo Master Review By Jordan Minor on August 29th, 2014 Our Rating: :: NEST EGGiPad Only App - Designed for the iPad Dodo Master is tough but fair, and that’s what makes it a joy to play.   | Read more »
Motorsport Manager Review
Motorsport Manager Review By Lee Hamlet on August 29th, 2014 Our Rating: :: MARVELOUS MANAGEMENTUniversal App - Designed for iPhone and iPad Despite its depth and sense of tactical freedom, Motorsport Manager is one of the most... | Read more »
Motorsport Manager – Beginner Tips, Tric...
The world of Motorsport management can be an unforgiving and merciless one, so to help with some of the stress that comes with running a successful race team, here are a few hints and tips to leave your opponents in the dust. | Read more »
CalPal Update Brings the App to 2.0, Add...
CalPal Update Brings the App to 2.0, Adds Lots of New Stuff Posted by Ellis Spice on August 29th, 2014 [ permalink ] | Read more »

Price Scanner via MacPrices.net

Save up to $300 on an iMac with Apple refurbi...
The Apple Store has Apple Certified Refurbished iMacs available for up to $300 off the cost of new models. Apple’s one-year warranty is standard, and shipping is free. These are the best prices on... Read more
The Rise of Phablets
Carlisle & Gallagher Consulting Group, a businesses and technology consulting firm focused solely on the financial services industry, has released an infographic depicting the convergence of... Read more
Eddy – Cloud Music Player for iPhone/iPad Fre...
Ukraine based CapableBits announces the release of Eddy, its tiny, but smart and powerful cloud music player for iPhone and iPad that allows users to stream or download music directly from cloud... Read more
A&D Medical Launches Its WellnessConnecte...
For consumers and the healthcare providers and loved ones who care for them, A&D Medical, a leader in connected health and biometric measurement devices and services, has launched its... Read more
Anand Lal Shimpi Retires From AnandTech
Anand Lal Shimpi, whose AnandTech Website is famous for its meticulously detailed and thoroughgoing reviews and analysis, is packing it in. Lal Shimpi, who founded the tech site at age 14 in 1997,... Read more
2.5GHz Mac mini, Apple refurbished, in stock...
The Apple Store has Apple Certified Refurbished 2.5GHz Mac minis available for $509, $90 off MSRP. Apple’s one-year warranty is included, and shipping is free. Read more
13-inch 2.5GHz MacBook Pro on sale for $999,...
B&H Photo has the 13″ 2.5GHz MacBook Pro on sale for $999.99 including free shipping plus NY sales tax only. Their price is $100 off MSRP. Read more
Labor Day Weekend MacBook Pro sale; 15-inch m...
B&H Photo has the new 2014 15″ Retina MacBook Pros on sale for up to $125 off MSRP. Shipping is free, and B&H charges NY sales tax only. They’ll also include free copies of Parallels Desktop... Read more
Labor Day Weekend iPad mini sale; $50 to $100...
Best Buy has the iPad mini with Retina Display (WiFi models) on sale for $50 off MSRP on their online store for Labor Day Weekend. Choose free shipping or free local store pick up. Price is for... Read more
13-inch 1.4GHz MacBook Air on sale for $899,...
Adorama has the new 2014 13″ 1.4GHz/128GB MacBook Air on sale for $899.99 including free shipping plus NY & NJ tax only. Their price is $100 off MSRP. Read more

Jobs Board

*Apple* Retail - Multiple Positions (US) - A...
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
*Apple* Retail - Multiple Positions (US) - A...
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
*Apple* Retail - Multiple Positions (US) - A...
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
*Apple* Retail - Multiple Positions (US) - A...
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
Senior Event Manager, *Apple* Retail Market...
…This senior level position is responsible for leading and imagining the Apple Retail Team's global event strategy. Delivering an overarching brand story; in-store, Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.