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

Vivaldi 1.7.735.46 - An advanced browser...
Vivaldi is a browser for our friends. In 1994, two programmers started working on a web browser. Our idea was to make a really fast browser, capable of running on limited hardware, keeping in mind... Read more
HandBrake 1.0.3 - Versatile video encode...
HandBrake is a tool for converting video from nearly any format to a selection of modern, widely supported codecs. Features Supported Sources VIDEO_TS folder, DVD image or real DVD (unencrypted... Read more
Slack 2.5.1 - Collaborative communicatio...
Slack is a collaborative communication app that simplifies real-time messaging, archiving, and search for modern working teams. Version 2.5.1: New The way we load teams you don't view often has been... Read more
BBEdit 11.6.4 - Powerful text and HTML e...
BBEdit is the leading professional HTML and text editor for the Mac. Specifically crafted in response to the needs of Web authors and software developers, this award-winning product provides a... Read more
BBEdit 11.6.4 - Powerful text and HTML e...
BBEdit is the leading professional HTML and text editor for the Mac. Specifically crafted in response to the needs of Web authors and software developers, this award-winning product provides a... Read more
beaTunes 4.6.12 - Organize your music co...
beaTunes is a full-featured music player and organizational tool for music collections. How well organized is your music Library? Are your artists always spelled the same way? Any R.E.M. vs REM?... Read more
Tinderbox 7.0.1 - Store and organize you...
Tinderbox is a personal content management assistant. It stores your notes, ideas, and plans. It can help you organize and understand them. And Tinderbox helps you share ideas through Web journals... Read more
FotoMagico 5.4 - Powerful slideshow crea...
FotoMagico lets you create professional slideshows from your photos and music with just a few, simple mouse clicks. It sports a very clean and intuitive yet powerful user interface. High image... Read more
Direct Mail 4.3.9 - Create and send grea...
Direct Mail is an easy-to-use, fully-featured email marketing app purpose-built for OS X. It lets you create and send great looking email campaigns. Start your newsletter by selecting from a gallery... Read more
Tinderbox 7.0.1 - Store and organize you...
Tinderbox is a personal content management assistant. It stores your notes, ideas, and plans. It can help you organize and understand them. And Tinderbox helps you share ideas through Web journals... Read more

The best sales on the App Store this wee...
The App Store has quite an exciting lineup of discount games this week that range across a variety of genres. It's a great opportunity to catch up on some of the premium games you may have been holding off on -- and some you can even grab for free... | Read more »
The best new games we played this week
Ah, here we are again at the close of another busy week. Don't rest too easy, though. We had a lot of great new releases in mobile games this week, and now you're going to have to spend all weekend playing them. That shouldn't be too much of a... | Read more »
Rollercoaster Tycoon Touch Guide: How to...
| Read more »
Rabbids Crazy Rush Guide: How to unlock...
The Rabbids are back in a new endless running adventure, Rabbids Crazy Rush. It's more ridiculous cartoon craziness as you help the little furballs gather enough fuel (soda) to get to the moon. Sure, it's a silly idea, but everyone has dreams --... | Read more »
Tavern Guardians (Games)
Tavern Guardians 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: Tavern Guardians is a Hack-and-Slash action game played in the style of a match-three. You can experience high pace action... | Read more »
Slay your way to glory in idle RPG Endle...
It’s a golden age for idle games on the mobile market, and those addictive little clickers have a new best friend. South Korean developer Ekkorr released Endless Frontier last year, and players have been idling away the hours in the company of its... | Read more »
Tiny Striker: World Football Guide - How...
| Read more »
Good news everyone! Futurama: Worlds of...
Futurama is finding a new home on mobile in TinyCo and Fox Interactive's new game, Futurama: Worlds of Tomorrow. They're really doing it up, bringing on board Futurama creator Matt Groening along with the original cast and writers. TinyCo wants... | Read more »
MUL.MASH.TAB.BA.GAL.GAL (Games)
MUL.MASH.TAB.BA.GAL.GAL 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: ENDLESS UPGRADES. CONSTANT DANGER. ANCIENT WISDOM. BOUNCY BALLS. Launch Sale, 40% OFF for a very limited time!!! MUL.... | Read more »
Dungeon Rushers (Games)
Dungeon Rushers 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: Dungeon Rushers is a 2D tactical RPG combining dungeon crawler’s gameplay and turn based fights. Manage your team, loot dusty... | Read more »

Price Scanner via MacPrices.net

12-inch 1.2GHz Retina MacBooks on sale for $2...
Newegg has the 12″ 1.2GHz Space Gray Retina MacBook (sku MLH82LL/A) on sale for $1349.99 including free shipping. Their price is $250 off MSRP, and it’s the lowest price available for this model.... Read more
13-inch MacBook Airs on sale for $100 off MSR...
B&H Photo has 13″ MacBook Airs on sale for $100 off MSRP. Shipping is free, and B&H charges NY sales tax only: - 13″ 1.6GHz/128GB MacBook Air (MMGF2LL/A): $899 $100 off MSRP - 13″ 1.6GHz/... Read more
9-inch 32GB Silver iPad Pro on sale for $549,...
B&H Photo has the 9.7″ 32GB Silver Apple iPad Pro on sale for $549 for a limited time. Shipping is free, and B&H charges NY sales tax only. Their price is $50 off standard MSRP for this model... Read more
13-inch 2.0GHz Apple MacBook Pros on sale for...
B&H has the non-Touch Bar 13″ 2.0GHz MacBook Pros in stock today and on sale for $100 off MSRP. Shipping is free, and B&H charges NY sales tax only: - 13″ 2.0GHz MacBook Pro Space Gray (... Read more
15-inch Touch Bar MacBook Pros on sale for up...
B&H Photo has the new 2016 15″ Apple Touch Bar MacBook Pros in stock today and on sale for up to $150 off MSRP. Shipping is free, and B&H charges NY sales tax only: - 15″ 2.7GHz Touch Bar... Read more
12-inch Retina MacBooks on sale for $1150, $1...
B&H has 12″ 1.1GHz Retina MacBooks on sale for $150 off MSRP. Shipping is free, and B&H charges NY sales tax only: - 12″ 1.1GHz Space Gray Retina MacBook: $1149 $150 off MSRP - 12″ 1.1GHz... Read more
Apple restocks refurbished 11-inch MacBook Ai...
Apple has Certified Refurbished 11″ MacBook Airs (the latest models recently discontinued by Apple), available for up to $170 off original MSRP. An Apple one-year warranty is included with each... Read more
Apple Park Opens to Employees in April With T...
Apple has announced that Apple Park, the company’s new 175-acre campus, will be ready for employees to begin occupying in April. The process of moving more than 12,000 people will take over six... Read more
Manhattan Neighbors for Safer Telecommunicati...
A new education and advocacy group focused on cell phone and wireless risks, Manhattan Neighbors for Safer Telecommunications, launched today at http://www.ManhattanNeighbors.org. Manhattan... Read more
Portable Dual DisplayPort Monitor Dock Enable...
IOGEAR has announced the launch of its USB-C Dual DisplayPort Monitor Portable Dock (GUC3CMST). The dock enables users to easily connect two DisplayPort monitors to a USB-C or Thunderbolt 3 laptop to... Read more

Jobs Board

*Apple* Retail - Multiple Positions - Apple,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
*Apple* Retail - Multiple Positions- Chicago...
SalesSpecialist - Retail Customer Service and SalesTransform Apple Store visitors into loyal Apple customers. When customers enter the store, you're also the Read more
Manager *Apple* Systems Administration - Pu...
Req ID 3315BR Position Title Manager, Apple Systems Administration Job Description The Manager of Apple Systems Administration oversees the administration and Read more
*Apple* Retail - Multiple Positions - Apple,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
Manager *Apple* Systems Administration - Pu...
Req ID 3315BR Position Title Manager, Apple Systems Administration Job Description The Manager of Apple Systems Administration oversees the administration and Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.