WebObjects 5.2

com.webobjects.eoapplication
Class EOAction

java.lang.Object
  |
  +--javax.swing.AbstractAction
        |
        +--com.webobjects.eoapplication.EOAction
All Implemented Interfaces:
Action, ActionListener, Cloneable, EventListener, Serializable
Direct Known Subclasses:
EOEnterAction

public abstract class EOAction
extends AbstractAction

EOAction objects are abstract representations of operations the user can invoke from the user interface. An action does not specify how it appears in the user interface -- it can appear as a button, a menu item, or both.

Each action defines a method called the action name, that is invoked when the action triggers. An action also has a description path, which describes the category of the action and its name. For example, a Quit action's description path might be "Document/Quit". In addition, the action can have a short description that differs from the last element of the description path, for example, "Quit the Application".

Actions can have icons for buttons in the application and small icons for minor buttons in the user interface. To allow users to trigger actions with "hot-keys," each action has a menu accelerator, a javax.swing.KeyStroke the user can type on the keyboard.

Actions often appear in groups in the user interface: buttons in the same group are rendered close together and menu items in the group are rendered in separate menus like the Document, Edit, Tools, or Window menus. To group actions, EOAction defines a category priority. All actions in the same group have the same category priority. An additional parameter, the action priority defines the order in which actions appear within a group, for example, the order menu items appear within a menu.

An action triggers when the user clicks the corresponding user interface widget. In most cases, the action's method is dispatched to the subcontrollers that displays the action. Methods whose controller names end with ...ForControllerHierarchy return such actions. In some cases, the action's method is dispatched to the active widget, like the text field containing the cursor. Methods whose names end with ...ForFocusComponent return such actions. In other cases, the action's method is dispatched to a particular object, usually the EOApplication at the root of the controller hierarchy.

EOAction defines methods to create actions, access an action's parameters, manage groups of actions, and to access shared actions used in Direct to Java Client applications.

See Also:
Serialized Form

Inner Class Summary
static interface EOAction.ActiveWindowDependentAction
          If an EOAction object implements the EOAction.ActiveWindowDependentAction interface, it is given the opportunity to update its settings (like the menu accelerator) when the user switches the active window.
static interface EOAction.Enabling
          The EOAction.Enabling interface defines a method, canPerformActionNamed, which allows an action receiver to specify if an action (sent by an EOAction object) is enabled for the receiver.
 
Field Summary
static int ActivatePreviousWindowActionPriority
          The priority of the Activate Previous Window action.
static int AppendActionPriority
          The priority of the Append action.
static int BringAllWindowsToFrontActionPriority
          The priority of the Bring All To Front action.
static int CancelActionPriority
          The priority of the Cancel action.
static int ClearActionPriority
          The priority of the Clear action.
static int CloseWindowActionPriority
          The priority of the Close window action.
static int DeleteActionPriority
          The priority of the Delete action.
static String DescriptionPathSeparator
          The String used to separate the components of a description path.
static int DocumentCategoryPriority
          The priority of the Document category.
static int EditCategoryPriority
          The priority of the Edit category.
static int FindActionPriority
          The priority of the Find action.
static int HelpActionPriority
          The priority of the Help action.
static int HelpCategoryPriority
          The priority of the Help category.
static int InfoActionPriority
          The priority of the Info action.
static int InsertActionPriority
          The priority of the Insert action.
static int ListActionPriority
          The priority of the List action.
static int MinimizeActiveWindowActionPriority
          The priority of the Minimize Window action.
static int ModalActionsCategoryPriority
          The priority of the Modal actions category.
static int NavigationActionPriority
          The priority of the actions to navigate around in the user interface
static int NavigationActionsCategoryPriority
          The priority of the Navigation actions category.
static int NewMultipleWindowActionPriority
          The priority of actions that create multiple windows.
static int NewSingleWindowActionPriority
          The priority of actions that create single windows.
static int ObjectActionPriority
          The priority of the actions sent to business objects.
static int ObjectActionsCategoryPriority
          The priority of the Object actions category.
static int OkayActionPriority
          The priority of the Okay action.
static int OpenActionPriority
          The priority of the Open action.
static int PasteboardCopyActionPriority
          The priority of the pasteboard Copy action.
static int PasteboardCutActionPriority
          The priority of the pasteboard Cut action.
static int PasteboardDeleteActionPriority
          The priority of the pasteboard Delete action.
static int PasteboardPasteActionPriority
          The priority of the pasteboard Paste action.
static int PasteboardSelectAllActionPriority
          The priority of the pasteboard Select All action.
static int QuitActionPriority
          The priority of the Quit action.
static int RedoActionPriority
          The priority of the Redo action.
static int RefreshActionPriority
          The priority of the Refresh action.
static int RevertActionPriority
          The priority of the Revert action.
static int SaveActionPriority
          The priority of the Save action.
static int SaveAllActionPriority
          The priority of the Save All action.
static int SaveAsActionPriority
          The priority of the Save As action.
static int SearchActionPriority
          The priority of the Search action.
static int ToolsCategoryPriority
          The priority of the Tools category.
static int UndoActionPriority
          The priority of the Undo action.
static int WindowCategoryPriority
          The priority of the Windows category.
 
Fields inherited from class javax.swing.AbstractAction
changeSupport, enabled
 
Fields inherited from interface javax.swing.Action
ACCELERATOR_KEY, ACTION_COMMAND_KEY, DEFAULT, LONG_DESCRIPTION, MNEMONIC_KEY, NAME, SHORT_DESCRIPTION, SMALL_ICON
 
Constructor Summary
EOAction(String actionName, String descriptionPath, String shortDescription, Icon icon, Icon smallIcon, KeyStroke menuAccelerator, int categoryPriority, int actionPriority)
          Constructs a new EOAction as specified by the arguments.
 
Method Summary
 boolean actionCanBePerformedInContextOfController(EOController controller)
          Returns whether or not an action can trigger, which depends on the state of controllers in the controller hierarchy.
static EOAction actionForControllerHierarchy(String actionName, String descriptionPath, String shortDescription, Icon icon, Icon smallIcon, KeyStroke menuAccelerator, int categoryPriority, int actionPriority, boolean sendsActionToAllControllers)
          Returns a new action (an EOAction object) as specified by the arguments.
static EOAction actionForFocusComponent(String actionName, String descriptionPath, String shortDescription, Icon icon, Icon smallIcon, KeyStroke menuAccelerator, int categoryPriority, int actionPriority, String enabledKeyOnFocusComponent)
          Returns a new action (an EOAction object) as specified by the arguments.
static EOAction actionForObject(String actionName, String descriptionPath, String shortDescription, Icon icon, Icon smallIcon, KeyStroke menuAccelerator, int categoryPriority, int actionPriority, Object object)
          Returns a new action (an EOAction object) as specified by the arguments.
static EOAction actionForSupercontrollers(String actionName, String descriptionPath, String shortDescription, Icon icon, Icon smallIcon, KeyStroke menuAccelerator, int categoryPriority, int actionPriority, boolean sendsActionToAllControllers)
          Returns a new action (an EOAction object) as specified by the arguments.
 String actionName()
          Returns the name of the method that executes when the receiver triggers.
 void actionPerformed(ActionEvent event)
          This method is called when an action is triggered, that is, the user presses the action's button or selects its menu item.
 int actionPriority()
          Returns the receiver's action priority, which determines the order in which its button or menu item appears within a category.
 String actionTitle()
          Returns the receiver's title, the last component of the receiver's description path.
 void addPropertyChangeListener(PropertyChangeListener listener)
          See the method description for addPropertyChangeListener in Sun's documentation for javax.swing.AbstractAction.
 int categoryPriority()
          Returns the receiver's category priority, which determines the order in which the group of buttons or menu items that contains the receiver appears.
 String descriptionPath()
          Returns the receiver's menu hierarchy path, for example Document/Quit.
 NSArray descriptionPathComponents()
          Returns an NSArray containing the separate components of the receiver's menu hierarchy path.
 boolean equals(Object comparisionObject)
          Indicates whether some object "is equal to" this one.
protected  void firePropertyChange(String propertyName, Object oldValue, Object newValue)
          See the method description for firePropertyChange in Sun's documentation for javax.swing.AbstractAction.
 Icon icon()
          Returns the receiver's icon.
static KeyStroke keyStrokeWithKeyCode(int keyCode)
          Returns a KeyStroke given the numerical key code keyCode with the appropriate modifier for the client operating system (usually CTRL_MASK).
static KeyStroke keyStrokeWithKeyCodeAndModifiers(int keyCode, int modifiers)
          Returns a KeyStroke given the numerical key code keyCode and the modifier mask modifiers.
static KeyStroke keyStrokeWithKeyCodeAndShiftModifier(int keyCode)
          Returns a KeyStroke given the numerical key code keyCode with the SHIFT modifier.
static KeyStroke keyStrokeWithString(String keyStrokeDescription)
          Returns a KeyStroke for the String keyStrokeDescription.
 KeyStroke menuAccelerator()
          Returns the KeyStroke the user can type to invoke the receiver instead of selecting it from the menu.
static NSArray mergedActions(NSArray actions1, NSArray actions2)
          Returns an NSArray containing all of the actions in actionArray1 and actionArray2 with duplicate actions removed.
 void removePropertyChangeListener(PropertyChangeListener listener)
          See the method description for removePropertyChangeListener in Sun's documentation for javax.swing.AbstractAction.
 void setActionName(String actionName)
          Sets the name of the method that executes when the receiver triggers.
 void setActionPriority(int priority)
          Sets the receiver's action priority, which determines the order in which its button or menu item appears within a category.
 void setCategoryPriority(int priority)
          Sets the receiver's category priority, which determines the order in which the group of buttons or menu items that contains the receiver appears.
 void setDescriptionPath(String descriptionPath)
          Sets the receiver's menu hierarchy path to descriptionPath, for example Document/Quit.
 void setIcon(Icon icon)
          Sets the receiver's icon to icon.
 void setMenuAccelerator(KeyStroke menuAccelerator)
          Sets the KeyStroke the user can type to invoke the receiver instead of selecting it from a menu.
 void setShortDescription(String string)
          Sets the action's short description to string.
 void setSmallIcon(Icon icon)
          Sets the receiver's small icon used for some small buttons in the user interface.
 void setToolTip(String toolTip)
           
 String shortDescription()
          Returns the receiver's short description, which is displayed in buttons and pop-up menu items.
 Icon smallIcon()
          Returns the receiver's small icon used for some small buttons in the user interface.
static NSArray sortedActions(NSArray actions)
          Returns a sorted NSArray containing the specified actions.
static EOAction standardActionForFocusComponent(String actionName, KeyStroke menuAccelerator, int actionPriority, String enabledKeyOnFocusComponent)
          Returns a shared action as specified by the arguments.
static EOAction standardActivatePreviousWindowActionForWindowObserver()
          Returns a shared action (an EOAction object) for the activatePreviousWindow method, which is dispatched directly to the window observer object of the application.
static EOAction standardAddActionForControllerHierarchy()
          Returns a shared action (an EOAction object) for the add method which is dispatched in the controller hierarchy.
static EOAction standardAppendActionForControllerHierarchy()
          Returns a shared action (an EOAction object) for the append method which is dispatched in the controller hierarchy.
static EOAction standardBringAllWindowsToFrontActionForWindowObserver()
          Returns a shared action (an EOAction object) for the bringAllWindowsToFront method, which is dispatched directly to the window observer object of the application.
static EOAction standardCancelActionForControllerHierarchy()
          Returns a shared action (an EOAction object) for the cancel method which is dispatched in the controller hierarchy.
static EOAction standardClearActionForControllerHierarchy()
          Returns a shared action (an EOAction object) for the clear method which is dispatched in the controller hierarchy.
static EOAction standardCloseWindowActionForControllerHierarchy()
          Returns a shared action (an EOAction object) for the closeWindow method which is dispatched in the controller hierarchy.
static EOAction standardDeleteActionForControllerHierarchy()
          Returns a shared action (an EOAction object) for the delete method which is dispatched in the controller hierarchy.
static EOAction standardDeselectActionForControllerHierarchy()
          Returns a shared action (an EOAction object) for the deselect method which is dispatched in the controller hierarchy.
static EOAction standardDocumentActionForApplication(String actionName, KeyStroke menuAccelerator, int actionPriority)
          Returns an action with the method name actionName, menu accelerator menuAccelerator, and action priority actionPriority.
static EOAction standardDocumentActionForControllerHierarchy(String actionName, KeyStroke menuAccelerator, int actionPriority)
          Returns an action as specified by the arguments.
static EOAction standardDocumentActionForControllerHierarchy(String actionName, String baseTitle, KeyStroke menuAccelerator, int actionPriority)
          Returns an action as specified by the arguments.
static EOAction standardEditActionForControllerHierarchy(String actionName, KeyStroke menuAccelerator, int actionPriority)
          Returns an action as specified by the arguments.
static NSArray standardEditActionsForFocusComponent()
          Returns an NSArray containing shared actions for the cut, copy, paste and selectAll actions.
static EOAction standardFindActionForControllerHierarchy()
          Returns a shared action (an EOAction object) for the find method which is dispatched in the controller hierarchy.
static EOAction standardInsertActionForControllerHierarchy()
          Returns a shared action (an EOAction object) for the insert method which is dispatched in the controller hierarchy.
static EOAction standardInsertWithTaskActionForControllerHierarchy()
          Returns a shared action (an EOAction object) for the insertWithTask method which is dispatched in the controller hierarchy.
static EOAction standardMinimizeActiveWindowActionForWindowObserver()
          Returns a shared action (an EOAction object) for the minimizeActiveWindow method, which is dispatched directly to the window observer object of the application.
static EOAction standardOkActionForControllerHierarchy()
          Returns a shared action (an EOAction object) for the ok method which is dispatched in the controller hierarchy.
static EOAction standardOkAndSaveActionForControllerHierarchy()
          Returns a shared action (an EOAction object) for the ok method, displayed as a Save action, which is dispatched in the controller hierarchy.
static EOAction standardOpenWithTaskActionForControllerHierarchy()
          Returns a shared action (an EOAction object) for the openWithTask method which is dispatched in the controller hierarchy.
static EOAction standardQuitActionForApplication()
          Returns a shared action (an EOAction object) for the quit method, which is dispatched directly to the EOApplication object at the top of the controller hierarchy.
static EOAction standardRedoActionForControllerHierarchy()
          Returns a shared action (an EOAction object) for the redo method which is dispatched in the controller hierarchy.
static EOAction standardRefreshActionForApplication()
          Returns a shared action (an EOAction object) for the collectChangesFromServer method, displayed as a Refresh action, which is dispatched directly to the EOApplication object at the top of the controller hierarchy.
static EOAction standardRemoveActionForControllerHierarchy()
          Returns a shared action (an EOAction object) for the remove method which is dispatched in the controller hierarchy.
static EOAction standardRevertActionForControllerHierarchy()
          Returns a shared action (an EOAction object) for the revert method which is dispatched in the controller hierarchy.
static EOAction standardSaveActionForControllerHierarchy()
          Returns a shared action (an EOAction object) for the save method which is dispatched in the controller hierarchy.
static EOAction standardSaveAllActionForApplication()
          Returns a shared action (an EOAction object) for the saveAll method, which is dispatched directly to the EOApplication object at the top of the controller hierarchy.
static EOAction standardSaveAsActionForControllerHierarchy()
          Returns a shared action (an EOAction object) for the saveAs method which is dispatched in the controller hierarchy.
static EOAction standardSelectActionForControllerHierarchy()
          Returns a shared action (an EOAction object) for the select method which is dispatched in the controller hierarchy.
static EOAction standardUndoActionForControllerHierarchy()
          Returns a shared action (an EOAction object) for the undo method which is dispatched in the controller hierarchy.
 String toolTip()
           
 String toString()
          Returns the receiver as a string that states the receiver's method name, description path, category priority, and action priority.
 
Methods inherited from class javax.swing.AbstractAction
clone, getKeys, getValue, isEnabled, putValue, setEnabled
 
Methods inherited from class java.lang.Object
finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

ActivatePreviousWindowActionPriority

public static final int ActivatePreviousWindowActionPriority
The priority of the Activate Previous Window action.
See Also:
standardActivatePreviousWindowActionForWindowObserver()

AppendActionPriority

public static final int AppendActionPriority
The priority of the Append action.
See Also:
standardAppendActionForControllerHierarchy()

BringAllWindowsToFrontActionPriority

public static final int BringAllWindowsToFrontActionPriority
The priority of the Bring All To Front action.
See Also:
standardBringAllWindowsToFrontActionForWindowObserver()

CancelActionPriority

public static final int CancelActionPriority
The priority of the Cancel action.
See Also:
standardCancelActionForControllerHierarchy()

ClearActionPriority

public static final int ClearActionPriority
The priority of the Clear action.
See Also:
standardClearActionForControllerHierarchy()

CloseWindowActionPriority

public static final int CloseWindowActionPriority
The priority of the Close window action.
See Also:
standardCloseWindowActionForControllerHierarchy()

DeleteActionPriority

public static final int DeleteActionPriority
The priority of the Delete action.
See Also:
standardDeleteActionForControllerHierarchy(), standardRemoveActionForControllerHierarchy(), standardDeselectActionForControllerHierarchy()

DescriptionPathSeparator

public static final String DescriptionPathSeparator
The String used to separate the components of a description path.

DocumentCategoryPriority

public static final int DocumentCategoryPriority
The priority of the Document category.
See Also:
standardDocumentActionForControllerHierarchy(String, KeyStroke, int)

EditCategoryPriority

public static final int EditCategoryPriority
The priority of the Edit category.
See Also:
standardEditActionForControllerHierarchy(String, KeyStroke, int), standardActionForFocusComponent(String, KeyStroke, int, String)

FindActionPriority

public static final int FindActionPriority
The priority of the Find action.
See Also:
standardFindActionForControllerHierarchy()

HelpActionPriority

public static final int HelpActionPriority
The priority of the Help action.

HelpCategoryPriority

public static final int HelpCategoryPriority
The priority of the Help category.

InfoActionPriority

public static final int InfoActionPriority
The priority of the Info action.

InsertActionPriority

public static final int InsertActionPriority
The priority of the Insert action.
See Also:
standardInsertActionForControllerHierarchy(), standardInsertWithTaskActionForControllerHierarchy(), standardAddActionForControllerHierarchy(), standardSelectActionForControllerHierarchy()

ListActionPriority

public static final int ListActionPriority
The priority of the List action.
See Also:
standardOpenWithTaskActionForControllerHierarchy()

MinimizeActiveWindowActionPriority

public static final int MinimizeActiveWindowActionPriority
The priority of the Minimize Window action.
See Also:
standardMinimizeActiveWindowActionForWindowObserver()

ModalActionsCategoryPriority

public static final int ModalActionsCategoryPriority
The priority of the Modal actions category.
See Also:
standardCancelActionForControllerHierarchy(), standardOkActionForControllerHierarchy(), standardOkAndSaveActionForControllerHierarchy()

NavigationActionPriority

public static final int NavigationActionPriority
The priority of the actions to navigate around in the user interface
See Also:
EOWindowController.defaultActions()

NavigationActionsCategoryPriority

public static final int NavigationActionsCategoryPriority
The priority of the Navigation actions category.
See Also:
EOWindowController.defaultActions()

NewMultipleWindowActionPriority

public static final int NewMultipleWindowActionPriority
The priority of actions that create multiple windows.

NewSingleWindowActionPriority

public static final int NewSingleWindowActionPriority
The priority of actions that create single windows.

ObjectActionPriority

public static final int ObjectActionPriority
The priority of the actions sent to business objects.

ObjectActionsCategoryPriority

public static final int ObjectActionsCategoryPriority
The priority of the Object actions category.

OkayActionPriority

public static final int OkayActionPriority
The priority of the Okay action.
See Also:
standardOkActionForControllerHierarchy(), standardOkAndSaveActionForControllerHierarchy()

OpenActionPriority

public static final int OpenActionPriority
The priority of the Open action.
See Also:
standardOpenWithTaskActionForControllerHierarchy()

PasteboardCopyActionPriority

public static final int PasteboardCopyActionPriority
The priority of the pasteboard Copy action.
See Also:
standardEditActionsForFocusComponent()

PasteboardCutActionPriority

public static final int PasteboardCutActionPriority
The priority of the pasteboard Cut action.
See Also:
standardEditActionsForFocusComponent()

PasteboardDeleteActionPriority

public static final int PasteboardDeleteActionPriority
The priority of the pasteboard Delete action.
See Also:
standardEditActionsForFocusComponent()

PasteboardPasteActionPriority

public static final int PasteboardPasteActionPriority
The priority of the pasteboard Paste action.
See Also:
standardEditActionsForFocusComponent()

PasteboardSelectAllActionPriority

public static final int PasteboardSelectAllActionPriority
The priority of the pasteboard Select All action.
See Also:
standardEditActionsForFocusComponent()

QuitActionPriority

public static final int QuitActionPriority
The priority of the Quit action.
See Also:
standardQuitActionForApplication()

RedoActionPriority

public static final int RedoActionPriority
The priority of the Redo action.
See Also:
standardRedoActionForControllerHierarchy()

RefreshActionPriority

public static final int RefreshActionPriority
The priority of the Refresh action.
See Also:
standardRefreshActionForApplication()

RevertActionPriority

public static final int RevertActionPriority
The priority of the Revert action.
See Also:
standardRevertActionForControllerHierarchy()

SaveActionPriority

public static final int SaveActionPriority
The priority of the Save action.
See Also:
standardSaveActionForControllerHierarchy()

SaveAllActionPriority

public static final int SaveAllActionPriority
The priority of the Save All action.
See Also:
standardSaveAllActionForApplication()

SaveAsActionPriority

public static final int SaveAsActionPriority
The priority of the Save As action.
See Also:
standardSaveAsActionForControllerHierarchy()

SearchActionPriority

public static final int SearchActionPriority
The priority of the Search action.

ToolsCategoryPriority

public static final int ToolsCategoryPriority
The priority of the Tools category.

UndoActionPriority

public static final int UndoActionPriority
The priority of the Undo action.
See Also:
standardUndoActionForControllerHierarchy()

WindowCategoryPriority

public static final int WindowCategoryPriority
The priority of the Windows category.
See Also:
standardCloseWindowActionForControllerHierarchy()
Constructor Detail

EOAction

public EOAction(String actionName,
                String descriptionPath,
                String shortDescription,
                Icon icon,
                Icon smallIcon,
                KeyStroke menuAccelerator,
                int categoryPriority,
                int actionPriority)
Constructs a new EOAction as specified by the arguments.
Parameters:
actionName - the name of the action method
descriptionPath - the description path of the action
shortDescription - the short description of the action
icon - the icon of the action
smallIcon - the small icon of the action
menuAccelerator - the menu accelerator of the action
categoryPriority - the category priority of the action
actionPriority - the action priority of the action
See Also:
actionName(), descriptionPath(), shortDescription(), icon(), smallIcon(), menuAccelerator(), categoryPriority(), actionPriority()
Method Detail

actionCanBePerformedInContextOfController

public boolean actionCanBePerformedInContextOfController(EOController controller)
Returns whether or not an action can trigger, which depends on the state of controllers in the controller hierarchy. For example, a Save action for an unedited document can usually not trigger.
Parameters:
controller - the EOController
Returns:
true if an action can trigger; false otherwise

actionForControllerHierarchy

public static EOAction actionForControllerHierarchy(String actionName,
                                                    String descriptionPath,
                                                    String shortDescription,
                                                    Icon icon,
                                                    Icon smallIcon,
                                                    KeyStroke menuAccelerator,
                                                    int categoryPriority,
                                                    int actionPriority,
                                                    boolean sendsActionToAllControllers)
Returns a new action (an EOAction object) as specified by the arguments. When this action triggers, it is dispatched to the subcontrollers of the controller that displays it. If sendsActionToAllControllers is true, the action is dispatched to all subcontrollers of the controller that displays the action. Otherwise, the action is dispatched only to the first subcontroller that responds to it.
Parameters:
actionName - the name of the action method
descriptionPath - the description path of the action
shortDescription - the short description of the action
icon - the icon of the action
smallIcon - the small icon of the action
menuAccelerator - the menu accelerator of the action
categoryPriority - the category priority of the action
actionPriority - the action priority of the action
sendsActionToAllControllers - whether to dispatch the action to all subcontrollers or just to the first that responds
Returns:
a new action as specified by the arguments
See Also:
actionName(), descriptionPath(), shortDescription(), icon(), smallIcon(), menuAccelerator(), categoryPriority(), actionPriority()

actionForFocusComponent

public static EOAction actionForFocusComponent(String actionName,
                                               String descriptionPath,
                                               String shortDescription,
                                               Icon icon,
                                               Icon smallIcon,
                                               KeyStroke menuAccelerator,
                                               int categoryPriority,
                                               int actionPriority,
                                               String enabledKeyOnFocusComponent)
Returns a new action (an EOAction object) as specified by the arguments. When this action triggers, it is dispatched to the active widget (for example, the text field containing the cursor). The enabledKeyOnFocusComponent specifies the name of the field or method, resolved by key-value coding, specifying whether the action is enabled for the focus component (for example, "editable" for the action "cut").
Parameters:
actionName - the name of the action method
descriptionPath - the description path of the action
shortDescription - the short description of the action
icon - the icon of the action
smallIcon - the small icon of the action
menuAccelerator - the menu accelerator of the action
categoryPriority - the category priority of the action
actionPriority - the action priority of the action
enabledKeyOnFocusComponent - the key path to resolve to determine whether the action is enabled for the focus component
See Also:
actionName(), descriptionPath(), shortDescription(), icon(), smallIcon(), menuAccelerator(), categoryPriority(), actionPriority()

actionForObject

public static EOAction actionForObject(String actionName,
                                       String descriptionPath,
                                       String shortDescription,
                                       Icon icon,
                                       Icon smallIcon,
                                       KeyStroke menuAccelerator,
                                       int categoryPriority,
                                       int actionPriority,
                                       Object object)
Returns a new action (an EOAction object) as specified by the arguments. When this action triggers, it is dispatched directly to the one object specified when invoking this method. To create an action that gets dispatched to the application object, set object to EOApplication.sharedApplication().
Parameters:
actionName - the name of the action method
descriptionPath - the description path of the action
shortDescription - the short description of the action
icon - the icon of the action
smallIcon - the small icon of the action
menuAccelerator - the menu accelerator of the action
categoryPriority - the category priority of the action
actionPriority - the action priority of the action
object - the object to which the action is dispatched
See Also:
descriptionPath(), shortDescription(), icon(), smallIcon(), menuAccelerator(), categoryPriority(), actionPriority()

actionForSupercontrollers

public static EOAction actionForSupercontrollers(String actionName,
                                                 String descriptionPath,
                                                 String shortDescription,
                                                 Icon icon,
                                                 Icon smallIcon,
                                                 KeyStroke menuAccelerator,
                                                 int categoryPriority,
                                                 int actionPriority,
                                                 boolean sendsActionToAllControllers)
Returns a new action (an EOAction object) as specified by the arguments. When this action triggers, it is dispatched to the supercontrollers of the controller that displays it. If sendsActionToAllControllers is true, the action is dispatched to all supercontrollers of the controller that displays the action. Otherwise, the action is dispatched only to the first supercontroller that responds to it.
Parameters:
actionName - the name of the action method
descriptionPath - the description path of the action
shortDescription - the short description of the action
icon - the icon of the action
smallIcon - the small icon of the action
menuAccelerator - the menu accelerator of the action
categoryPriority - the category priority of the action
actionPriority - the action priority of the action
sendsActionToAllControllers - whether to dispatch the action to all supercontrollers or just to the first that responds
Returns:
a new action as specified by the arguments
See Also:
actionName(), descriptionPath(), shortDescription(), icon(), smallIcon(), menuAccelerator(), categoryPriority(), actionPriority()

actionName

public String actionName()
Returns the name of the method that executes when the receiver triggers.
Returns:
the name of the method that executes when the receiver triggers

actionPerformed

public void actionPerformed(ActionEvent event)
This method is called when an action is triggered, that is, the user presses the action's button or selects its menu item. This method must be overridden by subclasses.
Overrides:
actionPerformed in class AbstractAction
Parameters:
event - the ActionEvent

actionPriority

public int actionPriority()
Returns the receiver's action priority, which determines the order in which its button or menu item appears within a category.
Returns:
the receiver's action priority
See Also:
categoryPriority()

actionTitle

public String actionTitle()
Returns the receiver's title, the last component of the receiver's description path.
Returns:
the receiver's title

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)
See the method description for addPropertyChangeListener in Sun's documentation for javax.swing.AbstractAction.
Overrides:
addPropertyChangeListener in class AbstractAction
Parameters:
listener - the PropertyChangeListener
See Also:
AbstractAction.addPropertyChangeListener(PropertyChangeListener)

categoryPriority

public int categoryPriority()
Returns the receiver's category priority, which determines the order in which the group of buttons or menu items that contains the receiver appears.
Returns:
the receiver's category priority

descriptionPath

public String descriptionPath()
Returns the receiver's menu hierarchy path, for example Document/Quit.
Returns:
the receiver's menu hierarchy path

descriptionPathComponents

public NSArray descriptionPathComponents()
Returns an NSArray containing the separate components of the receiver's menu hierarchy path.
Returns:
an NSArray containing the separate components of the receiver's menu hierarchy path

equals

public boolean equals(Object comparisionObject)
Indicates whether some object "is equal to" this one.
Overrides:
equals in class Object
Parameters:
comparisionObject - the reference object with which to compare
Returns:
true if this object is the same as the comparisionObject argument; false otherwise

firePropertyChange

protected void firePropertyChange(String propertyName,
                                  Object oldValue,
                                  Object newValue)
See the method description for firePropertyChange in Sun's documentation for javax.swing.AbstractAction.
Overrides:
firePropertyChange in class AbstractAction
Parameters:
listener - the PropertyChangeListener
See Also:
AbstractAction.firePropertyChange(String, Object, Object)

icon

public Icon icon()
Returns the receiver's icon.
Returns:
the receiver's icon

keyStrokeWithKeyCode

public static KeyStroke keyStrokeWithKeyCode(int keyCode)
Returns a KeyStroke given the numerical key code keyCode with the appropriate modifier for the client operating system (usually CTRL_MASK). See Sun's javax.swing.KeyStroke documentation for more information.
Parameters:
keyCode - the numerical key code
Returns:
the KeyStroke that matches the keyCode
See Also:
KeyStroke

keyStrokeWithKeyCodeAndModifiers

public static KeyStroke keyStrokeWithKeyCodeAndModifiers(int keyCode,
                                                         int modifiers)
Returns a KeyStroke given the numerical key code keyCode and the modifier mask modifiers. This method adds the appropriate modifier for the client operating system (usually CTRL_MASK). See Sun's javax.swing.KeyStroke documentation for more information.
Parameters:
keyCode - the numerical key code
modifiers - the modifier mask
Returns:
the KeyStroke that matches the keyCode and modifiers
See Also:
KeyStroke

keyStrokeWithKeyCodeAndShiftModifier

public static KeyStroke keyStrokeWithKeyCodeAndShiftModifier(int keyCode)
Returns a KeyStroke given the numerical key code keyCode with the SHIFT modifier. This method also adds the appropriate modifier for the client operating system (usually CTRL_MASK). See Sun's javax.swing.KeyStroke documentation for more information.
Parameters:
keyCode - the numerical key code
Returns:
the KeyStroke that matches the keyCode with the SHIFT modifier
See Also:
KeyStroke

keyStrokeWithString

public static KeyStroke keyStrokeWithString(String keyStrokeDescription)
Returns a KeyStroke for the String keyStrokeDescription. This method adds the appropriate modifier for the client operating system (usually CTRL_MASK). See Sun's javax.swing.KeyStroke documentation for more information.
Parameters:
keyStrokeDescription - the description of the KeyStroke
Returns:
the KeyStroke that matches the description if one exists; null otherwise
See Also:
KeyStroke

menuAccelerator

public KeyStroke menuAccelerator()
Returns the KeyStroke the user can type to invoke the receiver instead of selecting it from the menu.
Returns:
the KeyStroke to invoke the receiver

mergedActions

public static NSArray mergedActions(NSArray actions1,
                                    NSArray actions2)
Returns an NSArray containing all of the actions in actionArray1 and actionArray2 with duplicate actions removed.
Parameters:
actions1 - an NSArray of actions
actions2 - an NSArray of actions
Returns:
an NSArray of the union of actions1 and action2

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)
See the method description for removePropertyChangeListener in Sun's documentation for javax.swing.AbstractAction.
Overrides:
removePropertyChangeListener in class AbstractAction
Parameters:
listener - the PropertyChangeListener
See Also:
AbstractAction.removePropertyChangeListener(PropertyChangeListener)

setActionName

public void setActionName(String actionName)
Sets the name of the method that executes when the receiver triggers.
Parameters:
actionName - the name of the method that executes when the receiver triggers

setActionPriority

public void setActionPriority(int priority)
Sets the receiver's action priority, which determines the order in which its button or menu item appears within a category.
Parameters:
priority - the receiver's action priority

setCategoryPriority

public void setCategoryPriority(int priority)
Sets the receiver's category priority, which determines the order in which the group of buttons or menu items that contains the receiver appears.
Parameters:
priority - the receiver's category priority

setDescriptionPath

public void setDescriptionPath(String descriptionPath)
Sets the receiver's menu hierarchy path to descriptionPath, for example Document/Quit.
Parameters:
descriptionPath - the receiver's menu hierarchy path

setIcon

public void setIcon(Icon icon)
Sets the receiver's icon to icon.
Parameters:
icon - the icon

setMenuAccelerator

public void setMenuAccelerator(KeyStroke menuAccelerator)
Sets the KeyStroke the user can type to invoke the receiver instead of selecting it from a menu.
Parameters:
menuAccelerator - the KeyStroke to invoke the receiver
See Also:
keyStrokeWithKeyCode(int), keyStrokeWithKeyCodeAndModifiers(int, int), keyStrokeWithKeyCodeAndShiftModifier(int)

setShortDescription

public void setShortDescription(String string)
Sets the action's short description to string. The short description appears in buttons and pop-up menu items. If shortDescription is null, the receiver's title is displayed instead.
Parameters:
string - the action's short description
See Also:
actionTitle()

setSmallIcon

public void setSmallIcon(Icon icon)
Sets the receiver's small icon used for some small buttons in the user interface.
Parameters:
icon - the receiver's small icon

setToolTip

public void setToolTip(String toolTip)

shortDescription

public String shortDescription()
Returns the receiver's short description, which is displayed in buttons and pop-up menu items. If the short description is set to null or has not been assigned, shortDescription returns the action's title.
Returns:
the receiver's short description
See Also:
actionTitle()

smallIcon

public Icon smallIcon()
Returns the receiver's small icon used for some small buttons in the user interface. By default, the small icon is not displayed for such buttons; the short description is displayed instead.
Returns:
the receiver's small icon
See Also:
shortDescription()

sortedActions

public static NSArray sortedActions(NSArray actions)
Returns a sorted NSArray containing the specified actions. The actions are sorted first on the category priority, then on the action priority, and finally on the description path.
Parameters:
actions - an NSArray of actions
Returns:
a sorted NSArray of actions
See Also:
categoryPriority(), actionPriority(), descriptionPath()

standardActionForFocusComponent

public static EOAction standardActionForFocusComponent(String actionName,
                                                       KeyStroke menuAccelerator,
                                                       int actionPriority,
                                                       String enabledKeyOnFocusComponent)
Returns a shared action as specified by the arguments. When the action triggers, it is dispatched to the focus component (for example, the active text field) The action's category priority is EOAction.EditCategoryPriority, so the action is grouped with the other edit actions.
Parameters:
actionName - the name of the action
menuAccelerator - the menu accelerator of the action
actionPriority - the action priority of the action
enabledKeyOnFocusComponent - the key path to resolve to determine whether the action is enabled for the focus component
Returns:
a shared action as specified by the arguments
See Also:
actionName(), menuAccelerator(), actionPriority(), EditCategoryPriority

standardActivatePreviousWindowActionForWindowObserver

public static EOAction standardActivatePreviousWindowActionForWindowObserver()
Returns a shared action (an EOAction object) for the activatePreviousWindow method, which is dispatched directly to the window observer object of the application.
Returns:
a shared action for the activatePreviousWindow method
See Also:
ActivatePreviousWindowActionPriority

standardAddActionForControllerHierarchy

public static EOAction standardAddActionForControllerHierarchy()
Returns a shared action (an EOAction object) for the add method which is dispatched in the controller hierarchy.
Returns:
a shared action for the add method
See Also:
InsertActionPriority

standardAppendActionForControllerHierarchy

public static EOAction standardAppendActionForControllerHierarchy()
Returns a shared action (an EOAction object) for the append method which is dispatched in the controller hierarchy.
Returns:
a shared action for the append method
See Also:
AppendActionPriority

standardBringAllWindowsToFrontActionForWindowObserver

public static EOAction standardBringAllWindowsToFrontActionForWindowObserver()
Returns a shared action (an EOAction object) for the bringAllWindowsToFront method, which is dispatched directly to the window observer object of the application.
Returns:
a shared action for the bringAllWindowsToFront method
See Also:
BringAllWindowsToFrontActionPriority

standardCancelActionForControllerHierarchy

public static EOAction standardCancelActionForControllerHierarchy()
Returns a shared action (an EOAction object) for the cancel method which is dispatched in the controller hierarchy.
Returns:
a shared action for the cancel method
See Also:
CancelActionPriority

standardClearActionForControllerHierarchy

public static EOAction standardClearActionForControllerHierarchy()
Returns a shared action (an EOAction object) for the clear method which is dispatched in the controller hierarchy.
Returns:
a shared action for the clear method
See Also:
ClearActionPriority

standardCloseWindowActionForControllerHierarchy

public static EOAction standardCloseWindowActionForControllerHierarchy()
Returns a shared action (an EOAction object) for the closeWindow method which is dispatched in the controller hierarchy.
Returns:
a shared action for the closeWindow method
See Also:
CloseWindowActionPriority

standardDeleteActionForControllerHierarchy

public static EOAction standardDeleteActionForControllerHierarchy()
Returns a shared action (an EOAction object) for the delete method which is dispatched in the controller hierarchy.
Returns:
a shared action for the delete method
See Also:
DeleteActionPriority

standardDeselectActionForControllerHierarchy

public static EOAction standardDeselectActionForControllerHierarchy()
Returns a shared action (an EOAction object) for the deselect method which is dispatched in the controller hierarchy.
Returns:
a shared action for the deselect method
See Also:
DeleteActionPriority

standardDocumentActionForApplication

public static EOAction standardDocumentActionForApplication(String actionName,
                                                            KeyStroke menuAccelerator,
                                                            int actionPriority)
Returns an action with the method name actionName, menu accelerator menuAccelerator, and action priority actionPriority. When the action triggers, it is dispatched directly to the EOApplication object at the top of the controller hierarchy. The action's category priority is EOAction.DocumentCategoryPriority, so the action is grouped with the other document actions.
Parameters:
#actionName - the name of the action
#menuAccelerator - the menu accelerator of the action
#actionPriority - the action priority of the action
Returns:
a shared action as specified by the arguments

standardDocumentActionForControllerHierarchy

public static EOAction standardDocumentActionForControllerHierarchy(String actionName,
                                                                    String baseTitle,
                                                                    KeyStroke menuAccelerator,
                                                                    int actionPriority)
Returns an action as specified by the arguments. The baseTitle parameter is the name of the action as it appears in the user interface and is used for both the short description and the action title. When the action triggers, it is dispatched to the subcontrollers of the controller that displays it. The action's category priority is EOAction.DocumentCategoryPriority, so the action is grouped with the other document actions.
Parameters:
actionName - the name of the action method
baseTitle - used for both the short description and action title
menuAccelerator - the menu accelerator of the action
actionPriority - the action priority of the action
Returns:
a shared action as specified by the arguments
See Also:
actionName(), actionTitle(), shortDescription(), menuAccelerator(), actionPriority(), DocumentCategoryPriority

standardDocumentActionForControllerHierarchy

public static EOAction standardDocumentActionForControllerHierarchy(String actionName,
                                                                    KeyStroke menuAccelerator,
                                                                    int actionPriority)
Returns an action as specified by the arguments. When the action triggers, it is dispatched to the subcontrollers of the controller that displays it. The action's category priority is EOAction.DocumentCategoryPriority, so the action is grouped with the other document actions.
Parameters:
actionName - the name of the action method
menuAccelerator - the menu accelerator of the action
actionPriority - the action priority of the action
Returns:
a shared action as specified by the arguments
See Also:
actionName(), actionTitle(), shortDescription(), menuAccelerator(), actionPriority(), DocumentCategoryPriority

standardEditActionForControllerHierarchy

public static EOAction standardEditActionForControllerHierarchy(String actionName,
                                                                KeyStroke menuAccelerator,
                                                                int actionPriority)
Returns an action as specified by the arguments. When the action triggers, it is dispatched to the subcontrollers of the controller that displays it. The action's category priority is EOAction.EditCategoryPriority, so the action is grouped with the other edit actions.
Parameters:
actionName - the name of the action
menuAccelerator - the menu accelerator of the action
actionPriority - the action priority of the action
Returns:
a shared action as specified by the arguments
See Also:
actionName(), menuAccelerator(), actionPriority()

standardEditActionsForFocusComponent

public static NSArray standardEditActionsForFocusComponent()
Returns an NSArray containing shared actions for the cut, copy, paste and selectAll actions. When these actions trigger, they are dispatched to the focus component.
Returns:
an NSArray containing shared actions for the cut, copy, paste and selectAll actions
See Also:
PasteboardCutActionPriority, PasteboardCopyActionPriority, PasteboardPasteActionPriority, PasteboardSelectAllActionPriority

standardFindActionForControllerHierarchy

public static EOAction standardFindActionForControllerHierarchy()
Returns a shared action (an EOAction object) for the find method which is dispatched in the controller hierarchy.
Returns:
a shared action for the find method
See Also:
FindActionPriority

standardInsertActionForControllerHierarchy

public static EOAction standardInsertActionForControllerHierarchy()
Returns a shared action (an EOAction object) for the insert method which is dispatched in the controller hierarchy.
Returns:
a shared action for the insert method
See Also:
InsertActionPriority

standardInsertWithTaskActionForControllerHierarchy

public static EOAction standardInsertWithTaskActionForControllerHierarchy()
Returns a shared action (an EOAction object) for the insertWithTask method which is dispatched in the controller hierarchy.
Returns:
a shared action for the insertWithTask method
See Also:
InsertActionPriority

standardMinimizeActiveWindowActionForWindowObserver

public static EOAction standardMinimizeActiveWindowActionForWindowObserver()
Returns a shared action (an EOAction object) for the minimizeActiveWindow method, which is dispatched directly to the window observer object of the application.
Returns:
a shared action for the minimizeActiveWindow method
See Also:
MinimizeActiveWindowActionPriority

standardOkActionForControllerHierarchy

public static EOAction standardOkActionForControllerHierarchy()
Returns a shared action (an EOAction object) for the ok method which is dispatched in the controller hierarchy.
Returns:
a shared action for the ok method
See Also:
OkayActionPriority

standardOkAndSaveActionForControllerHierarchy

public static EOAction standardOkAndSaveActionForControllerHierarchy()
Returns a shared action (an EOAction object) for the ok method, displayed as a Save action, which is dispatched in the controller hierarchy.
Returns:
a shared action for the ok method, displayed as a Save action
See Also:
OkayActionPriority

standardOpenWithTaskActionForControllerHierarchy

public static EOAction standardOpenWithTaskActionForControllerHierarchy()
Returns a shared action (an EOAction object) for the openWithTask method which is dispatched in the controller hierarchy.
Returns:
a shared action for the openWithTask method
See Also:
OpenActionPriority

standardQuitActionForApplication

public static EOAction standardQuitActionForApplication()
Returns a shared action (an EOAction object) for the quit method, which is dispatched directly to the EOApplication object at the top of the controller hierarchy.
Returns:
a shared action for the quit method
See Also:
QuitActionPriority

standardRedoActionForControllerHierarchy

public static EOAction standardRedoActionForControllerHierarchy()
Returns a shared action (an EOAction object) for the redo method which is dispatched in the controller hierarchy.
Returns:
a shared action for the redo method
See Also:
RedoActionPriority

standardRefreshActionForApplication

public static EOAction standardRefreshActionForApplication()
Returns a shared action (an EOAction object) for the collectChangesFromServer method, displayed as a Refresh action, which is dispatched directly to the EOApplication object at the top of the controller hierarchy.
Returns:
a shared action for the collectChangesFromServer method
See Also:
RefreshActionPriority

standardRemoveActionForControllerHierarchy

public static EOAction standardRemoveActionForControllerHierarchy()
Returns a shared action (an EOAction object) for the remove method which is dispatched in the controller hierarchy.
Returns:
a shared action for the remove method
See Also:
DeleteActionPriority

standardRevertActionForControllerHierarchy

public static EOAction standardRevertActionForControllerHierarchy()
Returns a shared action (an EOAction object) for the revert method which is dispatched in the controller hierarchy.
Returns:
a shared action for the revert method
See Also:
RevertActionPriority

standardSaveActionForControllerHierarchy

public static EOAction standardSaveActionForControllerHierarchy()
Returns a shared action (an EOAction object) for the save method which is dispatched in the controller hierarchy.
Returns:
a shared action for the save method
See Also:
SaveActionPriority

standardSaveAllActionForApplication

public static EOAction standardSaveAllActionForApplication()
Returns a shared action (an EOAction object) for the saveAll method, which is dispatched directly to the EOApplication object at the top of the controller hierarchy.
Returns:
a shared action for the saveAll method
See Also:
SaveAllActionPriority

standardSaveAsActionForControllerHierarchy

public static EOAction standardSaveAsActionForControllerHierarchy()
Returns a shared action (an EOAction object) for the saveAs method which is dispatched in the controller hierarchy.
Returns:
a shared action for the saveAs method
See Also:
SaveAsActionPriority

standardSelectActionForControllerHierarchy

public static EOAction standardSelectActionForControllerHierarchy()
Returns a shared action (an EOAction object) for the select method which is dispatched in the controller hierarchy.
Returns:
a shared action for the select method
See Also:
InsertActionPriority

standardUndoActionForControllerHierarchy

public static EOAction standardUndoActionForControllerHierarchy()
Returns a shared action (an EOAction object) for the undo method which is dispatched in the controller hierarchy.
Returns:
a shared action for the undo method
See Also:
UndoActionPriority

toString

public String toString()
Returns the receiver as a string that states the receiver's method name, description path, category priority, and action priority.
Overrides:
toString in class Object
Returns:
the String representation of the receiver

toolTip

public String toolTip()

Last updated Fri Feb 21 13:15:00 PST 2003.

Copyright © 2003 Apple Computer, Inc.