com.nomagic.actions

Class ActionsCategory

java.lang.Object

javax.swing.AbstractAction

com.nomagic.actions.NMAction

com.nomagic.actions.ActionsCategory

All Implemented Interfaces:

java.awt.event.ActionListener, java.io.Serializable, java.lang.Cloneable, java.lang.Comparable, java.util.EventListener, javax.swing.Action

Direct Known Subclasses:

MDActionsCategory, MenuAction, SelectItemAction, SetFontAction

@OpenApiAll
public class ActionsCategory
extends NMAction

This class represents some group of actions. It contains list of actions. Actions category can represent structure of menu or toolbar and it can be nested (represents sub menu).

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ACTIONS_PROPERTY Property Change event name fired when actions of this category were changed.
static java.lang.String	ADDED_ACTION_PROPERTY Property Change event name fired when new action is added.
static java.lang.String	CHANGE_ACTIONS_PROPERTY Deprecated. use ACTIONS_PROPERTY, ADDED_ACTION_PROPERTY, REMOVED_ACTION_PROPERTY
static int	MAX_CATEGORY_ACTIONS Default value limiting maximum action count in one category
static java.lang.String	REMOVED_ACTION_PROPERTY Property Change event name fired when new action is removed.
static java.lang.String	USE_AS_SEPARATOR_IN_UI A name of property to use this category as separator in UI even if it does not have inner actions

Fields inherited from class com.nomagic.actions.NMAction

ACTION_SHORTCUTS, BELONGS_TO_SEPARATE_GROUP_IN_UI, DO_NO_SHOW_ACTION_NAME_IN_UI, GENERATED_ID_PREFIX, GROUP, ID, LARGE_ICON, MENU_SHORTCUT_MASK

Fields inherited from class javax.swing.AbstractAction

changeSupport, enabled

Fields inherited from interface javax.swing.Action

ACCELERATOR_KEY, ACTION_COMMAND_KEY, DEFAULT, DISPLAYED_MNEMONIC_INDEX_KEY, LARGE_ICON_KEY, LONG_DESCRIPTION, MNEMONIC_KEY, NAME, SELECTED_KEY, SHORT_DESCRIPTION, SMALL_ICON

Constructor Summary

Constructors

Constructor and Description
ActionsCategory(java.lang.String id, java.lang.String name) Creates actions category with given name and id.
ActionsCategory(java.lang.String id, java.lang.String name, int keyCode) Creates actions category with given id, name, and key code.
ActionsCategory(java.lang.String id, java.lang.String name, int keyCode, java.lang.String group) Creates actions category with given id, name, and key code.
ActionsCategory(java.lang.String id, java.lang.String name, javax.swing.KeyStroke stroke) Creates actions category with given id, name, and key stroke.
ActionsCategory(java.lang.String id, java.lang.String name, javax.swing.KeyStroke stroke, java.lang.String group) Creates actions category with given id, name, key stroke and assigned group.

Method Summary

Modifier and Type	Method and Description
void	accept(ActionsVisitor visitor) Accepts visitor and calls visit method of visitor.
void	actionPerformed(java.awt.event.ActionEvent e) Empty implementation.
void	addAction(NMAction action) Adds the given action to the category.
void	addAction(NMAction action, int position) Adds the given action at the specified position to the category.
void	addActions(java.util.List<? extends NMAction> actions) Adds given actions to the category.
static void	breakActions(ActionsCategory category, java.util.List<? extends NMAction> actions, int maxCategorySize, java.lang.String categoryName, boolean nested) Breaks given actions into subcategories of given category if the actions number exceeds maxCategorySize.
static void	breakActions(ActionsCategory category, java.util.List<? extends NMAction> actions, int maxCategorySize, java.lang.String categoryName, boolean nested, int innerCategorySize) Breaks category into sub categories, but it has ability to specify inner category size separately
static void	breakActions(ActionsCategory category, java.util.List<NMAction> actions) Breaks given actions into subcategories of given category if the actions number exceeds predefined number.
static void	breakeActions(ActionsCategory category, java.util.List<? extends NMAction> actions, int maxCategorySize, java.lang.String categoryName, boolean nested) Deprecated. use breakActions(ActionsCategory, java.util.List, int, String, boolean)
java.lang.Object	clone() Clones the category.
NMAction	getAction(java.lang.String actionID) Find direct action with given ID
java.util.List<NMAction>	getActions() Returns the list of the owned actions.
java.util.List<NMAction>	getActionsRecursively(boolean includeCategories) Returns all simple actions (not ActionsCategory) recursively.
java.util.List<ActionsCategory>	getCategories() Gets inner action categories.
boolean	isDisplayHeader()
boolean	isEmpty()
boolean	isNested() Returns value of nested flag.
boolean	isUseActionForDisable() Returns value of nested flag.
void	removeAction(NMAction action) Removes the given action from the category.
void	setActions(java.util.List<? extends NMAction> actions) Sets the list of the new actions overriding old actions.
void	setDisplayHeader(boolean displayHeader) Display category name as header of category.
void	setNested(boolean nested) Sets new value of nested flag.
void	setUseActionForDisable(boolean use)
java.lang.Object	shallowClone() Clones the category.
int	size() Size of category - number of inner actions.
void	sort()

Methods inherited from class com.nomagic.actions.NMAction

addPropertyChangeListener, addShortcut, addShotcut, addWeakPropertyChangeListener, compareTo, createMenuItem, equals, firePropertyChange, getCommandKey, getDescription, getGroup, getIcon, getID, getLargeIcon, getLargeOrSmallIcon, getMnemonicKey, getName, getPropertyChangeListeners, getShortcuts, getSmallIcon, getSmallOrLargeIcon, hashCode, isIDGenerated, removePropertyChangeListener, removeShortcut, removeWeakPropertyChangeListener, setDescription, setGroup, setLargeIcon, setMnemonicKey, setName, setShortcuts, setSmallIcon, toString, updateState

Methods inherited from class javax.swing.AbstractAction

getKeys, getValue, isEnabled, putValue, setEnabled

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

USE_AS_SEPARATOR_IN_UI

public static final java.lang.String USE_AS_SEPARATOR_IN_UI

A name of property to use this category as separator in UI even if it does not have inner actions

See Also:

Constant Field Values

MAX_CATEGORY_ACTIONS

public static final int MAX_CATEGORY_ACTIONS

Default value limiting maximum action count in one category

See Also:

Constant Field Values

ADDED_ACTION_PROPERTY

public static final java.lang.String ADDED_ACTION_PROPERTY

Property Change event name fired when new action is added.

See Also:

addAction(NMAction), addAction(NMAction, int), Constant Field Values

REMOVED_ACTION_PROPERTY

public static final java.lang.String REMOVED_ACTION_PROPERTY

Property Change event name fired when new action is removed.

See Also:

removeAction(NMAction), Constant Field Values

ACTIONS_PROPERTY

public static final java.lang.String ACTIONS_PROPERTY

Property Change event name fired when actions of this category were changed.

See Also:

setActions(List), Constant Field Values

CHANGE_ACTIONS_PROPERTY

@Deprecated
public static final java.lang.String CHANGE_ACTIONS_PROPERTY

Deprecated. use ACTIONS_PROPERTY, ADDED_ACTION_PROPERTY, REMOVED_ACTION_PROPERTY

Property Change event name fired when actions of this category were changed.

See Also:

Constant Field Values

Constructor Detail

ActionsCategory

public ActionsCategory(@CheckForNull
                       java.lang.String id,
                       @CheckForNull
                       java.lang.String name)

Creates actions category with given name and id.

Parameters:

id - the id of the category.

name - the name of the category.

ActionsCategory

public ActionsCategory(@CheckForNull
                       java.lang.String id,
                       @CheckForNull
                       java.lang.String name,
                       @CheckForNull
                       javax.swing.KeyStroke stroke)

Creates actions category with given id, name, and key stroke.

Parameters:

id - the id of the category.

name - the name of the category.

stroke - key stroke used for invoking action category.

ActionsCategory

public ActionsCategory(@CheckForNull
                       java.lang.String id,
                       @CheckForNull
                       java.lang.String name,
                       @CheckForNull
                       javax.swing.KeyStroke stroke,
                       @CheckForNull
                       java.lang.String group)

Creates actions category with given id, name, key stroke and assigned group.

Parameters:

id - the id of the category.

name - the name of the category.

stroke - key stroke used for invoking action category.

group - the name of the related commands group.

ActionsCategory

public ActionsCategory(@CheckForNull
                       java.lang.String id,
                       @CheckForNull
                       java.lang.String name,
                       int keyCode)

Creates actions category with given id, name, and key code.

Parameters:

id - the id of the category.

name - the name of the category.

keyCode - key stroke used for invoking action category.

ActionsCategory

public ActionsCategory(@CheckForNull
                       java.lang.String id,
                       @CheckForNull
                       java.lang.String name,
                       int keyCode,
                       @CheckForNull
                       java.lang.String group)

Creates actions category with given id, name, and key code.

Parameters:

id - the id of the category.

name - the name of the category.

keyCode - key stroke used for invoking action category.

group - the name of the related commands group.

Method Detail

addAction

public void addAction(@CheckForNull
                      NMAction action)

Adds the given action to the category. Fires ADDED_ACTION_PROPERTY property change event, where new value is added action. Fires CHANGE_ACTIONS_PROPERTY (for backward compatibility) property change event, where old value is old actions list, new value is new actions list.

Overrides:

addAction in class NMAction

Parameters:

action - the given action to add, parameter can be null.

addActions

public void addActions(java.util.List<? extends NMAction> actions)

Adds given actions to the category. Fires ACTIONS_PROPERTY (and CHANGE_ACTIONS_PROPERTY for backward compatibility) property change event, where old value is old actions list, new value is new actions list.

Parameters:

actions - the given actions to add, parameter can be null.

addAction

public void addAction(@CheckForNull
                      NMAction action,
                      int position)

Adds the given action at the specified position to the category. Fires ADDED_ACTION_PROPERTY property change event, where new value is added action. Fires CHANGE_ACTIONS_PROPERTY (for backward compatibility) property change event, where old value is old actions list, new value is new actions list.

Parameters:

action - the given action to add, parameter can be null.

position - the given position to be added.

removeAction

public void removeAction(@CheckForNull
                         NMAction action)

Removes the given action from the category. Fires REMOVED_ACTION_PROPERTY property change event, where old value is removed action. Fires CHANGE_ACTIONS_PROPERTY (for backward compatibility) property change event, where old value is old actions list, new value is new actions list.

Overrides:

removeAction in class NMAction

Parameters:

action - the given action to remove, parameter can be null.

getActions

public java.util.List<NMAction> getActions()

Returns the list of the owned actions.

Overrides:

getActions in class NMAction

Returns:

the cloned list of the actions.

getCategories

public java.util.List<ActionsCategory> getCategories()

Gets inner action categories.

Returns:

a list of action categories.

getActionsRecursively

public java.util.List<NMAction> getActionsRecursively(boolean includeCategories)

Returns all simple actions (not ActionsCategory) recursively.

Parameters:

includeCategories - If true, then ActionsCategories will be included in the list

Returns:

all actions recursively

setActions

public void setActions(java.util.List<? extends NMAction> actions)

Sets the list of the new actions overriding old actions. Fires ACTIONS_PROPERTY (and CHANGE_ACTIONS_PROPERTY for backward compatibility) property change event, where old value is old actions list, new value is new actions list.

Overrides:

setActions in class NMAction

Parameters:

actions - the new list of the actions.

clone

public java.lang.Object clone()

Clones the category. During clone does not fires any property change events. Does deep clone.

Overrides:

clone in class NMAction

Returns:

deep clone of category.

shallowClone

public java.lang.Object shallowClone()

Clones the category. During clone does not fires any property change events. Does deep clone.

Overrides:

shallowClone in class NMAction

Returns:

deep clone of category.

setNested

public void setNested(boolean nested)

Sets new value of nested flag. Flag indicates that children of this action is nested elements. When representing this action as menu, nested action means new sub menu. Not nested means group(usually separated by some menu separator).

Parameters:

nested - new value of nested flag.

isNested

public boolean isNested()

Returns value of nested flag.

Returns:

true if this category is nested.

See Also:

setNested(boolean)

accept

public void accept(ActionsVisitor visitor)

Accepts visitor and calls visit method of visitor.

Overrides:

accept in class NMAction

Parameters:

visitor - ActionsVisitor.

actionPerformed

public void actionPerformed(java.awt.event.ActionEvent e)

Empty implementation.

Specified by:

actionPerformed in interface java.awt.event.ActionListener

Specified by:

actionPerformed in class NMAction

Parameters:

e - event caused this action execution.

setUseActionForDisable

public void setUseActionForDisable(boolean use)

Parameters:

use - if true, menus created from this category will be disabled if all children are disabled.

See Also:

mUseActionForDisable

isUseActionForDisable

public boolean isUseActionForDisable()

Returns value of nested flag.

Returns:

value of mUseActionForDisable field

See Also:

(boolean)

breakActions

public static void breakActions(ActionsCategory category,
                                java.util.List<NMAction> actions)

Breaks given actions into subcategories of given category if the actions number exceeds predefined number.

Parameters:

category - category to add created inner categories

actions - actions to break into categories

breakeActions

@Deprecated
public static void breakeActions(ActionsCategory category,
                                             java.util.List<? extends NMAction> actions,
                                             int maxCategorySize,
                                             java.lang.String categoryName,
                                             boolean nested)

Deprecated. use breakActions(ActionsCategory, java.util.List, int, String, boolean)

breakActions

public static void breakActions(ActionsCategory category,
                                java.util.List<? extends NMAction> actions,
                                int maxCategorySize,
                                java.lang.String categoryName,
                                boolean nested)

Breaks given actions into subcategories of given category if the actions number exceeds maxCategorySize.

Parameters:

category - category to add created inner categories

actions - actions to break into categories

maxCategorySize - max size of inner category

categoryName - subcategory name

nested - make nested subcategories

breakActions

public static void breakActions(ActionsCategory category,
                                java.util.List<? extends NMAction> actions,
                                int maxCategorySize,
                                java.lang.String categoryName,
                                boolean nested,
                                int innerCategorySize)

Breaks category into sub categories, but it has ability to specify inner category size separately

Parameters:

category - category to add created inner categories

actions - actions to break into categories

maxCategorySize - max size of inner category

categoryName - subcategory name

nested - make nested subcategories

innerCategorySize - maximum size of inner category

sort

public void sort()

getAction

@CheckForNull
public NMAction getAction(java.lang.String actionID)

Find direct action with given ID

Parameters:

actionID - action ID

Returns:

a list of action categories.

isEmpty

public boolean isEmpty()

Returns:

true if this category contains no actions at all

isDisplayHeader

public boolean isDisplayHeader()

Returns:

display header flag

setDisplayHeader

public void setDisplayHeader(boolean displayHeader)

Display category name as header of category. This has affect only if category is not nested

Parameters:

displayHeader - display header of not nested menu

size

public int size()

Size of category - number of inner actions.

Returns:

size of category