< Previous PageNext Page > Hide TOC

Techniques for Toolbar Management

You can determine the height of a toolbar and whether it has overflow items by following the procedures described below.

Contents:

Determining if a Toolbar Has Overflow Items
Calculating a Toolbar’s Height


Determining if a Toolbar Has Overflow Items

If a toolbar is unable to display all the user's currently configured toolbar items, it pushes the additional items into the overflow menu and displays the overflow menu icon as shown in Figure 1.


Figure 1  A toolbar indicating items in the overflow menu

A toolbar indicating items in the overflow menu

An application can determine if a toolbar has overflow items by comparing the number of items returned by the method items with the number of items returned by the visibleItems method as shown in Listing 1. If these values differ, then the toolbar has items in the overflow menu.

Listing 1  Example code to test if a toolbar has overflow items

int numberOfItems=[[theToolbar items] count];
int numberOfVisibleItems=[[theToolbar visibleItems] count];
 
if (numberOfItems != numberOfVisibleItems) {
    // toolbar has overflow items
}

Calculating a Toolbar’s Height

Although NSToolbar does not currently provide a method for returning a toolbar’s height, it is easy to compute that value. You subtract the height of the window’s content view from the window’s height.

The Objective-C function in Listing 2 calculates the height of the toolbar in a window, returning 0 if the toolbar is hidden.

Listing 2  Objective-C function to calculate toolbar height

float ToolbarHeightForWindow(NSWindow *window)
{
    NSToolbar *toolbar;
    float toolbarHeight = 0.0;
    NSRect windowFrame;
 
    toolbar = [window toolbar];
 
    if(toolbar && [toolbar isVisible])
    {
        windowFrame = [NSWindow contentRectForFrameRect:[window frame]
                                styleMask:[window styleMask]];
        toolbarHeight = NSHeight(windowFrame)
                        - NSHeight([[window contentView] frame]);
    }
 
    return toolbarHeight;
}


< Previous PageNext Page > Hide TOC


© 2002, 2009 Apple Inc. All Rights Reserved. (Last updated: 2009-02-04)


Did this document help you?
Yes: Tell us what works for you.
It’s good, but: Report typos, inaccuracies, and so forth.
It wasn’t helpful: Tell us what would have helped.