A toolbar contains a series of elements, represented by icons, which act as buttons. Each element typically represents a menu command. After you click the element, the IDE executes the associated menu command. The toolbar can also contain elements that execute actions other than menu commands. Figure 8.37 (Windows) and Figure 8.38 (Mac OS, Solaris, and Linux) show the toolbar in the Project window.

This section discusses the following topics:

• Kinds of toolbars
• Toolbar elements
• Showing and hiding a toolbar
• Modifying a toolbar
• Restoring a toolbar to default settings
• Anchoring the floating toolbar (Mac OS, Solaris, and Linux)

There are two types of toolbars in the IDE:

• the floating toolbar (also known as the global toolbar or the main toolbar) that you can use at all times
• toolbars that appear in particular windows, such as the Project window toolbar and the Browser window toolbar

Your changes to one of these toolbar types apply to every instance of that toolbar type subsequently created. For example, if you modify the toolbar in an editor window, your changes appear in all editor windows opened thereafter. For more information, see "Modifying a toolbar."

Each of the toolbars has a default configuration of elements that you can restore at any time. For more information, see "Restoring a toolbar to default settings."

After you choose a menu command related to a window toolbar, the command affects the toolbar in the active window. For more information, see "Toolbar Submenu."

A toolbar can contain the following types of elements.:

• Commands-buttons that execute IDE menu commands when clicked
• Controls-IDE pop-up menus (Document Settings, Functions, Header Files, Markers, and Version Control), and the Current Target pop-up menu
• Miscellaneous -other elements, such as the File Dirty Indicator and File Path field
• Scripts (Mac OS)-buttons that execute one of the scripts available through the Scripts menu in the IDE.

Use the commands in the Toolbar Submenu to show or hide a toolbar. Hiding a toolbar does not change the toolbar's configuration of elements.

This section discusses the following toolbar types:

• Main toolbar (Windows)
• Floating toolbar (Mac OS, Solaris, and Linux)
• Window toolbar

To display the main toolbar, choose View > Toolbars > Show Main Toolbar. To hide the main toolbar, choose View > Toolbars > Hide Main Toolbar. See "Restoring a toolbar to default settings" for more information.

To display the floating toolbar, choose Window > Toolbar > Show Floating Toolbar. To hide the floating toolbar, choose Window > Toolbar > Hide Floating Toolbar. See "Restoring a toolbar to default settings" and "Anchoring the floating toolbar (Mac OS, Solaris, and Linux)" for more information.

To hide an active window's toolbar, choose Hide Window Toolbar from the Toolbar Submenu. The other components of the window shift to fill the space previously occupied by the window's toolbar. All subsequently opened windows of that type will have hidden toolbars.

To display an active window's hidden toolbar, choose Show Window Toolbar from the Toolbar Submenu. The other components of the window shift to allow room for the window's toolbar. All subsequently opened windows of that type will display toolbars.

After you hide the editor window toolbar, the default toolbar elements appear in smaller form along the bottom of the editor window, as shown in Figure 8.40. When you show the toolbar again, the tools reappear along the top of the editor window, as shown in Figure 5.1.

You can also show or hide the editor window toolbar with the Toolbar Disclosure button. For more information, refer to "Seeing Window Controls."

You can modify a toolbar in the following ways:

• Adding a toolbar element
• Removing a toolbar element (Windows)
• Removing all toolbar elements

After you modify a toolbar, the changes apply to every instance of that toolbar subsequently created. For example, if you customize the Project window toolbar, those changes will affect every Project window that you open, not just the toolbar in the active Project window. Windows that are already open are not affected.

You add an element to a toolbar by dragging and dropping it from the Toolbar Items list onto a toolbar. This list is part of the Toolbar Items view in the Customize IDE Commands window.

To add an element to a toolbar, follow these steps:

1. From the Toolbar Items list, select the element that you want to add to a toolbar.

Ensure that the destination toolbar is visible.

2. Drag the element's icon from the Toolbar Items list to the destination toolbar.

On the Windows-hosted IDE, if the destination toolbar accepts the element, a framing bracket appears in the toolbar. This framing bracket shows you where the new element will appear after you release the cursor. If the destination toolbar does not accept the element, the framing bracket does not appear.

3. Release the element at the desired position.

After release, the IDE inserts the element in the destination toolbar.

The toolbar might not accept an element for the following reasons:

• The toolbar is full.
• The element already exists in the toolbar.
• You cannot use the desired element in the toolbar because the window does not support that element.
• You cannot add the following elements to any toolbar except the editor window toolbar: Document Settings, Functions, Header Files, Markers, and Version Control pop-up menus; File Dirty Indicator; and File Path field.
• You cannot add the Current Target pop-up menu element to any toolbar except the Project window toolbar.

To remove an element from a toolbar, right-click the element and choose Remove Toolbar Item from the contextual menu that appears. The IDE removes the element from the toolbar.

You can clear all elements from a toolbar and build your own toolbar from scratch. Table 8.2 shows how to clear the floating toolbar and window toolbars.

To clear the	Windows	Mac OS, Solaris, and Linux
main toolbar	Choose View > Toolbars > Clear Main Toolbar	Choose Window > Toolbar > Clear Floating Toolbar
window toolbar	Choose View > Toolbars > Clear Window Toolbar	Choose Window > Toolbar > Clear Window Toolbar

In some cases, the IDE might not remove certain elements after you choose the Clear Window Toolbar command. The elements that the IDE does not remove are critical to the toolbar's basic purpose.

You can reset a toolbar to its original (default) factory settings. Table 8.3 shows how to reset the floating toolbar and window toolbars.

To reset the	Windows	Mac OS, Solaris, and Linux
main toolbar	Choose View > Toolbars > Reset Main Toolbar	Choose Window > Toolbar > Reset Floating Toolbar
window toolbar	Choose View > Toolbars > Reset Window Toolbar	Choose Window > Toolbar > Reset Window Toolbar

You can anchor the floating toolbar to the top-left corner of the screen, just below the menu bar. In its anchored state, the floating toolbar is joined to the IDE's menu bar. You cannot close or move an anchored floating toolbar.

To anchor the floating toolbar when it is currently free-floating, choose Window > Toolbar > Anchor Floating Toolbar.

To release the floating toolbar when it is currently anchored, choose Window > Toolbar > Unanchor Floating Toolbar.