Package org.eclipse.jface.action

Interface ICoolBarManager

All Superinterfaces:

IContributionManager

All Known Implementing Classes:

CoolBarManager, CoolBarToTrimManager, SubCoolBarManager

public interface ICoolBarManager
extends IContributionManager

The ICoolBarManager interface provides protocol for managing contributions to a cool bar. A cool bar manager delegates responsibility for creating child controls to its contribution items by calling IContributionItem.fill(CoolBar, int).

This interface is internal to the framework; it should not be implemented outside the framework. This package provides a concrete cool bar manager implementation, CoolBarManager, which clients may instantiate or subclass.

Since:

3.0

See Also:

• ToolBarContributionItem

Field Summary

Fields

Modifier and Type	Field	Description
static final String	SIZE	Property name of a cool item's size (value "size").

Method Summary

Modifier and Type	Method	Description
void	add(IToolBarManager toolBarManager)	A convenience method to add a tool bar as a contribution item to this cool bar manager.
IMenuManager	getContextMenuManager()	Returns the context menu manager used by this cool bar manager.
boolean	getLockLayout()	Returns whether the layout of the underlying cool bar widget is locked.
int	getStyle()	Returns the style of the underlying cool bar widget.
void	setContextMenuManager(IMenuManager menuManager)	Sets the context menu of this cool bar manager to the given menu manager.
void	setLockLayout(boolean value)	Locks or unlocks the layout of the underlying cool bar widget.

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, update

Field Details

SIZE

static final String SIZE

Property name of a cool item's size (value "size").

The cool bar manager uses this property to tell its cool items to update their size.

See Also:

• @issue consider declaring this constant elsewhere
• Constant Field Values

Method Details

add

void add(IToolBarManager toolBarManager)

A convenience method to add a tool bar as a contribution item to this cool bar manager. Equivalent to add(new ToolBarContributionManager(toolBarManager)).

Parameters:

toolBarManager - the tool bar manager to be added

See Also:

• ToolBarContributionItem

getContextMenuManager

IMenuManager getContextMenuManager()

Returns the context menu manager used by this cool bar manager. This context menu manager is used by the cool bar manager except for cool items that provide their own.

Returns:

the context menu manager, or null if none

See Also:

• setContextMenuManager(org.eclipse.jface.action.IMenuManager)

getLockLayout

boolean getLockLayout()

Returns whether the layout of the underlying cool bar widget is locked.

Returns:

true if cool bar layout is locked, false otherwise

getStyle

int getStyle()

Returns the style of the underlying cool bar widget.

Returns:

the style of the cool bar

setContextMenuManager

void setContextMenuManager(IMenuManager menuManager)

Sets the context menu of this cool bar manager to the given menu manager.

Parameters:

menuManager - the context menu manager, or null if none

See Also:

• getContextMenuManager()

setLockLayout

void setLockLayout(boolean value)

Locks or unlocks the layout of the underlying cool bar widget. Once the cool bar is locked, cool items cannot be repositioned by the user.

Note that items can be added or removed programmatically even while the cool bar is locked.

Parameters:

value - true to lock the cool bar, false to unlock