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

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.


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

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

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

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

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.


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.


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

Avi Rappoport,, 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.


Community Search:
MacTech Search:

Software Updates via MacUpdate

Garmin Express - Manage your Gar...
Garmin Express is your essential tool for managing your Garmin devices. Update maps, golf courses and device software. You can even register your device. Update maps Update software Register your... Read more
Duet - Use your iPad as an exter...
Duet is the first app that allows you to use your iDevice as an extra display for your Mac using the Lightning or 30-pin cable. Note: This app requires a $14.99 iOS companion app. Version Read more
Apple iTunes 12.5.2 - Play Apple Music a...
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
Pinegrow Web Designer 2.95 - Mockup and...
Pinegrow Web Designer is desktop app that lets you mockup and design webpages faster with multi-page editing, CSS and LESS styling, and smart components for Bootstrap, Foundation, Angular JS, and... Read more
jAlbum Pro 13.6 - Organize your digital...
jAlbum Pro has all the features you love in jAlbum, but comes with a commercial license. You can create gorgeous custom photo galleries for the Web without writing a line of code! Beginner-friendly... Read more
jAlbum 13.6 - 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
TextMate 2.0-beta.12.26 - Code/markup ed...
TextMate is a versatile plain text editor with a unique and innovative feature set which caused it to win an Apple Design Award for Best Mac OS X Developer Tool in August 2006. A rapidly growing... Read more
VMware Fusion 8.5.1 - Run Windows apps a...
VMware Fusion 8 and Fusion 8 Pro--the latest versions of its virtualization software for running Windows on a Mac without rebooting--include full support for Windows 10, OS X El Capitan, and the... Read more
Apple Final Cut Pro X 10.3 - Professiona...
Apple Final Cut Pro X is a professional video editing solution.Completely redesigned from the ground up, Final Cut Pro adds extraordinary speed, quality, and flexibility to every part of the post-... Read more
Civilization VI 1.0.0 - Next iteration o...
Sid Meier’s Civilization VI is the next entry in the popular Civilization franchise. Originally created by legendary game designer Sid Meier, Civilization is a strategy game in which you attempt to... Read more

Latest Forum Discussions

See All

Plants vs. Zombies Heroes guide: How to...
Plants vs. Zombies Heroes might look cute and cuddly, but it's actually a very complex deck builder that requires a lot of time to master. While there's a bit of a learning curve, it's easy for people of any skill level to have fun with the game. | Read more »
Roofbot: Puzzler On The Roof (Games)
Roofbot: Puzzler On The Roof 1.0.2 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0.2 (iTunes) Description: Guide Roofie through gorgeous, meditative rooftops and try to get the right color energy balls into the... | Read more »
The 4 best food delivery apps
As the temperatures continue to drop, so does the motivation to venture outside. Sometimes you still want to eat a nice meal from that sushi place down the road though. Thankfully in these trying times, there are a number of fine food delivery... | Read more »
Toca Life: Farm (Education)
Toca Life: Farm 1.0 Device: iOS Universal Category: Education Price: $2.99, Version: 1.0 (iTunes) Description: Work and play the farmer's way! Milk your cow, gather eggs from your hens and raise your crops. Have a picnic, play the... | Read more »
The Lost Shield (Games)
The Lost Shield 1.0.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0.0 (iTunes) Description: The Lost shield is a brick break/adventure game. You play as a hero who must return a powerful but dangerous magic shield... | Read more »
The Forgotten Room (Games)
The Forgotten Room 1.0.1 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0.1 (iTunes) Description: Play as paranormal investigator John “Buster of Ghosts” Murr as he explores yet another mysteriously creepy house. This... | Read more »
5 Halloween mobile games for wimps
If you're anything like me, horror games are a great way to have nightly nightmares for the next decade or three. They're off limits, but perhaps you want to get in on the Halloween celebrations in some way. Fortunately not all Halloween themed... | Read more »
The 5 scariest mobile games
It's the most wonderful time of the year for people who enjoy scaring themselves silly with haunted houses, movies, video games, and what have you. Mobile might not be the first platform you'd turn to for quality scares, but rest assured there are... | Read more »
Lifeline: Flatline (Games)
Lifeline: Flatline 1.0.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0.0 (iTunes) Description: The Lifeline series takes a terrifying turn in this interactive horror experience. Every decision you make could help... | Read more »
Game of Dice is now available on Faceboo...
After celebrating its anniversary in style with a brand new update, there’s even more excitement in store for Game of Dice has after just being launched on Facebook Gameroom. A relatively new platform, Facebook Gameroom has been designed for PC... | Read more »

Price Scanner via

WaterField Unveils Syde MacBook Pro Touch Bar...
The new WaterField Designs Syde Case for Apple’s new MacBook Pro Touch Bar combines the top-notch laptop protection of a sleeve with the functionality and handsome look of an over-the-shoulder or... Read more
Apple Unveils Redesigned MacBook Pro With Tou...
October 27, 2016 – Apple today introduced the thinnest and lightest MacBook Pro yet, along with a new interface innovation that replaces the traditional row of function keys with a Retina-quality... Read more
Apple Unveils New TV App for Apple TV, iPhone...
October 27, 2016 – Apple today introduced a new TV app, offering a unified experience for discovering and accessing TV shows and movies from multiple apps on Apple TV, iPhone and iPad. The TV app... Read more
Price drops on select refurbished 2015 13″ Re...
Apple dropped prices on select Certified Refurbished 2015 13″ Retina MacBook Pros by as much as $90. An Apple one-year warranty is included with each model, and shipping is free: - 13″ 2.7GHz/256GB... Read more
Apple reveals new next-generation 15″ and 13″...
Apple today revealed their next-generation 15″ and 13″ MacBook Pros. The new models are thinner and lighter than before with a new aluminum design featuring an enhanced keyboard with retina, multi-... Read more
Worldwide Smartphone Shipments Up 1.0% Year o...
According to preliminary results from the International Data Corporation (IDC) Worldwide Quarterly Mobile Phone Tracker, vendors shipped a total of 362.9 million smartphones worldwide in the third... Read more
TuneBand Arm Band For iPhone 7 and 7 Plus Rel...
Grantwood Technology has added the TuneBand for iPhone 7 and 7 Plus to its smartphone armband series. The TuneBand provides a lightweight and comfortable way to wear the iPhone while running,... Read more
1.4GHz Mac mini on sale for $449, save $50
Adorama has the 1.4GHz Mac mini on sale for $50 off MSRP including free shipping plus NY & NJ sales tax only: - 1.4GHz Mac mini (Apple sku# MGEM2LL/A): $449 $50 off MSRP To purchase a mini at... Read more
21-inch 1.6GHz iMac on sale for $999, save $1...
B&H has the 21″ 1.6GHz Apple iMac on sale for $999 including free shipping plus NY sales tax only. Their price is $100 off MSRP. Read more
Macs’ Superior Enterprise Deployment Cost Eco...
IBM’s debunking of conventional wisdom and popular mythology about the relative cost of using Apple Mac computers as opposed to PCs running Microsoft Windows at the sixth annual Jamf Nation User... Read more

Jobs Board

*Apple* Retail - Multiple Positions (US) - A...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
Lead *Apple* Solutions Consultant - Apple (...
# Lead Apple Solutions Consultant Job Number: 52812906 Houston, Texas, United States Posted: Oct. 18, 2016 Weekly Hours: 40.00 **Job Summary** The Lead ASC is an Read more
*Apple* Solutions Consultant - Apple (United...
# Apple Solutions Consultant Job Number: 52812872 Houston, Texas, United States Posted: Oct. 18, 2016 Weekly Hours: 40.00 **Job Summary** As an Apple Solutions 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
Software Engineering Intern: UI Applications...
Job Summary Apple is currently seeking enthusiastic interns who can work full-time for a minimum of 12-weeks between Fall 2015 and Summer 2016. Our software Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.