TweetFollow Us on Twitter

Appearance-savvy Apps

Volume Number: 14 (1998)
Issue Number: 1
Column Tag: Programmer's Bookshelf

Designing Appearance-savvy Applications

by Avi Rappoport

Using Apple's Mac OS 8 Human Interface Guidelines and the Appearance Manager

This was supposed to be a simple review of the Mac OS 8 Human Interface Guidelines, a Developer Note from Apple. But, while trying to write the review, I ended up tracking down additional issues, such as what, exactly, the "Mac OS 8 Human Interface" refers to, what "Appearance" means, how the Appearance package updates the Control Manager and the Dialog Manager, and how to go about using this information in your design. Here's what I found.

About the Mac OS 8 Human Interface

Mac OS 8 has some fairly radical changes from System 7 automatically propagated throughout all applications which call the standard Toolbox. These changes include a gray-scale look, windows with draggable borders, button-like popup menus, new controls such as progress bars, an explicit Help menu, and more. All common interface elements are now grouped together under the term Appearance, a concept salvaged from Apple's Copland effort. This Appearance concept will allow future Mac OS releases to support switchable themes - unified sets of interface elements, including windows, dialogs, controls and color. When themes are supported, designers will be able to create themes without having to program them. Applications which call Toolbox-standard interface elements will automatically display these new interface elements. This will allow users to customize the look of their desktops, without using extensions or changing any basic functionality.

In the meantime, the new Appearance Manager extends interface elements from the Window, Control, Dialog and Menu Managers. These finally bring Mac Toolbox support for new standard controls, including sliders, progress bars, digital clocks, disclosure triangles and tab panes, as well as menu key command icons and more.

In a striking instance of rationality and clarity, Apple will allow developers to ship this functionality with their applications to run on earlier systems! Appearance 1.0.1, an extension/control panel package, is designed to work with versions of Mac OS from 7.1 through 8.0, and runs on 68K and PowerPC processors. You can use these Gestalt selectors to check for the Appearance Manager:

/* Gestalt selector and values for the Appearance Manager */

enum {
   gestaltAppearanceAttr        = 'appr',
   gestaltAppearanceExists      = 0,
   gestaltAppearanceCompatMode  = 1
};

According to Apple, the Appearance package supports three run-time models: Classic 68K, CFM-68K, and PowerPC CFM. Color QuickDraw is required for Appearance, so it requires a 68020 or better processor. You can download the current Appearance package from Apple's developer site, as described below.

About The Human Interface Guidelines

Back to the design issues and the guidelines: designing the user interface of an application or control panel is not trivial. Designers, and especially programmers working without formal design training, are often confronted with situations where they must present complex information without confusing beginners or annoying expert users. Apple has traditionally provided advice and design information in the Human Interface Guidelines. This has helped interface designers to be consistent in their standard elements and to create good solutions for situations specific to applications. The Mac OS 8 Human Interface Guidelines continue this tradition, describing the changed elements and new features in Mac OS 8, and how to incorporate them in your interface. However, these Guidelines do not include background materials on the theories and principles of interface design: for these, see the earlier Macintosh Human Interface Guidelines.

Showing that Apple "gets it" about web distribution, both the original Human Interface Guidelines and this update (among other documentation) are available free on the Web, in both HTML and Adobe Acrobat PDF format at http://devworld.apple.com/dev/insidemac.shtml.

The Mac OS 8 Human Interface Guidelines is aimed at people designing and implementing interfaces for applications and control panels, so they can make best use of the new features. It includes such specific guidelines as detailed pixel counts of distances between radio buttons, and suggestions for when to use a scrollbar instead of a slider. The writing is clear and concise, and the examples are good - of the high quality we've come to expect from the Inside Macintosh series.

Unfortunately, the reasons for changes in Mac OS 8, such as the removal of the border around dialogs, the new text "Help" menu, changes to the scrollbar arrows and the "affordance" (cursor change to indicate move, copy, alias, etc.) are not described at all. Past versions of the interface guidelines explained more of the theory behind design decisions, which educated interface designers and helped them when they had to create elements not covered by the standard interface. In addition, this book does not provide much to help designers use contextual menus or extended menu key commands.

Therefore, this document is only adequate: it provides the basics but does not go beyond. It does not give enough background, theory and examples to ensure that Mac designers create programs with consistent and appropriate use of new interface elements, and that's a shame.

What Is in the Book

The Mac OS 8 Human Interface Guidelines covers Controls, Dialog Boxes, Menus, Windows, and Control Panels. I'm going to describe it very briefly, as all interface designers and most programmers should just get a copy and read it themselves!

Old Controls Updated

The Control Guidelines chapter describes the changes to the old controls: push buttons, radio buttons, popup menus, list boxes, scrollbars, edit text fields and static text fields. They have all been updated to a more three-dimensional, "modern" look:

Figure 1. New Checkbox Control.

The chapter describes new features, such as "mixed states" for radio buttons and checkboxes (for situations when the selection includes multiple states, such as text with several fonts).

Figure 2. Mixed State Checkbox (with Disclosure Triangle on the left).

One of the nice changes is the new disabled states for selected radio buttons and checkboxes, which fixes one of my pet peeves with the classic look. There's no longer a big black bullet or X in the selected control: the selection indicators are now dimmed as well.

In addition, the text of this chapter has been updated using examples from the real world. My favorite:

Avoid the use of negative labels. A checkbox labeled "Delete read messages" with a default state of off is a clearer choice than a checkbox labeled "Do not delete read messages" defaulting to on.

List Boxes now have built-in arrow key support and focus rings, and there are other similar changes that will make all programmers happy.

New Controls

In addition, the Control Guidelines chapter covers the interface to new controls. These are elements that are useful and helpful and were not included in the previous Control Manager.

The controls are:

Figure 3. Bevel Buttons.

Figure 4. Horizontal Sliders in a Primary Group Box (there's also a Vertical Slider control).

Figure 5. Secondary Group Box.

Figure 6. Digital Clock with Little Arrows.

Figure 7. Disclosure Triangle.

Figure 8. Tabs (and User Panes to go with them!)

Figure 9. Visual Separators (horizontal rule).

Figure 10. Placard control, with the new Scrollbar Arrows and Resize Box.

The new control definition for scroll bars has a variation which supports live scrolling. With a System 7 scroll bar, the user drags a ghost of the scroll box, and the value of the scroll bar changes when the user releases the mouse. With a live scroll bar, the whole scroll box moves, and the value changes as the user drags. You can see this behavior in the Mac OS 8 Finder.

As in the old version, you need a control action procedure to keep up with the changing value of a live scroll bar. But watch out: where the thumb of an old-style scroll bar takes an action procedure with no parameters, a live scroll bar now uses the same action procedure as the other parts of the scroll bar, with parameters.

Figure 11. Help Icon.

And there's more than we can show here.

Dialog & Window Appearance

The Alert section of the Guidelines replaces the previous description of alerts, with full explanation of which version to use and how they will appear. The Dialog Box Guidelines cover such new features as key navigation (using the Tab key to move among edit text fields), and the focus ring, now automatically drawn around the field which will accept the keystrokes.

Figure 12. Focus Ring Around Current Text Field.

The Layout Guidelines provide complete directions for designing standard spacing of the dialog box or window, text in controls, spacing between controls, and even the Help button. These details will allow interface designers to make clean, elegant layouts without having to guess at the proportions. Use them!

The new standard Utility window is designed for palettes and other non-standard windoids. It can have a top or side title area.

These sections do not describe much of the theory behind the changes in these elements, but they have excellent detail for precise layout.

Menus

The Guidelines finally provide the final word on the location of the Preferences menu item: at the bottom of the Edit menu, after a separator. It will be nice to have the Preferences in the same menu locationin all new applications.

In addition, the Appearance package provides a new standard way to accept and display Control, Shift and Option keys as command-key shortcuts. Use these calls instead of third-party MDEFs for best display on future systems. However, this guide does not define a set of standard meanings for these extended command keys. Losing the opportunity to define these standards is a mistake: developers need rules so users can have cross-application consistency.

Contextual menus are another new feature of Mac OS 8, providing context-sensitive menus when the user holds down the Control key and clicks. This guide offers a good, basic description of how they work, but provides none of the theoretical background or design criteria.

Control Panels

This chapter provides new insights into the issues of Control Panel interfaces. It shows what the standard arrangements should be, and gives guidelines and helpful hints on how to deal with exceptions. New information on fonts, menus, and icons, along with expansion and contractions of a details area should help as well.

Multi-Pane Windows

In the context of Control Panels, the Guidelines discuss the four standard ways of displaying multi-pane windows (using the new and helpful user pane toolbox control). They are Tab controls, Buttons, Scrolling list of Icons and Pop-up menus. Unfortunately, my favorite, the disclosure-triangle list used by the CodeWarrior Pro 1 Preferences Window, is not covered. The guide uses four versions of the Appearance control panel to show the strengths and weaknesses of each approach, and provides some suggestions on how to choose between them. This is exactly the kind of practical advice that Apple should be sharing, although it would be nice if they chose one of these options and used it consistently for the system control panels.

More About Mac OS 8 Changes and the Appearance Manager

The new Guidelines do not cover some of the interface changes in Mac OS 8, and you may be wondering how they came about. Here are some tidbits I picked up at the Developer Conference, and from conversations and discussions on the Apple HI Developers mailing list. These notes apply to the Platinum Appearance only: we won't see the real implications of these changes until the Appearance Manager supports multiple Themes.

Why Modal Dialogs Lost Their Borders

In System 7 and earlier, all dialog boxes have thick gray and black 4-pixel borders, but normal windows have a simple black line border, one pixel on the left and top, two pixels on the bottom and right. This changed in Mac OS 8: now windows have the thick molded border and dialogs are almost borderless.

Figure 13. System 7 Alert showing dialog with border.

Figure 14. Mac OS 8 Alert showing borderless dialog.

Figure 15. System 7 Window with thin borders.

Figure 16. OS 8 Window showing thick borders.

The border now signals window draggability - users no longer have to click the title bar to drag, they can drag anywhere. However, users can't drag modal dialogs, so they don't have borders. It's logical but disconcerting, and there's nothing in the new guidelines that explains this.

The Collapse Box

The collapse box in window title bars shows the WindowShade functionality explicitly.

Figure 17. Collapse Box. (On right side of a window without a close box.)

As most designers have figured out, invisible functions are rarely used or remembered - that's a great part of the Mac's success. So, Apple had to create a way for users to know they could collapse a window; the collapse box is the result. As for why the zoom box moved from the outside right corner to leave room for the collapse box: "some windows will not have a zoom box but they will have a collapse box. We thought it was more important to keep the consistency between windows with and without [a] zoom box (the collapse box being always at the same place) than between windows of different versions of the operating system." [-Arno Gourdol, on the Apple HI Developers mailing list].

Active vs. Inactive States

The new appearance shows more distinction between active elements and inactive ones: "One of the design goals of the grayscale appearance was to give better definition for active and inactive states. Active objects are beveled and 'pushable' whereas inactive objects are flat, and blend in with the background." [-Arlo Rose, on the Apple HI Developers mailing list]

Popup Menu Changes

Rather than a square placard with a subtle shadow and a simple black down-arrow, popup menus now look more like buttons. I like this because it tells the user "push me" rather than "look at me".

Figure 18. New Popup Menu Appearance.

In future OS releases, there will be a distinction between pop-up and pull-down menus. "The new pop-up menu has the dual triangles because when you click on it, the content goes both above and below the menu. Sure this may not mean much now, but in an upcoming release, we plan on introducing a pull-down menu control, and we need to have a visual distinction between the two."

"Pop-ups are for changing state... pull-downs are for executing a command. Since you never want to obstruct the title of a pull-down, the menu will have to be anchored to the control, rather than floating above it." [-Arlo Rose, on the Apple HI Developers mailing list]

Scroll Bar Arrow Changes

The scroll bar arrows were changed to up and down pointing triangles from gray arrows for "aesthetic consistency with the visual appearance of the platinum look." [-Arlo Rose, on the Apple HI Developers mailing list]

Help Menu changes

Apple has done a large number of user tests on the Help menu, and finally put the word Help after the last menu on the right for each application. "Our results would consistently show that people just didn't see it where it was. Most users thought that question mark meant that the clock wasn't sure if the time was right. We tried all combinations of location, and symbol, and the only one people 'got' was the word 'Help' at the end of the application menu list. That and the new sticky menu behavior made for a much higher rate of discovery." [-Arlo Rose, on the Apple HI Developers mailing list]

Cursor Affordances

With Mac OS 8, the Finder has a new set of cursors, which provide user feedback on what will happen when they let go of the mouse. For example, an arrow cursor with a + (plus sign) indicates a copy, an arrow cursor with a small right-facing arrow indicates a move, and an arrow cursor with a curved arrow indicates an alias. Although the cursors are included in the Appearance Manager resource file, there are no interface guidelines, or specific functions to enable this behavior automatically within your application.

Writing Appearance-Savvy Apps

To write Appearance-savvy applications, you'll have to avoid nonstandard CDEFs and WDEFs. Most of the old control calls will automatically be routed through the new control manager in the Appearance package, so they will look good even with the new Themes. But any additional controls or window types, such as the Grey Council, will appear as they do in System 7, rather than participating in the systemwide appearance.

The guidelines, however, are not enough. You'll need some of the following tools and sources of information to get started:

Appearance Manager SDK

To get the most current Appearance Manager, with the newest features and bug fixes, download it from Apple's DevWorld site at ftp://devworld.apple.com/MacOS8/.

Application Frameworks

Metrowerks has announced that the PowerPlant Application Framework version in CodeWarrior Pro 2 supports most of the Appearance features. It wraps both new and old OS calls and directs them automatically according to the presence or absence of the Appearance package, so you can just use the classes and ignore the issue entirely. Please note that PowerPlant has not implemented Contextual Menus in the CodeWarrior Pro 2 release, although there are already third-party shareware classes supporting these new features. Warning: if you've written to the old grayscale classes, you'll have to make some major changes to use the new Appearance classes instead.

Apple's MacApp framework may be updated to support the Appearance package, although the status is not clear right now. MacApp uses the AdLib interface library and licenses some of the Grey Council classes. Current information is at http://devtools.apple.com/macapp/.

TCL (Think Class Library) for Symantec C++ seems to be in maintenance mode. I couldn't find any information on support for the Appearance package at http://www.symantec.com/.

Resource Editors

ResEdit's templates do not support the new features added by the Appearance Manager, and there is no indication that Apple will ever do so. Resorcerer version 2 supports the new controls and most of the other Appearance features. It's available from http://www.mathemaesthetics.com/.

Constructor for CodeWarrior Pro 2 will support most of the new controls and other Appearance features. For unsupported controls, you can just add an item, enter its attributes, and it will appear as a gray box in Constructor, but will draw correctly when you compile and run.

Conclusion

The Appearance package contains welcome additions to the Mac interface and will promote consistency across applications as well as saving all developers a great deal of effort. The lack of theoretical information in the Mac OS 8 Human Interface Guidelines is probably due to the new, leaner Apple. But Apple has been known for it's intelligent, intuitive user experience, and the only way to continue to offer consistency and quality to customers is to work with developers. To keep the edge in interface, as we go forward with the Mac OS and Rhapsody, Apple must invest in both research and communications.

Acknowledgments

Thanks to Arlo Rose, Arno Gourdol, Gordon Garb, Quinn, Greg Dow, David Alter and Tom Lippincott for information used in this article.


Avi Rappoport, avirr@well.com, is interested in user experience design (combining interface and functionality), particularly for information retrieval applications. She is a veteran of StarNine, Metrowerks and Niles & Associates.

 
AAPL
$100.86
Apple Inc.
-0.77
MSFT
$46.76
Microsoft Corpora
+0.52
GOOG
$579.95
Google Inc.
+6.85

MacTech Search:
Community Search:

Software Updates via MacUpdate

Capture One Pro 8.0.0.433 - RAW workflow...
Capture One Pro 8 is a professional RAW converter offering you ultimate image quality with accurate colors and incredible detail from more than 300 high-end cameras -- straight out of the box. It... Read more
Adobe Acrobat Pro 11.0.09 - Powerful PDF...
Adobe Acrobat allows users to communicate and collaborate more effectively and securely. Unify a wide range of content in a single organized PDF Portfolio. Collaborate through electronic document... Read more
Adobe Reader 11.0.09 - View PDF document...
Adobe Reader allows users to view PDF documents. You may not know what a PDF file is, but you've probably come across one at some point. PDF files are used by companies and even the IRS to... Read more
iFFmpeg 4.6.1 - Convert multimedia files...
iFFmpeg is a graphical front-end for FFmpeg, a command-line tool used to convert multimedia files between formats. The command line instructions can be very hard to master/understand, so iFFmpeg does... Read more
NTFS 11.3.62 - Provides full read and wr...
Paragon NTFS breaks down the barriers between Windows and OS X. Paragon NTFS effectively solves the communication problems between the Mac system and NTFS, providing full read and write access to... Read more
OS X Yosemite 10.10 DP8 - Developer Prev...
Note: This is a Developer Preview. You must be a registered Apple Mac Developer to download this update. You can also sign up for the free OS X Beta Program to download and preview public beta... Read more
FotoMagico 4.5 - 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
Screenshot Path 1.2.1 - Change the defau...
Screenshot Path lets you change the folder where OS X saves screenshots. Screenshots are saved by default to the user’s desktop. This is handy for the occasional screenshot but those looking to take... Read more
Fantastical 1.3.16 - Create calendar eve...
Fantastical is the Mac calendar you'll actually enjoy using. Creating an event with Fantastical is quick, easy, and fun: Open Fantastical with a single click or keystroke Type in your event details... Read more
GIMP 2.8.14 - Powerful, free image editi...
GIMP is a multi-platform photo manipulation tool. GIMP is an acronym for GNU Image Manipulation Program. The GIMP is suitable for a variety of image manipulation tasks, including photo retouching,... Read more

Latest Forum Discussions

See All

Zynga Unveils First Look at Looney Tunes...
Zynga Unveils First Look at Looney Tunes Dash! Posted by Ellis Spice on September 16th, 2014 [ permalink ] Be vewy, vewy qwiet. I’m hunting wunners featuwing wabbits, and luckily, it’s duck season wunner season. | Read more »
Guardians on the Go – How to Connect to...
At this point I’m relatively certain most of the country is familiar with Destiny. And for those looking to augment their game a bit, Bungie has changed their Bungie Mobile Companion App to Destiny Companion. | Read more »
Kunin Review
Kunin Review By Jordan Minor on September 16th, 2014 Our Rating: :: SHURIKEN DO ITUniversal App - Designed for iPhone and iPad Kunin is a nervous test of ninja reflexes.   Developer: Dodreams Price: FREE Version Reviewed: 1.0.1... | Read more »
4 KEMCO Titles are Just $0.99 for a Limi...
4 KEMCO Titles are Just $0.99 for a Limited Time Posted by Jessica Fisher on September 16th, 2014 [ permalink ] KEMCO RPGs Destiny Fantasia, Infinite Dunamis, Bonds of the Sk | Read more »
Introducing Flash, the Latest Wearable F...
Introducing Flash, the Latest Wearable Fitness Monitor from Misfit Posted by Jessica Fisher on September 16th, 2014 [ permalink ] The Misfit Flash is the newly-released fitness and sleep monitor from | Read more »
Hyper Trip Review
Hyper Trip Review By Jennifer Allen on September 16th, 2014 Our Rating: :: HYPER TWITCHYUniversal App - Designed for iPhone and iPad Tough and unforgiving, Hyper Trip is a bit like Snake – if Snake was really harsh.   | Read more »
Collectible Card Game Earthcore: Shatter...
Collectible Card Game Earthcore: Shattered Elements is Set to Arrive on iOS in 2015 Posted by Ellis Spice on September 16th, 2014 [ permalink ] Polish developers | Read more »
Boogey Boy Review
Boogey Boy Review By Jennifer Allen on September 16th, 2014 Our Rating: :: PRETTY BUT BASICUniversal App - Designed for iPhone and iPad It looks delightful but lack of Game Center support and more variety really affects the fun... | Read more »
Vizzywig 4K (Photography)
Vizzywig 4K 1.0 Device: iOS iPhone Category: Photography Price: $999.99, Version: 1.0 (iTunes) Description: REQUIRES: iOS 7 on iPhone 5S with 32GB or 64GB. (Do not use iOS 8)The world's FIRST mobile 4K video capture, editing and... | Read more »
The Sleeping Prince Review
The Sleeping Prince Review By Jennifer Allen on September 15th, 2014 Our Rating: :: RESTRICTIVE KINGDOM SAVINGUniversal App - Designed for iPhone and iPad The Sleeping Prince looks and feels great to play, but its lack of peril and... | Read more »

Price Scanner via MacPrices.net

Sprint offers 16GB iPad mini for $199.99 with...
Sprint is offering 1st generation 16GB iPad minis for $199.99 with a 2-year service agreement. Standard MSRP for this iPad is $429. Their price is the lowest available for this model. Read more
2.5GHz Mac mini remains on sale for $549, sav...
B&H Photo has the 2.5GHz Mac mini on sale for $549.99 including free shipping. That’s $50 off MSRP, and B&H will also include a free copy of Parallels Desktop software. NY sales tax only. Read more
Apple refurbished iMacs available for up to $...
The Apple Store has Apple Certified Refurbished iMacs available for up to $300 off the cost of new models. Apple’s one-year warranty is standard, and shipping is free. These are the best prices on... Read more
13″ 2.5GHz MacBook Pro offered for $100 off M...
B&H Photo has the 13″ 2.5GHz MacBook Pro on sale for $999.99 including free shipping plus NY sales tax only. Their price is $100 off MSRP. Read more
Free GIMP Professional Grade Graphics App Ver...
The latest 2.8.14 version of the oddly-named GIMP (acronym for: GNU Image Manipulation Program) open source, high-end image editing and creation alternative to Adobe’s Photoshop and refuge from... Read more
Apple Announces Record Pre-orders for iPhone...
Apple has released metrics showing a record number of first day pre-orders of iPhone 6 and iPhone 6 Plus, with over four million sold in the first 24 hours. Demand for the new iPhones exceeds the... Read more
10% off iPhone 6 and 6 Plus Otterbox cases
Get 10% off on popular Otterbox iPhone 6 and iPhone 6 Plus cases at MacMall through September 19th. Use code OTTERBOX10 to see the discount. Read more
15-inch MacBook Pros on sale for up to $125 o...
Amazon has the new 2014 15″ Retina MacBook Pros on sale for up to $125 off MSRP including free shipping: - 15″ 2.2GHz Retina MacBook Pro: $1899.99 save $100 - 15″ 2.5GHz Retina MacBook Pro: $2374... Read more
27-inch 3.2GHz iMac on sale for $1698, $101 o...
Abt has the 27″ 3.2GHz iMac on sale for $1698 including free shipping. Their price is $101 off MSRP. Read more
More To Making A Larger iPad Than Expanded Sc...
CNET’s Ross Rubin has posted a thoughtful analysis of prospects for a larger display iPad Pro, noting that Microsoft and Samsung currently have the large-display touchscreen tablet category to... 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
*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
*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.