TweetFollow Us on Twitter

May 93 - Three MacApp 3.0.1 Shortcuts

Three MacApp 3.0.1 Shortcuts

Ken Victor

The following three shortcuts have made my life much simpler while developing a new MacApp 3.0.1 application using C++.

Try and Catch Macros

In a past issue of "Develop" magazine, the C macros for Try and Catch were defined for MacApp 2. I got used to using these when I was developing a MacApp 2 product using C++, and although the MacApp 3 approach to exception handling is easier to use with C++, I wanted to continue to use Try and Catch. I find this more meaningful to read than if fi.Try(). So here is my version for MacApp 3:
#define try                    \
    FailInfo fi;            \
    if (fi.Try()) {
#define catch               \
    fi.Success();           \
    }                       \
    else
#define try2                \
    if (fi.Try()) {
#define success     fi.Success()
#define resignal    fi.ReSignal()

Thus you can write code that looks like the following:

try {
    …
    }
catch {
    …
    resignal;
    }

    or:

try …
catch ;

    or:

try {
    …
    success;
    return;
    …
    }
catch ;

These macros nest properly so that you can write the following:

try {
    …
    try {
        …
        }
    catch {
        …
        resignal;
        }
    …
    }
catch {
    …
    resignal;
    }

The Try2 macro is used if you want a second, or third, Try clause at the same level as a previous one. E.g.:

try {
    …
    }
catch {
    …
    resignal;
    }
…
try2 {
    …
    }
catch {
    …
    resignal;
    }

The Catch macro could easily be modified to automatically resignal, but I felt it best not to hide this, and to save the few bytes in the situation where I didn't need to resignal.

TMyDocument Shortcut

When developing a new application, each time you add, change, or delete a class variable from your TMyDocument class, there are up to 8 different methods that you may have to change:
Initialize
IMyDocument
DoInitialState
Free
FreeData
DoNeedDiskSpace
DoRead
DoWrite

And it is important that DoRead and DoWrite perform operations in the same order. I got tired of trying to remember to update each of these methods, and of having to go back and forth between DoRead and DoWrite to make sure I was doing things in the right order. I therefore decided to localize all these functions into one common method. The price I pay for this is a slight performance hit due to the extra switches in my common routine, a slight violation of clean segmentation, and a violation of the tenant of a single routine performing a single function. I felt that these were a small price to pay for the increased convenience. When my app is complete, I can always do away with this common routine, and place the appropriate code in each of the specific methods.

My common routine is defined as follows:

enum tDocIterType {
    forReading,
    forWriting,
    forSizing,
    forInitialize,
    forIDoc,
    forDoInitial,
    forFreeData,
    forFree
    };
void    DoSRWIIDF(  tDocIterType iterType,
                    TFile* aFile,
                    long& dataForkBytes,
                    long& rsrcForkBytes,
                    Boolean modifier = false);

Each of my standard methods is now quite simple and implemented similarly to the following:

pascal void TMyDocument::DoNeedDiskSpace(
                        TFile* itsFile,
                        long& dataForkBytes,
                        long& rsrcForkBytes) {
    // count us
    DoSRWIIDF(  forSizing,
                itsFile, 
                dataForkBytes, 
                rsrcForkBytes);
    }   //  end of TMyDocument :: DoNeedDiskSpace 

My common routine locks the document, so I can read and write to it comfortably, allocates any needed Streams, and for each member variable in the document performs a switch to perform the required action. The core of the code follows:

#pragma segment DocReadWriteEtc
void TMyDocument::DoSRWIIDF(    tDocIterType iterType,
                    TFile* aFile,
                    long& dataForkBytes,
                    long& rsrcForkBytes,
                    Boolean modifier) {
TStream*        aStream = NULL;
VOLATILE( aStream);

// lock us just in case
    SignedByte myState = LockHandleHigh( (Handle) this);

    try {
    // get stream for i/o
        switch (iterType) {
            case forSizing:
                aStream = new TCountingStream;
                ((TCountingStream*) aStream)->ICountingStream();
                aStream->SetPosition( 0);
                inherited::DoNeedDiskSpace( aFile,
                                        dataForkBytes,
                                        rsrcForkBytes);
                break;
            case forReading:
            case forWriting:
                aStream = new TFileStream;
                ((TFileStream*) aStream)->IFileStream( aFile);
                aStream->SetPosition( 0);
                if (iterType == forReading)
                    inherited::DoRead( aFile, modifier);
                else inherited::DoWrite( aFile, modifier);
                break;
            }
    //  field 1
        switch (iterType) {
            case forSizing:     // fall thru
            case forWriting:
                aStream->WriteBytes( &field1, sizeof( field1));
                break;
            case forReading:    
                aStream->ReadBytes( &field1, sizeof( field1));
                break;
            case forInitialize:
                …
                break;
            case forIDoc:
                …
                break;
            case forDoInitial:
                …
                break;
            case forFreeData:
                …
                break;
            case forFree:
                …
                break;
            }
    //  field 2
        …
    // free stream
        if (iterType == forSizing)
            dataForkBytes += aStream->GetSize();
        FreeIfObject( aStream);
    // unlock us
        HSetState( (Handle) this, myState);
    }
catch {
    // free stream
        FreeIfObject( aStream);
    // unlock us
        HSetState( (Handle) this, myState);
    resignal;
    }
}   //  end of TMyDocument :: DoSRWIIDF

Now whenever I add, change, or delete a field, it is a simple matter of modifying the one "block" of code.

Floating TEditTexts

In several of my dialogs, I had fields in which I wanted to restrict what characters the user could enter. I wanted to beep if the user typed an illegal character. In looking at the MacApp3Tech$ archives, the suggestions for accomplishing this basically involved subclassing TEditText and a few other classes so that you could create you own floating TEView with its appropriate behavior. Nick Nallick, in his article "Text Filtering with Behaviors" in the July 1992 FrameWorks describes such an approach. I decided to try the different approach of attaching a Behavior to the dialog floating TEView, and much to my relief this worked out even better than I thought it would, and is in fact a very general approach. You can even attach multiple instances of this behavior to the floating view, and each instance can act on different characters and/or be applied to different TEditTexts in the dialog.

The Behavior basically looks at each character the user types into a TEditText and beeps if this is an illegal character, or if it is a legal character simply passes it along the behavior chain for normal operation. The behavior will also examine each character in a pasted string and beep if the string contains any illegal characters or pass the string along. Using the behavior is quite simple and relies on the fact that there is only one floating TEView per dialog window and that this view is usually the window's target after the window has been created. First create your window and establish it as a dialog so that the floating TEView will exist. Then create the behavior:

TBhvrInputFilter* aCharBeeper = new TBhvrInputFilter;

Then call the '"I" method, passing the window:

aCharBeeper->IBhvrInputFilter( aWindow);

This will initialize the Behavior and attach it to the floating TEView. It finds the floating TEView by first looking at the window's target to see if is a member of TDialogTEView; if not, it searches the window's sub views until it finds a TDialogTEView to attach to.

Next tell the Behavior which TEditText views you wish to check by passing the identifier(s) of these views:

aCharBeeper->AddView( aEditText->GetIdentifier());
aCharBeeper->AddView( anotherEditText->GetIdentifier());

And lastly, tell the behavior which characters are allowed. The default is to not allow any characters. However there are several methods for specifying the legal characters.

aCharBeeper->AllowNumbers();
aCharBeeper->AllowControlChars();
aCharBeeper->AllowChar( '/');

The above sequence will allow numbers and the slash character, the common characters for a date input view, but will beep on all other characters. It will also allow all control characters so that normal editing can take place.

Advantages

This approach relies on the fact that a common single floating TEView is passed around, rather than each TEditText having its own floating TEView. This leads to both the advantages and disadvantages of this approach, as opposed to subclassing TEditText to install your own floating TEView. This approach is simpler to use and requires less code since there is no need to subclass. The disadvantage is that since this behavior is attached to the only floating TEView, each TEditText that you use uses this behavior, even if you don't want to filter that TEditText. The list of views to filter is maintained as a TLongintList and I haven't noticed any unacceptable performance (but I have not made any measurements). This approach is especially useful if you have several TEditTexts that require the same filtering. And, as mentioned above, if you have different filtering requirements, you can simply install multiple instances of this behavior, each with their own set of views to check, and their own set of legal characters.

Post processing

While further developing my app, I had a need to process TEditText after each character's editing action had taken place, but before any other processing could occur. (What I wanted was to perform name lookup and recognition based on the user's [partial] input string.) Since my use of behaviors for filtering input worked so well, I decided to capitalize on what I already had. I broke up TBhvrInputFilter into two classes: TBhvrFTEVFilter and TBhvrInputFilter. TBhvrFTEVFilter is an abstract class with methods for attaching itself to the floating TEView, and for adding, removing, and checking which sub views to work with. TBhvrInputFilter is now a subclass of TBhvrFTEVFilter and contains the specific methods having to do with filtering characters.

I then subclassed TBhvrFTEVFilter again to create a class that would do post processing of the user's input. This turned out to be a little more difficult than I thought it would be at first, but still simpler than any other way I could think of. The difficulty lay in the fact that when I call inherited::DoKeyEvent or inherited::DoMenuCommand, the TDialogTEView actually created command objects, rather than acting immediately. This was solved by my examining the event queue after calling the inherited method, looking for a TTECommand. If I find one, I remove it from the queue, call its DoIt, Commit, and Free methods. I can then easily get the resulting edited text and act as I wish.

In hindsight, I realized that I may have been able to use MacApp's dependency and notification techniques to accomplish this post processing. However, I now had something that worked, and I believe I might have had problems with characters after the first typed character, and "if it ain't broke..."

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Coda 2.5.11 - One-window Web development...
Coda is a powerful Web editor that puts everything in one place. An editor. Terminal. CSS. Files. With Coda 2, we went beyond expectations. With loads of new, much-requested features, a few surprises... Read more
Bookends 12.5.7 - Reference management a...
Bookends is a full-featured bibliography/reference and information-management system for students and professionals. Access the power of Bookends directly from Mellel, Nisus Writer Pro, or MS Word (... Read more
Maya 2016 - 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
RapidWeaver 6.2.3 - Create template-base...
RapidWeaver is a next-generation Web design application to help you easily create professional-looking Web sites in minutes. No knowledge of complex code is required, RapidWeaver will take care of... Read more
MacFamilyTree 7.5.2 - Create and explore...
MacFamilyTree gives genealogy a facelift: it's modern, interactive, incredibly fast, and easy to use. We're convinced that generations of chroniclers would have loved to trade in their genealogy... Read more
Paragraphs 1.0.1 - Writing tool just for...
Paragraphs is an app just for writers. It was built for one thing and one thing only: writing. It gives you everything you need to create brilliant prose and does away with the rest. Everything in... Read more
BlueStacks App Player 0.9.21 - Run Andro...
BlueStacks App Player lets you run your Android apps fast and fullscreen on your Mac. Version 0.9.21: Note: Now requires OS X 10.8 or later running on a 64-bit Intel processor. Initial stable... Read more
Tweetbot 2.0.2 - Popular Twitter client....
Tweetbot is a full-featured OS X Twitter client with a lot of personality. Whether it's the meticulously-crafted interface, sounds and animation, or features like multiple timelines and column views... Read more
Apple iBooks Author 2.3 - Create and pub...
Apple iBooks Author helps you create and publish amazing Multi-Touch books for iPad. Now anyone can create stunning iBooks textbooks, cookbooks, history books, picture books, and more for iPad. All... Read more
NeoOffice 2014.12 - 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

Rage of Bahamut is Giving Almost All of...
The App Store isn't what it used to be back in 2012, so it's not unexpected to see some games changing their structures with the times. Now we can add Rage of Bahamut to that list with the recent announcement that the game is severely cutting back... | Read more »
Adventures of Pip (Games)
Adventures of Pip 1.0 Device: iOS iPhone Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: ** ONE WEEK ONLY — 66% OFF! *** “Adventures of Pip is a delightful little platformer full of charm, challenge and impeccable... | Read more »
Divide By Sheep - Tips, Tricks, and Stre...
Who would have thought splitting up sheep could be so involved? Anyone who’s played Divide by Sheep, that’s who! While we’re not about to give you complete solutions to everything (because that’s just cheating), we will happily give you some... | Read more »
NaturalMotion and Zynga Have Started Tea...
An official sequel to 2012's CSR Racing is officially on the way, with Zynga and NaturalMotion releasing a short teaser trailer to get everyone excited. Well, as excited as one can get from a trailer with no gameplay footage, anyway. [Read more] | Read more »
Grab a Friend and Pick up Overkill 3, Be...
Overkill 3 is a pretty enjoyable third-person shooter that was sort of begging for some online multiplayer. Fortunately the begging can stop, because its newest update has added an online co-op mode. [Read more] | Read more »
Scanner Pro's Newest Update Adds Au...
Scanner Pro is one of the most popular document scanning apps on iOS, thanks in no small part to its near-constant updates, I'm sure. Now we're up to update number six, and it adds some pretty handy new features. [Read more] | Read more »
Heroki (Games)
Heroki 1.0 Device: iOS Universal Category: Games Price: $7.99, Version: 1.0 (iTunes) Description: CLEAR THE SKIES FOR A NEW HERO!The peaceful sky village of Levantia is in danger! The dastardly Dr. N. Forchin and his accomplice,... | Read more »
Wars of the Roses (Games)
Wars of the Roses 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: | Read more »
TapMon Battle (Games)
TapMon Battle 1.0 Device: iOS Universal Category: Games Price: $.99, Version: 1.0 (iTunes) Description: It's time to battle!Tap! Tap! Tap! Try tap a egg to hatch a Tapmon!Do a battle with another tapmons using your hatched tapmons! *... | Read more »
Alchemic Dungeons (Games)
Alchemic Dungeons 1.0 Device: iOS Universal Category: Games Price: $.99, Version: 1.0 (iTunes) Description: ### Release Event! ### 2.99$->0.99$ for limited time! ### Roguelike Role Playing Game! ### Alchemic Dungeons is roguelike... | Read more »

Price Scanner via MacPrices.net

Canon PIXMA MG3620 Wireless Inkjet All-in-One...
Canon U.S.A., Inc. has announced the PIXMA MG3620 Wireless (1) Inkjet All-in-One (AIO) printer for high-quality photo and document printing. Built with convenience in mind for the everyday home user... Read more
July 4th Holiday Weekend 13-inch MacBook Pro...
Save up to $150 on the purchase of a new 2015 13″ Retina MacBook Pro at the following resellers this weekend. Shipping is free with each model: 2.7GHz/128GB MSRP $1299 2.7GHz/... Read more
27-inch 3.5GHz 5K iMac on sale for $2149, sav...
Best Buy has the 27″ 3.5GHz 5K iMac on sale for $2149.99. Choose free shipping or free local store pickup (if available). Sale price for online orders only, in-store prices may vary. Their price is $... Read more
Apple now offering refurbished 2015 11-inch...
The Apple Store is now offering Apple Certified Refurbished 2015 11″ MacBook Airs as well as 13″ MacBook Airs (the latest models), available for up to $180 off the cost of new models. An Apple one-... Read more
15-inch 2.5GHz Retina MacBook Pro on sale for...
Amazon.com has the 15″ 2.5GHz Retina MacBook Pro on sale for $2274 including free shipping. Their price is $225 off MSRP, and it’s the lowest price available for this model. Read more
Finally Safe To Upgrade To Yosemite’?
The reason I’ve held back from upgrading my MacBook Air from OS X 10.9 Mavericks to 10.10 Yosemite for nearly a year isn’t just procrastination. Among other bugs reported, there have been persistent... Read more
Logo Pop Free Vector Logo Design App For OS X...
128bit Technologies has released of Logo Pop Free 1.2 for Mac OS X, a vector based, full-fledged, logo design app available exclusively on the Mac App Store for the agreeable price of absolutely free... Read more
21-inch 1.4GHz iMac on sale for $999, save $1...
B&H Photo has new 21″ 1.4GHz iMac on sale for $999 including free shipping plus NY sales tax only. Their price is $100 off MSRP. Best Buy has the 21″ 1.4GHz iMac on sale for $999.99 on their... Read more
16GB iPad mini 3 on sale for $339, save $60
B&H Photo has the 16GB iPad mini 3 WiFi on sale for $339 including free shipping plus NY tax only. Their price is $60 off MSRP. Read more
Save up to $40 on iPad Air 2, NY tax only, fr...
B&H Photo has iPad Air 2s on sale for up to $40 off MSRP including free shipping plus NY sales tax only: - 16GB iPad Air 2 WiFi: $489 $10 off - 64GB iPad Air 2 WiFi: $559 $40 off - 128GB iPad Air... Read more

Jobs Board

Global Deployment Project Manager, *Apple*...
…international landscape is paramount to drive innovation, compliance, competition of Apple 's strengths, and talent planning. Manages the process, logistics, and systems Read more
*Apple* MAC Support Services Subject Matter...
Title: Apple MAC Support Services Subject Matter Expert Location: Pleasanton, CA Type of position: Temporary Contract for approximately 6 weeks Tasks The tasks for the Read more
*Apple* MAC Support Administrator - Net2Sour...
…solutions customized to client needs including staffing, training and technology Title Apple MAC Support Administrator Location Belmont, CA Duration 6+ Month Job Read more
*Apple* Certified Mac Technician - Updated 6...
…and friendly, hands-on technical support to customers troubleshooting and repairing Apple /Mac products with courtesy, speed and skill. Use your problem-solving skills Read more
*Apple* MAC Support Services Subject Matter...
…the best talent to create a competitive advantage. Currently, we are seeking an Apple MAC Support Services Subject Matter Expert for a long term contract in Pleasanton, Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.