public abstract class ActionGroup extends Object
ActionGroup
represents a group of actions
which are added to a context menu, or the action bars of a part, together.
The group is given a context which can be used to determine which actions
are added, and what their enabled state should be.
This class is intended only as a convenience for managing groups of actions. Clients are not required to use this class in order to add actions to context menus or action bars.
Clients should subclass this class and extend or override the appropriate fill methods.
Constructor and Description |
---|
ActionGroup() |
Modifier and Type | Method and Description |
---|---|
void |
dispose()
This method is called by the user of an action group to signal that the group is
no longer needed.
|
void |
fillActionBars(IActionBars actionBars)
Adds the applicable actions to a part's action bars,
including setting any global action handlers.
|
void |
fillContextMenu(IMenuManager menu)
Adds the applicable actions to a context menu,
based on the state of the
ActionContext . |
ActionContext |
getContext()
Returns the context used to determine which actions are added,
and what their enabled state should be.
|
void |
setContext(ActionContext context)
Sets the context used to determine which actions are added,
and what their enabled state should be.
|
void |
updateActionBars()
Updates the state of the actions added to the action bars,
including any global action handlers,
based on the state of the
ActionContext . |
public ActionContext getContext()
public void setContext(ActionContext context)
context
- the context to usepublic void fillContextMenu(IMenuManager menu)
ActionContext
.
The default implementation does nothing. Subclasses may override or extend this method.
menu
- the context menu managerpublic void fillActionBars(IActionBars actionBars)
The default implementation does nothing. Subclasses may override or extend this method.
actionBars
- the part's action barspublic void updateActionBars()
ActionContext
.
The default implementation does nothing. Subclasses may override or extend this method.
public void dispose()
The default implementation calls setContext(null)
.
Subclasses may extend this method.
Copyright (c) 2000, 2015 Eclipse Contributors and others. All rights reserved.Guidelines for using Eclipse APIs.