org.eclipse.jface.action
Class ToolBarManager

java.lang.Object
  |
  +--org.eclipse.jface.action.ContributionManager
        |
        +--org.eclipse.jface.action.ToolBarManager

All Implemented Interfaces:

IContributionManager, IToolBarManager

public class ToolBarManager

extends ContributionManager

implements IToolBarManager

A tool bar manager is a contribution manager which realizes itself and its items in a tool bar control.

This class may be instantiated; it may also be subclassed if a more sophisticated layout is required.

Constructor Summary

ToolBarManager()
Creates a new tool bar manager with the default SWT button style.

ToolBarManager(int style)
Creates a tool bar manager with the given SWT button style.

ToolBarManager(ToolBar toolbar)
Creates a tool bar manager for an existing tool bar control.

Method Summary

ToolBar	createControl(Composite parent) Creates and returns this manager's tool bar control.
void	dispose() Disposes of this tool bar manager and frees all allocated SWT resources.
ToolBar	getControl() Returns the tool bar control for this manager.
protected void	relayout(ToolBar toolBar, int oldCount, int newCount) Re-lays out the tool bar.
void	update(boolean force) Updates this manager's underlying widget(s) with any changes which have been made to it or its items.

Methods inherited from class org.eclipse.jface.action.ContributionManager

add, add, appendToGroup, appendToGroup, dumpStatistics, find, getItems, getOverrides, hasDynamicItems, insertAfter, insertAfter, insertBefore, insertBefore, isDirty, isEmpty, markDirty, prependToGroup, prependToGroup, remove, remove, removeAll, setDirty, setOverrides

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.eclipse.jface.action.IContributionManager

add, add, appendToGroup, appendToGroup, find, getItems, getOverrides, insertAfter, insertAfter, insertBefore, insertBefore, isDirty, isEmpty, markDirty, prependToGroup, prependToGroup, remove, remove, removeAll

Constructor Detail

ToolBarManager

public ToolBarManager()

Creates a new tool bar manager with the default SWT button style. Use the createControl method to create the tool bar control.

ToolBarManager

public ToolBarManager(int style)

Creates a tool bar manager with the given SWT button style. Use the createControl method to create the tool bar control.

Parameters:

style - the tool bar item style

See Also:

for valid style bits

ToolBarManager

public ToolBarManager(ToolBar toolbar)

Creates a tool bar manager for an existing tool bar control. This manager becomes responsible for the control, and will dispose of it when the manager is disposed.

Parameters:

toolbar - the tool bar control

Method Detail

createControl

public ToolBar createControl(Composite parent)

Creates and returns this manager's tool bar control. Does not create a new control if one already exists.

Parameters:

parent - the parent control

Returns:

the tool bar control

dispose

public void dispose()

Disposes of this tool bar manager and frees all allocated SWT resources. Note that this method does not clean up references between this tool bar manager and its associated contribution items. Use removeAll for that purpose.

getControl

public ToolBar getControl()

Returns the tool bar control for this manager.

Returns:

the tool bar control, or null if none (before creating or after disposal)

relayout

protected void relayout(ToolBar toolBar,
                        int oldCount,
                        int newCount)

Re-lays out the tool bar.

The default implementation of this framework method re-lays out the parent when the number of items crosses the zero threshold. Subclasses should override this method to implement their own re-layout strategy

Parameters:

toolBar - the tool bar control

oldCount - the old number of items

newCount - the new number of items

update

public void update(boolean force)

Description copied from interface: IContributionManager

Updates this manager's underlying widget(s) with any changes which have been made to it or its items. Normally changes to a contribution manager merely mark it as dirty, without updating the underlying widgets. This brings the underlying widgets up to date with any changes.

Specified by:

update in interface IContributionManager

Parameters:

force - true means update even if not dirty, and false for normal incremental updating