Class ProjectDataContextToggleAction
- java.lang.Object
-
- docking.action.DockingAction
-
- docking.action.ToggleDockingAction
-
- ghidra.framework.main.datatable.ProjectDataContextToggleAction
-
- All Implemented Interfaces:
DockingActionIf
,ToggleDockingActionIf
,HelpDescriptor
- Direct Known Subclasses:
ProjectDataReadOnlyAction
public abstract class ProjectDataContextToggleAction extends ToggleDockingAction
-
-
Field Summary
-
Fields inherited from interface docking.action.DockingActionIf
DESCRIPTION_PROPERTY, ENABLEMENT_PROPERTY, GLOBALCONTEXT_PROPERTY, KEYBINDING_DATA_PROPERTY, MENUBAR_DATA_PROPERTY, POPUP_MENU_DATA_PROPERTY, TOOLBAR_DATA_PROPERTY
-
Fields inherited from interface docking.action.ToggleDockingActionIf
SELECTED_STATE_PROPERTY
-
-
Constructor Summary
Constructors Constructor Description ProjectDataContextToggleAction(java.lang.String name, java.lang.String owner)
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description void
actionPerformed(ActionContext context)
method to actually perform the action logic for this action.protected abstract void
actionPerformed(ProjectDataContext context)
boolean
isAddToPopup(ActionContext context)
method is used to determine if this action should be displayed on the current popup.protected boolean
isAddToPopup(ProjectDataContext context)
boolean
isEnabledForContext(ActionContext actionContext)
Method used to determine if this action should be enabled for the given context.protected boolean
isEnabledForContext(ProjectDataContext context)
boolean
isValidContext(ActionContext context)
Method that actions implement to indicate if this action is valid (knows how to work with, is appropriate for) for the given context.protected boolean
isValidContext(ProjectDataContext context)
protected boolean
supportsTransientProjectData()
Signals that this action can work on normal project data, as well as transient data.-
Methods inherited from class docking.action.ToggleDockingAction
doCreateButton, doCreateMenuItem, isSelected, setSelected
-
Methods inherited from class docking.action.DockingAction
addPropertyChangeListener, addToWindowWhen, createButton, createMenuItem, dispose, enabledWhen, firePropertyChanged, getDefaultKeyBindingData, getDescription, getFullName, getHelpInfo, getHelpObject, getInceptionFromTheFirstClassThatIsNotUsOrABuilder, getInceptionInformation, getKeyBinding, getKeyBindingData, getKeyBindingType, getMenuBarData, getName, getOwner, getPopupMenuData, getPreferredKeyBindingType, getToolBarData, isEnabled, markHelpUnnecessary, popupWhen, removePropertyChangeListener, setAddToAllWindows, setDescription, setEnabled, setHelpLocation, setKeyBindingData, setMenuBarData, setPopupMenuData, setSupportsDefaultToolContext, setToolBarData, setUnvalidatedKeyBindingData, shouldAddToWindow, supportsDefaultToolContext, toString, validContextWhen
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface docking.action.DockingActionIf
addPropertyChangeListener, createButton, createMenuItem, dispose, getDefaultKeyBindingData, getDescription, getFullName, getInceptionInformation, getKeyBinding, getKeyBindingData, getKeyBindingType, getMenuBarData, getName, getOwner, getOwnerDescription, getPopupMenuData, getToolBarData, isEnabled, removePropertyChangeListener, setEnabled, setKeyBindingData, setSupportsDefaultToolContext, setUnvalidatedKeyBindingData, shouldAddToWindow, supportsDefaultToolContext
-
Methods inherited from interface docking.help.HelpDescriptor
getHelpInfo, getHelpObject
-
-
-
-
Method Detail
-
isEnabledForContext
public final boolean isEnabledForContext(ActionContext actionContext)
Description copied from interface:DockingActionIf
Method used to determine if this action should be enabled for the given context.This is the method implementors override to control when the action may be used.
This method will be called by the DockingWindowManager for actions on the global menuBar and toolBar and for actions that have a keyBinding.
This method will be called whenever one of the following events occur:
- when the user invokes the action via its keyBinding,
- the user changes focus from one component provider to another,
- the user moves a component to another position in the window or into another window,
- a component provider reports a change in it's context,
- any plugin or software component reports a general change in context (calls the tool.contextChanged(ComponentProvider) with a null parameter).
- Specified by:
isEnabledForContext
in interfaceDockingActionIf
- Overrides:
isEnabledForContext
in classDockingAction
- Parameters:
actionContext
- the currentActionContext
for the window.- Returns:
- true if the action should be enabled for the context or false otherwise.
-
supportsTransientProjectData
protected boolean supportsTransientProjectData()
Signals that this action can work on normal project data, as well as transient data. Transient data is that which will appear in a temporary project dialog.- Returns:
- true if this action works on transient project data
-
isEnabledForContext
protected boolean isEnabledForContext(ProjectDataContext context)
-
actionPerformed
public final void actionPerformed(ActionContext context)
Description copied from interface:DockingActionIf
method to actually perform the action logic for this action.- Specified by:
actionPerformed
in interfaceDockingActionIf
- Overrides:
actionPerformed
in classToggleDockingAction
- Parameters:
context
- theActionContext
object that provides information about where and how this action was invoked.
-
actionPerformed
protected abstract void actionPerformed(ProjectDataContext context)
-
isValidContext
public boolean isValidContext(ActionContext context)
Description copied from interface:DockingActionIf
Method that actions implement to indicate if this action is valid (knows how to work with, is appropriate for) for the given context. This method is used to determine if the action should be enabled based on the either the local context or the global context. The action is first asked if it is valid for the local context and if not, then it is asked if it is valid for the global context. If a context is valid, then it will then be asked if it is enabled for that context.- Specified by:
isValidContext
in interfaceDockingActionIf
- Overrides:
isValidContext
in classDockingAction
- Parameters:
context
- theActionContext
from the active provider.- Returns:
- true if this action is appropriate for the given context.
-
isValidContext
protected boolean isValidContext(ProjectDataContext context)
-
isAddToPopup
public boolean isAddToPopup(ActionContext context)
Description copied from interface:DockingActionIf
method is used to determine if this action should be displayed on the current popup. This method will only be called if the action has popupPopupMenuData
set.Generally, actions don't need to override this method as the default implementation will defer to the
DockingActionIf.isEnabledForContext(ActionContext)
, which will have the effect of adding the action to the popup only if it is enabled for a given context. By overriding this method, you can change this behavior so that the action will be added to the popup, even if it is disabled for the context, by having this method return true even if theDockingActionIf.isEnabledForContext(ActionContext)
method will return false, resulting in the action appearing in the popup menu, but begin disabled.- Specified by:
isAddToPopup
in interfaceDockingActionIf
- Overrides:
isAddToPopup
in classDockingAction
- Parameters:
context
- theActionContext
from the active provider.- Returns:
- true if this action is appropriate for the given context.
-
isAddToPopup
protected boolean isAddToPopup(ProjectDataContext context)
-
-