TweetFollow Us on Twitter

November 93 - TDialogBehaviors

TDialogBehaviors

Bob Hablutzel

This article is the first article in what I hope will be a regular series of technical questions and answers on object oriented programming. The intent of this column is to go beyond simple answers. I intend to take a question, answer it, and then use that question as a springboard to a more general discussion on programming. I hope you find the results interesting.

The first articles will be culled from frequently asked questions on MacApp3Tech$, but I need your questions! I can be reached electronically at AppleLink: B.HABLUTZEL; by telephone at 708.328.0130; or by post at Bob Hablutzel, Hablutzel Consulting, 606 Asbury, Evanston, IL, USA 60202.

Q: I need to create a modal dialog using MacApp 3.0. I create the dialog using ViewEdit, but when I attempt to pose the dialog it opens briefly and immediately closes. How can I create a modal dialog?

A: Modal dialogs in MacApp 3.0 are handled with a TDialogBehavior, which is attached to the dialog window. This behavior is responsible for receiving and handling keystrokes, looking for keystrokes that dismiss the dialog, and sending events off to the appropriate control.

The problem with ViewEdit (in this case) is that it does not attach a TDialogBehavior to the dialog when it is created. When TWindow::PoseModally() is called, the first thing it does is attempt to locate the dialog behavior; if this lookup fails it closes the window and returns immediately (returning kNoIdentifier as the dismisser).

There are a few work-arounds for this. In ViewEdit, you can add a TDialogView to the window. TDialogView is really not required in MacApp 3.0; it is a holdover from the old mechanisms in MacApp 2.0. However, if there is one in the window, it will cause the TDialogBehavior to be added when the window is opened.

Alternatively, you can create the TDialogBehavior yourself, and attach it to the window before the TWindow::PoseModally() method is called. When you create the dialog behavior, you have to supply the identifiers for the default and cancel items (in the call to IDialogBehavior()). Once this behavior is added to the window, TWindow::PoseModally() can be called.

You can also call TWindow::SetModality() before calling TWindow::PoseModally(). This method will create the dialog behavior if none exists. However, this routine may not properly set up the default and cancel identifiers; you would then have to call TWindow::GetDialogBehavior() to retrieve the dialog, and stuff the identifiers into its fCancelItem and fDefaultItem fields.

Even if you do all of this, the dialog will still not dismiss properly unless you change the default event for the dismissing control to mDismiss (==34). So if you use ViewEdit to create the dialog, you need to change the event number for the control by hand. If you leave the control at its default event number (mButton for TButtons), the control will activate, but the dialog will not dismiss.

Finally, the best solution is to avoid using ViewEdit. Either AdLib or IcePick (3.0) will add the dialog behavior to the window when you use them to create the dialog. Using either of these products will ensure that the dialog has the appropriate behavior. These programs will also take care of changing the event number for the dismissing controls to mDismiss for you. (Both these applications are available from MADA).

More About TDialogBehavior

It is somewhat interesting to notice the actual mechanism used to handle the dismissing of the modal dialogs. The TDialogBehavior does not in itself dismiss the dialog, which as we will see in a second has some interesting implications. The TDialogBehavior simply activates the control that is designated as the default (or cancel) item. It does this by sending the control its default event number. The control then accepts the event, reacts appropriately (in the case of a TButton, it flashes), and sends the event up the event chain.

The event eventually reaches the TDialogBehavior attached to the window, which checks the see if the event is mDismiss. Notice that this is the first time that the behavior checks the event type. If the event is mDismiss, the behavior records the identifier of the source of the event in the fDismisser field, and ends the modal posing. TWindow::PoseModally(), which started the modal posing in the first place, retrieves the value of the TDialogBehavior::fDismisser field, and returns that as the result of the modal posing.

What is interesting about all this is that TDialogBehavior does not necessarily have to be used with modal dialogs; it can be used with modeless dialogs just as easily. When the return key is struck, for example, the default item will be invoked. If you attach a behavior to the default control that intercepts that control's default event number, you can quickly and easily create modeless dialogs that contain default (and closing) items.

Take, for example, a drawing application that supports 1° rotations. A modeless dialog could be created that presents the user with the number of degrees of rotation, and a default Rotate button. Every time the user strikes the return key, the Rotate button would be activated. You could attach a behavior to the Rotate button that checks for events where (a) the source of the event is the owner of the behavior, and (b) the event number matches the default event number (fEventNumber) of the owner. When it receives an event that matches this criteria, it would create whatever command was responsible for the rotation of the object, and post it to the application.

The question of where to attach the behavior is an interesting one. The behavior can be attached anywhere in the event chain and still function properly. It is mostly a question of style to decide where the behavior best fits.

For example, if the behavior is attached to the button itself, it will clearly get the event that the button generates. However, if the button does not handle the event, it will pass the event up the event chain; for views this means that the superview will receive the event. This passing along continues through each respective superview until someone handles the event, the TWindow used to draw the dialog will get the event eventually, provided no-one else has handled it.

In the example above, there are two ways of designing the interface. If the TNumberText used to hold the rotation amount is just a generic TNumberText, then it would make sense to have the behavior attached to the dialog. This would allow the dialog access to a child view to retrieve the rotation amount. (If the behavior were attached to the button, it would have to access a sibling view to retrieve the rotation amount; there is nothing actually wrong with this but it forces the dialog to have additional information about its environment, which will limit its overall reusability).

However, if the TNumberText holding the rotation amount where overridden to set a value in the application (fRotationAmount, e.g.) when stopping editing, then the behavior could be attached to the button. In this case, the button would be set to want to become the target of the view. When the user clicks this button, the TNumberText would resign its target, which would cause it to stop editing, which in turn would cause it to update the application value. The button would then be free to post a command using this value.

Finally, we can take this one step further, and change the default event number of the button from mButtonHit to some application defined event (mRotate, e.g. ). We could then attach a behavior to the application that looks for the mRotate event and creates the appropriate command. This would allow us the flexibility of generating the mRotate command in multiple places in our interface, and handling them all identically. (Remember that the dialog we are discussing is modeless; this would not work in a modal dialog as it requires the event number of the default button to be mDismiss).

Once you understand how they function, TDialogBehaviors provide a simple, generic means of handling a common user interface problem. By carefully using them in cooperation with other built-in mechanisms, powerful interfaces can be designed with a minimum of coding. They can be used with modeless as well as modal dialogs, giving you complete freedom in designing your interface.

 
AAPL
$100.96
Apple Inc.
-0.83
MSFT
$47.52
Microsoft Corpora
+0.84
GOOG
$596.08
Google Inc.
+6.81

MacTech Search:
Community Search:

Software Updates via MacUpdate

Airfoil 4.8.9 - Send audio from any app...
Airfoil allows you to send any audio to AirPort Express units, Apple TVs, and even other Macs and PCs, all in sync! It's your audio - everywhere. With Airfoil you can take audio from any... Read more
WhatRoute 1.13.0 - Geographically trace...
WhatRoute is designed to find the names of all the routers an IP packet passes through on its way from your Mac to a destination host. It also measures the round-trip time from your Mac to the... Read more
Chromium 37.0.2062.122 - 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. FreeSMUG-Free OpenSource Mac User Group build is... Read more
Attachment Tamer 3.1.14b9 - Take control...
Attachment Tamer gives you control over attachment handling in Apple Mail. It fixes the most annoying Apple Mail flaws, ensures compatibility with other email software, and allows you to set up how... Read more
Duplicate Annihilator 5.0 - Find and del...
Duplicate Annihilator takes on the time-consuming task of comparing the images in your iPhoto library using effective algorithms to make sure that no duplicate escapes. Duplicate Annihilator detects... Read more
jAlbum Pro 12.2 - Organize your digital...
jAlbum Pro has all the features you love in jAlbum, but comes with a commercial license. With jAlbum, you can create gorgeous custom photo galleries for the Web without writing a line of code!... Read more
jAlbum 12.2 - Create custom photo galler...
With jAlbum, you can create gorgeous custom photo galleries for the Web without writing a line of code! Beginner-friendly, with pro results Simply drag and drop photos into groups, choose a design... Read more
Quicken 2015 2.0.4 - Complete personal f...
Quicken 2015 helps you manage all your personal finances in one place, so you can see where you're spending and where you can save. Quicken automatically categorizes your financial transactions,... Read more
iMazing 1.0 - Complete iOS device manage...
iMazing (formerly DiskAid) is the ultimate iOS device manager with capabilities far beyond what iTunes offers. With iMazing and your iOS device (iPhone, iPad, or iPod), you can: Copy music to and... Read more
Xcode 6.0.1 - Integrated development env...
Apple Xcode is Apple Computer's integrated development environment (IDE) for OS X. The full Xcode package is free to ADC members and includes all the tools you need to create, debug, and optimize... Read more

Latest Forum Discussions

See All

View Source – HTML, JavaScript and CSS...
View Source – HTML, JavaScript and CSS 1.0 Device: iOS Universal Category: Utilities Price: $.99, Version: 1.0 (iTunes) Description: View Source is an app plus an iOS 8 Safari extension that makes it easy to do one key web developer... | Read more »
Avenged Sevenfold’s Hail To The King: De...
Avenged Sevenfold’s Hail To The King: Deathbat is Coming to iOS on October 16th Posted by Jessica Fisher on September 19th, 2014 [ permalink ] Just in time for Halloween, on October 16 Avenged Sevenfold will be launching | Read more »
Talisman Has Gone Universal – Can Now be...
Talisman Has Gone Universal – Can Now be Played on the iPhone Posted by Jessica Fisher on September 19th, 2014 [ permalink ] | Read more »
Tap Army Review
Tap Army Review By Jennifer Allen on September 19th, 2014 Our Rating: :: SHOOT EM ALLUniversal App - Designed for iPhone and iPad Mindless but fun, Tap Army is a lane-based shooter that should help you relieve some stress.   | Read more »
Monsters! Volcanoes! Loot! Epic Island f...
Monsters! Volcanoes! Loot! | Read more »
Plunder Pirates: Tips, Tricks, Strategie...
Ahoy There, Seadogs: Interested in knowing our thoughts on all this plundering and pirating? Check out our Plunder Pirates Review! Have you just downloaded the rather enjoyable pirate-em-up Plunder Pirates and are in need of some assistance? Never... | Read more »
Goat Simulator Review
Goat Simulator Review By Lee Hamlet on September 19th, 2014 Our Rating: :: THE GRUFFEST OF BILLY GOATSUniversal App - Designed for iPhone and iPad Unleash chaos as a grumpy goat in this humorous but short-lived casual game.   | Read more »
A New and Improved Wunderlist is Here fo...
A New and Improved Wunderlist is Here for iOS 8 Posted by Jessica Fisher on September 19th, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
Evernote Update for iOS 8 Adds Web Clipp...
Evernote Update for iOS 8 Adds Web Clipping, Quick Notes, and More Posted by Ellis Spice on September 19th, 2014 [ permalink ] | Read more »
Apple Names Ultimate Productivity Bundl...
Apple Names Ultimate Productivity Bundle by Readdle as the Essential Bundle on the App Store Posted by Jessica Fisher on September 19th, 2014 [ permalink | Read more »

Price Scanner via MacPrices.net

Updated Price Trackers
We’ve updated our Mac Price Trackers with the latest information on prices, bundles, and availability on systems from Apple’s authorized internet/catalog resellers: - 15″ MacBook Pros - 13″ MacBook... Read more
Mac Pros available for up to $260 off MSRP
Adorama has Mac Pros on sale for up to $260 off MSRP. Shipping is free, and Adorama charges sales tax in NY & NJ only: - 4-core Mac Pro: $2839.99, $160 off MSRP - 6-core Mac Pro: $3739.99, $260... Read more
13-inch 2.6GHz/256GB Retina MacBook Pros avai...
B&H Photo has the 13″ 2.6GHz/256GB Retina MacBook Pro on sale for $1379 including free shipping plus NY sales tax only. Their price is $120 off MSRP. Read more
Previous-generation 15-inch 2.0GHz Retina Mac...
B&H Photo has leftover previous-generation 15″ 2.0GHz Retina MacBook Pros now available for $1599 including free shipping plus NY sales tax only. Their price is $400 off original MSRP. B&H... Read more
21″ 2.7GHz iMac available for $1179, save $12...
Adorama has 21″ 2.7GHz Hawell iMacs on sale for $1179.99 including free shipping. Their price is $120 off MSRP. NY and NJ sales tax only. Read more
iOS 8 Adoption Rate Slower than iOS 7, 6, Hit...
Apple began pushing out iOS 8 updates to eligible devices around 1pm ET on September 17, 2014. However, unlike with iOS 7, which boasted a wide variety of differences from its predecessor iOS 6, in... Read more
LIkely Final Definitive OS X 10.9.5 Mavericks...
Apple has released what will almost certainly be the last incremental version number update of OS X 10.9 Mavericks (save for futire security updates) before OS X 10.10 Yosemite is released next month... Read more
Fingerprints, Apple Pay and Identity Theft Wa...
On Sep 9th, CEO Tim Cook unveiled Apple Pay, along with the new iPhone 6 and iWatch. Apple Pay is a newly developed technology that utilizes a near field communication (NFC) to enable customer... Read more
Amazon Introduces Two All-New Kindles
Amazon on Thursday introduced the 7th generation of its Kindle dedicated e-reader device: Kindle Voyage, its top-of-the-line e-reader, and the new $79 Kindle, with a 20% faster processor, twice the... Read more
Save up to $300 on the price of a new Mac wit...
Purchase a new Mac or iPad at The Apple Store for Education and take up to $300 off MSRP. All teachers, students, and staff of any educational institution qualify for the discount. Shipping is free,... Read more

Jobs Board

*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
Project Manager, *Apple* Financial Services...
**Job Summary** Apple Financial Services (AFS) offers consumers, businesses and educational institutions ways to finance Apple purchases. We work with national and 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
*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
*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
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.