TweetFollow Us on Twitter

PowerPlant
Volume Number:11
Issue Number:9
Column Tag:Getting Started

PowerPlant

By Dave Mark, MacTech Magazine Regular Contributing Author

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

This month, we’re going to take a look at PowerPlant, the framework included on every CodeWarrior CD. If you own Symantec C++, take heart: we’ll get to the TCL in a future column. In the meantime, follow along anyway. Who knows, you might find yourself making the switch to PowerPlant someday.

This Month’s Program

I don’t know about you but, after four month’s straight of menus, I’m ready for something else. So instead of talking about PowerPlant and menu handling (we’ll do that in a future column), this month’s program will introduce PowerPlant’s messaging system.

As you design your PowerPlant programs, you’ll work with objects called broadcasters and listeners. A broadcaster sends a message and a listener receives that message. In this month’s program, we’ll create a window containing a button. Each time the button is clicked, it will send a message to any objects registered as listeners to it. Basically, this means that the broadcasting objects’ BroadcastMessage() member function calls the listening object’s ListenToMessage() member function.

This mechanism is simpler than it sounds. As we build our project, just remember that the button is a broadcaster, and that the class CDashboardApp will be the listener.

If you have the CW6 documentation, you might want to read the section named LBroadcaster & LListener in the PowerPlant manual (chapter 8, page 93).

As is usually the case when working with a framework, we’ll take an existing PowerPlant example and modify it to suit our needs.

• Duplicate the folder “CodeWarrior6:Metrowerks PowerPlant:More PowerPlant Examples:Dashboard Starter”.

If you run one of the projects in this folder (either Dashboard68K.µ or DashboardPPC.µ), you’ll see the window shown in Figure 1. To quit the program, select Quit from the File menu. As you can see, Quit is the only item in the File menu. In a future column, we’ll add some menus and items to a PowerPlant program. For now, let’s add a button to the Dashboard window.

Figure 1. The Dashboard Starter window, before our modifications.

Editing Dashboard.PPob

CodeWarrior comes with a ResEdit-like program, named Contructor, that lets you create and edit PowerPlant-specific resources. The resource we’re interested in in this column is the PPob resource. A PPob resource is like a combination of a DLOG and DITL, but for any PowerPlant view including windows and dialogs. We’ll use Constructor to add a button to the Dashboard window.

CodeWarrior 6 ships with two different versions of Constructor. Though both will do the job, Constructor 2.0a16 is far newer than Constructor 1.0.1 and seems pretty stable for an alpha release. The screen shots and instructions in this column were all based on 2.0a16. You’ll find both versions in the CodeWarrior 6 folder, inside the Metrowerks PowerPlant subfolder.

• Launch Constructor 2.0a16 and open the file Dashboard.PPob (it’s in the same folder as the two Dashboard project files).

As you can see by the Constructor window shown in Figure 2, the file Dashboard.PPob already contains a resource. This PPob resource represents the main Dashboard window. It has a resource ID of 200 and represents an object belonging to the class LWindow.

Figure 2. The Constructor window listing the view resources in Dashboard.PPob.

Our next step is to edit this PPob resource.

• Double-click on the LWindow PPob with an id of 200.

When you double-click on PPob 200, a PPob editing window will appear (see Figure 3) showing the object view hierarchy defined by this PPob. Right now, the PPob consists of a single window.

Figure 3. A Constructor window showing PPob 200.

If you click on the window view and select Pane Information... from the Pane menu (or just double-click on the window view), a pane info window will appear (see Figure 4) allowing you to edit the selected view. In this case, the selected view describes a document window with a zoom box, no close box, positioned automatically in the Alert position on the main screen, etc. Feel free to edit this view if you like. To test your changes, quit Constructor, saving your changes, then use CodeWarrior to rerun the project.

Figure 4. The Pane Info window describing the Dashboard window.

Figure 5. The items you can place in a window using Constructor.

With the PPob 200 window in front, you should notice a palette window listing all the items you can place in a PPob view. The palette, shown in Figure 5, works just like ResEdit’s DITL palette. To add an item to a view, drag the item off the palette into the PPob window.

Here’s where we’ll add the button to the window.

• Drag an LStdButton off of the palette into the window view in the PPob 200 window.

• Double-click on the button that appears and edit the info window to match the one shown in Figure 6.

Figure 6. The info window for the LStdButton we added to our window view.

There are three important changes to make in the LStdButton info window. First, change the Pane ID: field to read 1000 (be sure the Text ID checkbox is unchecked before you change the ID). The Pane ID serves to identify the button pane from all the other panes in the PPob resource. By convention, number your panes starting at 1000 and moving upwards from there. For example, if you added three items to the Dashboard window represented by PPob 200, you’d set their Pane IDs to 1000, 1001, and 1002.

The second change to make to the LStdButton info window is to fill in the Button Title: field. Since we want our button to beep, the word Beep will make a fine button title.

The third change is to the Value Message: field. This field contains the message that will get sent when the button is clicked. The message is an integer constant that will be passed as a parameter to any objects registered as listeners to the broadcasting button. Again, by convention, we’ll number our messages starting at 1000.

That’s it. Save your changes and quit Constructor.

Dashboard68K.µ or DashboardPPC.µ

If you haven’t already, open up one of the Dashboard projects (either Dashboard68K.µ or DashboardPPC.µ). Since we want to add a button to our window, we’ll need to add the files that contain the PowerPlant classes that implement push buttons: LControl.cp and LStdControl.cp.

• In the project window, click on the triangle to the left of the group named Pane. When we add the two files, we want to add them to this group.

• Add the files LControl.cp and LStdControl.cp to the project. You’ll find them in the folder “CodeWarrior 6:Metrowerks C/C++:PowerPlant Libraries:Pane Classes”

CDashboardApp.h

• Open the file CDashboardApp.h.

• Add this line after the #include of <LApplication.h>:

#include <LListener.h>

• Change the first line of the CDashboardApp class to look like this:

class CDashboardApp : public LApplication, public LListener {

To convert the CDashboardApp class into a listener, we have to make sure it is derived from the class LListener. Deriving a class from more than one class is perfectly acceptable in C++ and is known as multiple inheritence.

Another step in making the CDashboardApp class a listener is to add a member function named ListenToMessage(). ListenToMessage() will get called when any broadcaster it is listening to broadcasts a message.

• Add this line after the definition of the member function FindCommandStatus():

 virtual void    ListenToMessage(MessageT inMessage, void *ioParam);

• Close CDashboardApp.h and save your changes.

CDashboardApp.cp

Here’s where all the action is. Take some time to look through the file and read all the comments (don’t worry, the file isn’t that long). Notice that main() defines a CDashboardApp object and then calls the member function Run() which was inherited from the LApplication class.

• Add this line after all the other #include files:

#include <LStdControl.h>

Notice that even though we added the files LStdControl.cp and LControl.cp to the project, we don’t include the file <LControl.h>. <LControl.h> is included by <LStdControl.h>.

• In the constructor, find the call of the static function URegister::RegisterClass() and add this line right below it:

 URegistrar::RegisterClass(LStdButton::class_ID,
 LStdButton::CreateStdButtonStream);

This line tells PowerPlant which function to call (LStdButton::CreateStdButtonStream()) when an object of type LStdButton is created based on a PPob resource. Before we came along, this program only needed to register the LWindow class. Since we added an LStdButton object to the PPob resource, we’ll need to register that class as well.

• Also in the constructor, just before the call of mDisplayWindow->Show(), add these lines:

 LStdButton *theButton =
 (LStdButton *)mDisplayWindow->FindPaneByID( 1000 );
 theButton->AddListener( this );

The first line searches the window mDisplayWindow for the pane with the id 1000. Now you know why we entered the number 1000 in the LStdButton’s Pane ID: field.

The second line registers the current object (the CDashboardApp object, known here as this) as a listener of the button we just found.

• At the end of the file, add the member function CDashboardApp::ListenToMessage():

// ----------------------------------------------------------
// • ListenToMessage
// ----------------------------------------------------------
// Respond to message 1000 broadcast by pushbutton

void
CDashboardApp::ListenToMessage(MessageT inMessage, void *ioParam)
{
 if ( inMessage == 1000 )
 SysBeep( 20 );
}

This function will get called whenever the button is clicked. The message 1000 will be passed in as the parameter inMessage.

Figure 7. The Dashboard window. This time it has a button in it.

Running the Program

That’s about it. Save your changes and run the program. The usual Dashboard window will appear, but this time with a button smack-dab in the middle of it. Press the button and, guess what, your Mac will beep at you.

Till Next Month

Obviously, this month’s program gives you only a brief glimpse into the PowerPlant framework. On the other hand, it’s a pretty solid glimpse. Try your hand at adding some other panes to the Dashboard window containment hierarchy. Start by adding a second button with its own pane ID and its own message ID. Next, try to add some other controls.

What part of PowerPlant would you like to learn about next? Should I get into other control types? How about (shudder) menus? Send email. I’ll be waiting to hear from you. See you next month...

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Skype 8.52.0.138 - 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
Bookends 13.2.6 - Reference management a...
Bookends is a full-featured bibliography/reference and information-management system for students and professionals. Bookends uses the cloud to sync reference libraries on all the Macs you use.... Read more
BusyContacts 1.4.0 - Fast, efficient con...
BusyContacts is a contact manager for OS X that makes creating, finding, and managing contacts faster and more efficient. It brings to contact management the same power, flexibility, and sharing... Read more
Chromium 77.0.3865.75 - Fast and stable...
Chromium is an open-source browser project that aims to build a safer, faster, and more stable way for all Internet users to experience the web. Version 77.0.3865.75: A list of changes is available... Read more
DiskCatalogMaker 7.5.5 - Catalog your di...
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 for... Read more
Alfred 4.0.4 - 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
A Better Finder Rename 10.45 - File, pho...
A Better Finder Rename is the most complete renaming solution available on the market today. That's why, since 1996, tens of thousands of hobbyists, professionals and businesses depend on A Better... Read more
iFinance 4.5.11 - Comprehensively manage...
iFinance allows you to keep track of your income and spending -- from your lunchbreak coffee to your new car -- in the most convenient and fastest way. Clearly arranged transaction lists of all your... Read more
OmniGraffle Pro 7.11.3 - Create diagrams...
OmniGraffle Pro helps you draw beautiful diagrams, family trees, flow charts, org charts, layouts, and (mathematically speaking) any other directed or non-directed graphs. We've had people use... Read more
BBEdit 12.6.7 - 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

Latest Forum Discussions

See All

Five Nights at Freddy's AR: Special...
Five Nights at Freddy's AR: Special Delivery is a terrifying new nightmare from developer Illumix. Last week, FNAF fans were sent into a frenzy by a short teaser for what we now know to be Special Delivery. Those in the comments were quick to... | Read more »
Rush Rally 3's new live events are...
Last week, Rush Rally 3 got updated with live events, and it’s one of the best things to happen to racing games on mobile. Prior to this update, the game already had multiplayer, but live events are more convenient in the sense that it’s somewhat... | Read more »
Why your free-to-play racer sucks
It’s been this way for a while now, but playing Hot Wheels Infinite Loop really highlights a big issue with free-to-play mobile racing games: They suck. It doesn’t matter if you’re trying going for realism, cart racing, or arcade nonsense, they’re... | Read more »
Steam Link Spotlight - The Banner Saga 3
Steam Link Spotlight is a new feature where we take a look at PC games that play exceptionally well using the Steam Link app. Our last entry talked about Terry Cavanaugh’s incredible Dicey Dungeons. Read about how it’s a great mobile experience... | Read more »
PSA: GRIS has some issues
You may or may not have seen that Devolver Digital just released GRIS on the App Store, but we wanted to do a quick public service announcement to say that you might not want to hop on buying it just yet. The puzzle platformer has come to small... | Read more »
Explore the world around you in new matc...
Got a hankering for a fresh-feeling Match-3 puzzle game that offers a unique twist? You might find exactly what you’re looking for with What a Wonderful World, a new spin on the classic mobile genre which merges entertaining puzzles with global... | Read more »
Combo Quest (Games)
Combo Quest 1.0 Device: iOS Universal Category: Games Price: $.99, Version: 1.0 (iTunes) Description: Combo Quest is an epic, time tap role-playing adventure. In this unique masterpiece, you are a knight on a heroic quest to retrieve... | Read more »
Hero Emblems (Games)
Hero Emblems 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: ** 25% OFF for a limited time to celebrate the release ** ** Note for iPhone 6 user: If it doesn't run fullscreen on your device... | Read more »
Puzzle Blitz (Games)
Puzzle Blitz 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: Puzzle Blitz is a frantic puzzle solving race against the clock! Solve as many puzzles as you can, before time runs out! You have... | Read more »
Sky Patrol (Games)
Sky Patrol 1.0.1 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0.1 (iTunes) Description: 'Strategic Twist On The Classic Shooter Genre' - Indie Game Mag... | Read more »

Price Scanner via MacPrices.net

Save $150-$250 on 10.2″ WiFi + Cellular iPads...
Verizon is offering $150-$250 discounts on Apple’s new 10.2″ WiFi + Cellular iPad with service. Buy the iPad itself and save $150. Save $250 on the purchase of an iPad along with an iPhone. The fine... Read more
Apple continues to offer 13″ 2.3GHz Dual-Core...
Apple has Certified Refurbished 2017 13″ 2.3GHz Dual-Core non-Touch Bar MacBook Pros available starting at $1019. An standard Apple one-year warranty is included with each model, outer cases are new... Read more
Apple restocks 2018 MacBook Airs, Certified R...
Apple has restocked Certified Refurbished 2018 13″ MacBook Airs starting at only $849. Each MacBook features a new outer case, comes with a standard Apple one-year warranty, and is shipped free. The... Read more
Sunday Sale! 2019 27″ 5K 6-Core iMacs for $20...
B&H Photo has the new 2019 27″ 5K 6-Core iMacs on stock today and on sale for up to $250 off Apple’s MSRP. Overnight shipping is free to many locations in the US. These are the same iMacs sold by... Read more
Weekend Sale! 2019 13″ MacBook Airs for $200...
Amazon has new 2019 13″ MacBook Airs on sale for $200 off Apple’s MSRP, with prices starting at $899, each including free shipping. Be sure to select Amazon as the seller during checkout, rather than... Read more
2019 15″ MacBook Pros now on sale for $350-$4...
B&H Photo has Apple’s 2019 15″ 6-Core and 8-Core MacBook Pros on sale today for $350-$400 off MSRP, starting at $2049, with free overnight shipping available to many addresses in the US: – 2019... Read more
Buy one Apple Watch Series 5 at Verizon, get...
Buy one Apple Watch Series 5 at Verizon, and get a second Watch for 50% off. Plus save $10 on your first month of service. The fine print: “Buy Apple Watch, get another up to 50% off on us. Plus $10... Read more
Sprint offers 64GB iPhone 11 for free to new...
Sprint will include the 64GB iPhone 11 for free for new customers with an eligible trade-in in of the iPhone 7 or newer through September 19, 2019. The fine print: “iPhone 11 64GB $0/mo. iPhone 11... Read more
Verizon offers new iPhone 11 models for up to...
Verizon is offering Apple’s new iPhone 11 models for $500 off MSRP to new customers with an eligible trade-in (see list below). Discount is applied via monthly bill credits over 24 months. Verizon is... Read more
AT&T offers free $300 reward card + free...
AT&T Wireless will include a second free 64GB iPhone 11 with the purchase of one eligible iPhone at full price. They will also include a free $300 rewards card. The fine print: “Buy an elig.... Read more

Jobs Board

Student Employment (Blue *Apple* Cafe) Spri...
Student Employment (Blue Apple Cafe) Spring 2019 Penn State University Campus/Location: Penn State Brandywine Campus City: Media, PA Date Announced: 12/20/2018 Date Read more
Best Buy *Apple* Computing Master - Best Bu...
**732359BR** **Job Title:** Best Buy Apple Computing Master **Job Category:** Store Associates **Location Number:** 000171-Winchester Road-Store **Job Description:** Read more
*Apple* Mobile Master - Best Buy (United Sta...
**732324BR** **Job Title:** Apple Mobile Master **Job Category:** Store Associates **Location Number:** 000013-Fargo-Store **Job Description:** **What does a Best Read more
Best Buy *Apple* Computing Master - Best Bu...
**732455BR** **Job Title:** Best Buy Apple Computing Master **Job Category:** Sales **Location Number:** 000449-Auburn Hills-Store **Job Description:** **What does a Read more
*Apple* Mobility Pro - Best Buy (United Stat...
**732490BR** **Job Title:** Apple Mobility Pro **Job Category:** Store Associates **Location Number:** 000449-Auburn Hills-Store **Job Description:** At Best Buy, Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.