TweetFollow Us on Twitter

September 92 - Rapid Prototyping With Handlers in AdLib

Rapid Prototyping With Handlers in AdLib

Nick Nallick

When you hear about the advantages of object-oriented programming, one of the benefits that usually comes up is rapid prototyping. Rapid prototyping is the creation of a trial application that looks like a commercial application without investing much work in programming. This can be very useful when designing the feature set and user interface of a new application.

The addition of behaviors to MacApp allows a new dimension in prototyping. A library of generic behaviors can be created and added to an existing program to provide new functions quickly without additional coding. AdLib carries this capability a step further by providing a general purpose behavior called a Handler. Handlers provide many simple functions in response to various messages within MacApp. Thus, many useful functions can be easily added to a prototype by creating handlers along with the views are created.

How rapid is your prototyping?

One of the reasons for the popularity of HyperCard is the ease with which you go from creating a button to using it. Do you want to add a new function to a card? No problem, just switch to edit mode, create a button, name it, and assign the function to it. Switch back to run mode and you're ready to use the new function. Of course, this glosses over the complexity of the new function itself, but many functions are relatively simple, especially in the prototyping phase of development. For example, when I select this menu item, I want that window to open, or when a particular button is pressed it must signal the application or document.

MacApp has not always been the most convenient prototyping environment. To add the same button as in the HyperCard example, you go to your view editor, create a button, name it, and assign a new class name to it. Not too bad so far, but now you have to go back to MPW, create the new class, override DoEvent(), provide the function, and run through the compile, link, and rez cycle. And, by the way, don't forget to make sure your class doesn't get dead stripped by the linker, or you'll have to run through the build cycle again. If you're trying out a lot of small changes in a prototype, this can get tedious.

The idea behind handlers in AdLib is to move this cycle as far into the view editor as possible. This provides a faster, easier way to perform simple functions.

We work hard so you won't have to.

Handlers are general purpose behaviors that allow objects in an application, such as views, to respond to specific messages by sending different messages to other objects within the application. In other words, in response to a message, such as a mouse command, a view's handler could send some message, such as an event number to the view's document or some other object. Handlers can respond to and send a wide variety of message types, and they provide a number of target objects to send the messages to.

Messages are handled in the same way as you might handle them in a MacApp application by overriding such members as DoEvent() or DoMouseCommand() in your objects. In response to a particular message, a handler performs some action. Actions either send messages, such as events or menu commands, or perform simple functions, such as opening a window or enabling a menu. Most actions are performed on a target object. The target may be the application object, the document, the head of the target chain, or some other object, such as a view specified by its identifier.

All of the handlers for an object are implemented by attaching another object of class THandlerBehavior to it. THandlerBehavior is derived from TBehavior, so handlers can take advantage of the behavior mechanism introduced in MacApp 3.0. Behaviors, if you're not familiar with them already, are objects that can be attached to descendants of TEventHandler in view resources or at run time. Behaviors get a chance to respond to messages from MacApp before the objects they are attached to. A THandlerBehavior object is stored in a view resource with additional data to indicate which messages to respond to, in what ways. A single THandlerBehavior object can provide handlers for any number of messages within an object. The source for the THandlerBehavior class is included with AdLib, to provide for the most effective use in each application.

Since behaviors can be added to any class derived from TEventHandler, including TApplication, handlers can be added to the application object itself. This provides a convenient place to handle menu and other global functions in a prototype. For example, in response to a Setup Menu message, an application's handler can enable all of the appropriate menus. Furthermore, in response to particular menu command messages, it can open the corresponding windows. This, in conjunction with MacApp's default menu command handling, can provide a very lifelike prototype without any high level coding at all.

Handlers are ideal for user interface elements that exist only to send a signal when selected. One increasingly popular construct of this type is the tool bar-a strip at the top of the document window containing small buttons that perform menu commands or other useful functions. Handlers can be attached to these buttons to send the desired menu command or perform other simple functions. Another useful concept is to design objects that respond to custom events through their DoEvent() members. For example, a text document might respond to a "go to the next page" event that could be sent by the handler of an arrow button.

Pay no attention to the man behind the curtain.

Adding handlers to objects in AdLib is a straightforward operation accomplished by point and click functions, without the need for scripting. To invoke the Handlers dialog, select a single view, or to edit the application object, select the AdLib document window, and choose Handlers from the Object menu (the dialog shown below appears).

The Handlers dialog displays a list of all handlers for the object. You can add, remove, or change the priority of handlers in the list. Several handlers can exist for each message type. They will be executed in the same order in which they appear in the list. The right half of the window contains controls to configure a handler. The illustration above shows a single handler for the Menu Command message. The handler will respond to menu command #1000 by sending event #123 to the view with the identifier 'view' in the window with the identifier 'wndw'.

A typical prototype application object will contain several handlers for the Setup Menu message to enable menus, and handlers for each specific Menu Command message to open windows and perform other functions. By handling the Initialize message an application object can display a "splash screen" to occupy the user while the application is starting. Functions in windows and dialogs can be provided by attaching handlers to buttons and other controls within the windows. By clever use of handlers in the application object and controls, in conjunction with the built in menu handling functions in MacApp, you can create a prototype that comes remarkably close to the real thing.

If you add handlers to your application object, you should derive your application object from TBehaviorApp instead of from TApplication directly. This will ensure that all the application's behaviors are loaded during initialization. As it is with THandlerBehavior, the source for TBehaviorApp is included with AdLib.

A recyclable prototype

By editing an application after it has been built, we can change its functions by adding to or changing its handlers. Since we can now add useful functions to an application without rebuilding it, the next logical step is to build a generic application expressly for the purpose of adding functions later. In other words, if we create an empty MacApp "shell" application, we can add resources such as menus and views to the basic shell and create working prototypes without touching MPW. One MacApp application becomes the basis for any number of completely different prototypes. The only trick in this application is to make sure that THandlerBehavior is included. This can be accomplished by including it in the MAMake file and referencing DontDeadStripHandler(). The following is the entire prototype shell program:
void main()
{
    TBehaviorApp* application;

    InitToolBox();
    if (ValidateConfiguration(gConfiguration))
    {
        InitUMacApp(10);    // call MoreMasters 10 times
        InitUPrinting();
        InitUTEView();
        InitUDialog();
        InitUGridView();

        application = new TBehaviorApp;
        application->IBehaviorApp('????', '????');
        application->fLaunchWithNewDocument = FALSE; 
        // if we want this, we can do this with a handler
        application->Run();
    }
    else
        StdAlert(phUnsupportedConfiguration);

    if (gDeadStripSuppression)      // never TRUE
    {
        extern pascal void DontDeadStripHandler();
        DontDeadStripHandler();
    }
}

If you have written many MacApp programs you will probably recognize most of this as standard code. We are using TBehaviorApp as our application object to load any application handlers and telling it not to start with a new document, since we don't really have a document class defined. The prototype can pretend to have a document by opening a document window from an Initialize handler in the application object.

Beyond the prototype

Eventually, successful prototypes have to become working applications. It is usually desirable to carry over as much of the prototype as possible to the final application. Today there are a number of prototyping systems available that address this issue by generating source code for a target environment. This has the advantage of working for a number of development environments, but overall it is inferior to a good application framework based approach. The basic problem is customization. As any MacApp programmer can attest to, the default behavior of an element will eventually need modification. If you have to modify the code generated by a prototyping system, it is very difficult to return to the prototyping tools to make a change. You will have to track the changes you have made to the source and put them back each time it changes. On the other hand, changing the characteristics of an element in an object oriented environment is a accomplished by overriding parts of the original. This has little effect on the development tools.

The advantage of using handlers for prototyping then, is that their prototyping capabilities are a side effect of their development capabilities, not the other way around. We are beginning to see a number of new tools become available that will change the way applications are structured. One significant new capability is dynamic linking-the ability to add new classes and modules to an application while it is running, rather than during the compile and link phase. MacApp now supports an early version of an Apple tool called Dinker (for Dynamic Linker) that provides this ability. With dynamic linking it is possible to create new libraries of objects to build prototypes with more complex characteristics than what most of us are using today. This may blur the line between prototyping and development as prototypes are gradually enhanced to the point where they become the final application.

Conclusion

Handlers provide a powerful mechanism for performing simple functions without creating special classes, and for linking views to other application elements. This eases the requirements on the programmer for creating application prototypes as well as the final applications. By building a MacApp shell application and editing copies of it, you can create any number of useful prototypes without writing any code at all. Furthermore, if you wish, the functions of your prototype can be used directly in your final application with or without change. This is an advantage over prototyping systems that generate source code because changing the generated source makes it very difficult to return to the original editing environment.

Handlers provide a way to add simple functions to an existing application. As dynamic linking becomes more accessible through tools like Dinker, complex functions will also be eligible for addition in this way. This may completely change the way most people develop application software in the future, but for now we can take one step in that direction.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Bookends 12.8 - Reference management and...
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
Apple iTunes 12.6 - Play Apple Music and...
Apple iTunes lets you organize and stream Apple Music, download and watch video and listen to Podcasts. It can automatically download new music, app, and book purchases across all your devices and... Read more
Default Folder X 5.1.4 - Enhances Open a...
Default Folder X attaches a toolbar to the right side of the Open and Save dialogs in any OS X-native application. The toolbar gives you fast access to various folders and commands. You just click on... Read more
Amazon Chime 4.1.5587 - Amazon-based com...
Amazon Chime is a communications service that transforms online meetings with a secure, easy-to-use application that you can trust. Amazon Chime works seamlessly across your devices so that you can... Read more
CrossOver 16.2 - Run Windows apps on you...
CrossOver can get your Windows productivity applications and PC games up and running on your Mac quickly and easily. CrossOver runs the Windows software that you need on Mac at home, in the office,... Read more
Adobe Creative Cloud 4.0.0.185 - Access...
Adobe Creative Cloud costs $19.99/month for a single app, or $49.99/month for the entire suite. Introducing Adobe Creative Cloud desktop applications, including Adobe Photoshop CC and Illustrator CC... Read more
MegaSeg 6.0.2 - Professional DJ and radi...
MegaSeg is a complete solution for pro audio/video DJ mixing, radio automation, and music scheduling with rock-solid performance and an easy-to-use design. Mix with visual waveforms and Magic... Read more
Bookends 12.8 - Reference management and...
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
Adobe Creative Cloud 4.0.0.185 - Access...
Adobe Creative Cloud costs $19.99/month for a single app, or $49.99/month for the entire suite. Introducing Adobe Creative Cloud desktop applications, including Adobe Photoshop CC and Illustrator CC... Read more
Default Folder X 5.1.4 - Enhances Open a...
Default Folder X attaches a toolbar to the right side of the Open and Save dialogs in any OS X-native application. The toolbar gives you fast access to various folders and commands. You just click on... Read more

The best new games we played this week
It's been quite the week, but now that all of that business is out of the way, it's time to hunker down with some of the excellent games that were released over the past few days. There's a fair few to help you relax in your down time or if you're... | Read more »
Orphan Black: The Game (Games)
Orphan Black: The Game 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: Dive into a dark and twisted puzzle-adventure that retells the pivotal events of Orphan Black. | Read more »
The Elder Scrolls: Legends is now availa...
| Read more »
Ticket to Earth beginner's guide: H...
Robot Circus launched Ticket to Earth as part of the App Store's indie games event last week. If you're not quite digging the space operatics Mass Effect: Andromeda is serving up, you'll be pleased to know that there's a surprising alternative on... | Read more »
Leap to victory in Nexx Studios new plat...
You’re always a hop, skip, and a jump away from a fiery death in Temple Jump, a new platformer-cum-endless runner from Nexx Studio. It’s out now on both iOS and Android if you’re an adventurer seeking treasure in a crumbling, pixel-laden temple. | Read more »
Failbetter Games details changes coming...
Sunless Sea, Failbetter Games' dark and gloomy sea explorer, sets sail for the iPad tomorrow. Ahead of the game's launch, Failbetter took to Twitter to discuss what will be different in the mobile version of the game. Many of the changes make... | Read more »
Splish, splash! The Pokémon GO Water Fes...
Niantic is back with a new festival for dedicated Pokémon GO collectors. The Water Festival officially kicks off today at 1 P.M. PDT and runs through March 29. Magikarp, Squirtle, Totodile, and their assorted evolved forms will be appearing at... | Read more »
Death Road to Canada (Games)
Death Road to Canada 1.0 Device: iOS Universal Category: Games Price: $7.99, Version: 1.0 (iTunes) Description: Get it now at the low launch price! Price will go up a dollar every major update. Update news at the bottom of this... | Read more »
Bean's Quest Beginner's Guide:...
Bean's Quest is a new take on both the classic platformer and the endless runner, and it's free on the App Store for the time being. Instead of running constantly, you can't stop jumping. That adds a surprising new level of challenge to the game... | Read more »
How to rake in the cash in Bit City
Our last Bit City guide covered the basics. Now it's time to get into some of the more advanced techniques. In the later cities, cash flow becomes much more difficult, so you'll want to develop some strategies if you want to complete each level.... | Read more »

Price Scanner via MacPrices.net

SSD Speeder RAM Disk SSD Life Extender App Fo...
Fehraltorf, Switzerland based B-Eng has announced they are making their SSD Speeder app for macOS publicly available for purchase on their website. SSD Speeder is a RAM disk utility that prevents... Read more
iPhone Scores Highest Overall in Smartphone D...
Customer satisfaction is much higher among smartphone owners who use their device to operate other connected home services such as smart thermostats and smart appliances, according to the J.D. Power... Read more
Swipe CRM Free Photo-Centric CRM Sales DEal C...
Swipe CRM LLC has introduced Swipe CRM: Visual Sales 1.0 for iPad, an app for creating, managing, and sharing visually stunning sales deals. Swipe CRM is targeted to small-and-medium creative... 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 $150 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
Apple’s iPhone 6s Tops Best-Selling Smartphon...
In terms of shipments, the iPhone 6s from Apple bested all competitors for sales in 2016, according to new analysis from IHS Markit, a world leader in critical information, analytics and solutions.... Read more
Logitech Rugged Combo Protective iPad Case an...
Logitech has announced its Logitech Rugged Combo, Logitech Rugged Case, and Logitech Add-on Keyboard for Rugged Case for Apple’s new, more affordable $329 9.7-inch iPad, a complete solution designed... Read more
T-Mobile To Offer iPhone 7 and iPhone 7 Plus...
T-Mobile has announced it will offer iPhone 7 and iPhone 7 Plus (PRODUCT)RED Special Edition in a vibrant red aluminum finish. The introduction of this special edition iPhone celebrates Apple’s 10... Read more
9-inch 128GB iPad Pros on sale for $50-$70 of...
B&H Photo has 9.7″ 128GB Apple WiFi iPad Pros on sale for up to $70 off MSRP, each including free shipping. B&H charges sales tax in NY only: - 9″ Space Gray 128GB WiFi iPad Pro: $649 $50... Read more
27-inch iMacs on sale for up to $200 off MSRP...
B&H Photo has 27″ Apple iMacs on sale for up to $200 off MSRP, each including free shipping plus NY sales tax only: - 27″ 3.3GHz iMac 5K: $2099 $200 off MSRP - 27″ 3.2GHz/1TB Fusion iMac 5K: $... Read more

Jobs Board

*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
Fulltime aan de slag als shopmanager in een h...
Ben jij helemaal gek van Apple -producten en vind je het helemaal super om fulltime shopmanager te zijn in een jonge en hippe elektronicazaak? Wil jij werken in Read more
Starte Dein Karriere-Abenteuer in den Hauptst...
…mehrsprachigen Teams betreust Du Kunden von bekannten globale Marken wie Apple , Mercedes, Facebook, Expedia, und vielen anderen! Funktion Du wolltest schon Read more
*Apple* macOS Systems Integration Administra...
…most exceptional support available in the industry. SCI is seeking an Junior Apple macOS systems integration administrator that will be responsible for providing 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
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.