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.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Kodi 15.0.beta1 - Powerful media center...
Kodi (was XBMC) is an award-winning free and open-source (GPL) software media player and entertainment hub that can be installed on Linux, OS X, Windows, iOS, and Android, featuring a 10-foot user... Read more
DiskCatalogMaker 6.4.12 - Catalog your d...
DiskCatalogMaker is a simple disk management tool which catalogs disks. Simple, light-weight, and fast. Finder-like intuitive look and feel. Super-fast search algorithm. Can compress catalog data... Read more
Macs Fan Control 1.3.0.0 - Monitor and c...
Macs Fan Control allows you to monitor and control almost any aspect of your computer's fans, with support for controlling fan speed, temperature sensors pane, menu-bar icon, and autostart with... Read more
Lyn 1.5.11 - Lightweight image browser a...
Lyn is a lightweight and fast image browser and viewer designed for photographers, graphic artists and Web designers. Featuring an extremely versatile and aesthetically pleasing interface, it... Read more
NeoOffice 2014.11 - Mac-tailored, OpenOf...
NeoOffice is a complete office suite for OS X. With NeoOffice, users can view, edit, and save OpenOffice documents, PDF files, and most Microsoft Word, Excel, and PowerPoint documents. NeoOffice 3.x... Read more
LaunchBar 6.4 - 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
Remotix 3.1.4 - Access all your computer...
Remotix is a fast and powerful application to easily access multiple Macs (and PCs) from your own Mac. Features Complete Apple Screen Sharing support - including Mac OS X login, clipboard... Read more
DesktopLyrics 2.6.6 - Displays current i...
DesktopLyrics is an application that displays the lyrics of the song currently playing in "iTunes" right on your desktop. The lyrics for the song have to be set in iTunes; DesktopLyrics does nothing... Read more
VOX 2.5.1 - Music player that supports m...
VOX is a beautiful music player that supports many filetypes. The beauty is in its simplicity, yet behind the minimal exterior lies a powerful music player with a ton of features and support for all... Read more
Microsoft Remote Desktop 8.0.18 - Connec...
With Microsoft Remote Desktop, you can connect to a remote PC and your work resources from almost anywhere. Experience the power of Windows with RemoteFX in a Remote Desktop client designed to help... Read more

Biz Builder Delux (Games)
Biz Builder Delux 1.0.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0.0 (iTunes) Description: Ah, there's nothing like the rhythmic bustle of a burgeoning business burg... especially when you're the one building it... | Read more »
Auroch Digital is Bringing Back Games Wo...
| Read more »
Carbo - Handwriting in the Digital Age...
Carbo - Handwriting in the Digital Age 1.0 Device: iOS Universal Category: Productivity Price: $3.99, Version: 1.0 (iTunes) Description: | Read more »
Draggy Dead (Games)
Draggy Dead 1.1 Device: iOS Universal Category: Games Price: $.99, Version: 1.1 (iTunes) Description: Ditch your dead end job and take up a rewarding career in Grave Robbing today!Guide the recently deceased to a fun filled life of... | Read more »
Bad Dinos (Games)
Bad Dinos 1.0.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0.0 (iTunes) Description: | Read more »
The Apple Watch isn't Great as a Fi...
| Read more »
Show the World What You See With Stre.am...
Live broadcasting is getting popular on mobile devices, which is why you can now get Stre.am, by Infinite Takes. [Read more] | Read more »
PhotoTime's 2.1 Update Adds Apple W...
The latest PhotoTime update is adding even more functionality to the handy photo organizing app. Yep, including Apple Watch support. [Read more] | Read more »
Oh My Glob! Adventure Time Puzzle Quest...
Finn and Jake are taking over D3 Go!'s popular puzzle game series in the upcoming Adventure Time Puzzle Quest. [Read more] | Read more »
Earthcore: Shattered Elements - Tips, Tr...
At first glance, Earthcore: Shattered Elements seems like a rather simple card-battling game. Once you’re introduced to skills that will change quite a bit. Even more so once you start to acquire hero cards. But it’s not so complicated that we... | Read more »

Price Scanner via MacPrices.net

Memorial Day Weekend Sale: New 27-inch 3.3GHz...
Best Buy has the new 27″ 3.3GHz 5K iMac on sale for $1899.99 this weekend. Choose free shipping or free local store pickup (if available). Sale price for online orders only, in-store prices may vary... Read more
OtterBox Maximizes Portability, Productivity...
From the kitchen recipe book to the boarsroom presentation, the OtterBox Agility Tablet System turns tablets into one of the most versatile pieces of handheld technology available. Available now, the... Read more
Launch of New Car App Gallery and Open Develo...
Automatic, a company on a mission to bring the power of the Internet into every car, has announced the launch of the Automatic App Gallery, an app store for nearly every car or truck on the road... Read more
Memorial Day Weekend Sale: 13-inch 1.6GHz Mac...
Best Buy has the new 13″ 1.6GHz/128GB MacBook Air on sale for $849 on their online store this weekend. Choose free shipping or free local store pickup (if available). Sale price for online orders... Read more
Memorial Day Weekend Sale: 27-inch 3.5GHz 5K...
Best Buy has the 27″ 3.5GHz 5K iMac on sale for $2099.99 this weekend. Choose free shipping or free local store pickup (if available). Sale price for online orders only, in-store prices may vary.... Read more
Sale! 16GB iPad mini 3 for $349, save $50
B&H Photo has the 16GB iPad mini 3 WiFi on sale for $349 including free shipping plus NY sales tax only. Their price is $50 off MSRP, and it’s the lowest price available for this model. Read more
Price drop on 2014 15-inch Retina MacBook Pro...
B&H Photo has dropped prices on 2014 15″ Retina MacBook Pros by $200. Shipping is free, and B&H charges NY sales tax only: - 15″ 2.2GHz Retina MacBook Pro: $1799.99 save $200 - 15″ 2.5GHz... Read more
With a Mission to Make Mobile Free, Scratch W...
Scratch Wireless, claiming to be the world’s first truly free mobile service, has announced the availability of a new Scratch-enabled Android smartphone, the Coolpad Arise. The smartphone is equipped... Read more
First-Ever Titanium Alloy Curved iPhone 6 Scr...
One of the most common problems with mobile phones is damage to the screens. The slightest drop can cause a dreaded spider web of gashes and cracks in the glass panel surface that can cost $hundreds... Read more
Preorder new 12-inch MacBook, $10 off, save o...
Adorama has new 12″ Retina MacBooks available for preorder for $10 off MSRP including free shipping plus NY & NJ sales tax only. For a limited time, Adorama will include a free Apple USB-C to USB... Read more

Jobs Board

*Apple* Solutions Consultant - Retail Sales...
**Job Summary** As an Apple Solutions Consultant (ASC) you are the link between our customers and our products. Your role is to drive the Apple business in a retail Read more
*Apple* TV Live Streaming Frameworks Test En...
**Job Summary** Work and contribute towards the engineering of Apple 's state-of-the-art products involving video, audio, and graphics in Interactive Media Group (IMG) at 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
Partner Marketing Manager, Merchant- *Apple*...
**Job Summary** The Apple Pay partner marketing team is looking for a marketing manager to develop and drive US marketing programs with our merchant partners. The right Read more
Technical Project Manager - *Apple* Pay - A...
**Job Summary** Apple Pay is seeking an experienced technical PM to…manage the on boarding of new merchants for the Apple Pay platform in the US Within this role you Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.