---

Introduction to Status Bars

Contents:

Organization of This Document

Status bars display a collection of status items that provide interaction with or feedback to the user, such as a menu or an image reflecting an application’s state. A system-wide status bar resides at the right side of the menu bar and is the only status bar currently available.

Organization of This Document

Use status items sparingly and only if the alternatives (such as a Dock menu, preference pane, or status window) are not suitable. Because there is limited space in the menu bar in which to display status items, status items are not guaranteed to be available at all times. For this reason, do not rely on them being available and always provide a user preference for hiding your application’s status items to free up space in the menu bar.

For more information on when to use the status bar, see Aqua Human Interface Guidelines.

The capabilities of status bars are discussed in “About Status Bars.” Sample code and a discussion of how to create status items are in “Creating Status Items.”

---