public class TLcyActionBarUtil extends Object
A class containing static utility methods to facilitate working with action bars.
When you encounter a problem related to actions or active settables and action bars like for example action which do not appear, appear in the wrong location, appear in the wrong order, ...
the TLcyDebugAddOn
can be of great help.
The most important methods of this class are illustrated in the Lucy developer guide in the "Modifying the menu and tool bars" chapter. This chapter contains code examples for all common operations with action bars.
The most important functions of this class are:
insertInConfiguredActionBars
methods allow you to pass in an action or active settable and the configuration file,
and the item will automatically be inserted in all action bars which are present in the configuration file.
setupAsConfiguredActionBar
method allows you to create your own action bar in which actions can be inserted using the insertInConfiguredActionBars
methods.
This also allows to configure existing actions to appear in it.
Note: when you run into problems with action bars, you could try the debugging options outlined
in the class javadoc of TLcyActionBarMediatorBuilder
.
TLcyActionBarManager
,
TLcyActionBarMediatorBuilder
Modifier and Type | Field and Description |
---|---|
static String |
ID_KEY
The key with which the ActionID is saved in an action or active settable.
|
Modifier and Type | Method and Description |
---|---|
static ILcdAction |
createGlobalProxyAction(String aActionID,
String aActionBarID,
TLcyActionBarManager aActionBarManager)
Creates an action that delegates its behaviour to the action in the active context.
|
static ILcyActiveSettable |
createGlobalProxyActiveSettable(String aActiveSettableID,
String aActionBarID,
TLcyActionBarManager aActionBarManager)
Equivalent of
createGlobalProxyAction(String, String,
TLcyActionBarManager) for ILcyActiveSettable . |
static ILcdAction |
findAction(String aActionID,
ILcyActionBar aActionBar)
Method which loops over all actions present in
aActionBar , and returns the action with value
aActionID for the key ID_KEY . |
static ILcdAction |
findAction(String aActionID,
String aActionBarID,
Object aActionBarContext,
TLcyActionBarManager aActionBarManager)
Returns the action with id
aActionID from the action bar identified by aActionBarID and aActionBarContext . |
static Object |
findActionItem(String aActionID,
ILcyActionBar aActionBar)
Searches for the
ILcdAction or ILcyActiveSettable corresponding to
the given aActionID in the given aActionBar . |
static ILcyActiveSettable |
findActiveSettable(String aActiveSettableID,
ILcyActionBar aActionBar)
Method which loops over all active settables present in
aActionBar , and returns the active settable with value
aActiveSettableID for the key ID_KEY . |
static ILcyActiveSettable |
findActiveSettable(String aActiveSettableID,
String aActionBarID,
Object aActionBarContext,
TLcyActionBarManager aActionBarManager)
Returns the active settable with id
aActiveSettableID from the action bar identified by aActionBarID and aActionBarContext . |
static Object |
findFirstDefaultActionItem(ILcyActionBar aActionBar)
Searches for the first default
ILcdAction or ILcyActiveSettable
in the given aActionBar . |
static ILcdAction |
findWrapperAction(ILcdAction aAction,
ILcyActionBar aActionBar)
Searches for the
ILcdAction corresponding to
the given aAction in the given aActionBar . |
static ILcyActiveSettable |
findWrapperActiveSettable(ILcyActiveSettable aActiveSettable,
ILcyActionBar aActionBar)
Searches for the
ILcyActiveSettable corresponding to
the given aActiveSettable in the given aActionBar . |
static String[] |
getConfiguredActionBarIDs(ALcyProperties aConfiguration,
String aID)
Searches the given configuration for the ID's of the action bars in which an action with the
given ID would be inserted.
|
static void |
insertInConfiguredActionBars(ILcdAction aAction,
Object aContext,
TLcyActionBarManager aActionBarManager,
ALcyProperties aConfiguration)
Inserts the given action in all the configured action bars.
|
static void |
insertInConfiguredActionBars(ILcyActiveSettable aActiveSettable,
Object aContext,
TLcyActionBarManager aActionBarManager,
ALcyProperties aConfiguration)
Equivalent of
insertInConfiguredActionBars(ILcdAction, Object,
TLcyActionBarManager, ALcyProperties) for
ILcyActiveSettable . |
static void |
insertInConfiguredActionBars(ILcyActiveSettable aActiveSettable,
Object aContext,
TLcyActionBarManager aActionBarManager,
ALcyProperties aConfiguration,
boolean aDeactivatePossible)
Equivalent of
insertInConfiguredActionBars(ILcdAction, Object,
TLcyActionBarManager, ALcyProperties) for
ILcyActiveSettable . |
static void |
mediate(ILcyActionBar aFirst,
ILcyActionBar aSecond)
Deprecated.
The recommended way to mediate between two action bars is to use the
TLcyActionBarMediatorBuilder
class |
static void |
mediate(ILcyActionBar aSource,
ILcyActionBar aTarget,
boolean aBidirectional)
Deprecated.
The recommended way to mediate between two action bars is to use the
TLcyActionBarMediatorBuilder
class |
static void |
mediate(ILcyActionBar aTargetActionBar,
String aActionBarID,
boolean aMerge,
TLcyActionBarManager aActionBarManager)
Deprecated.
The recommended way to mediate between two action bars is to use the
TLcyActionBarMediatorBuilder
class |
static void |
mediate(ILcyActionBar aTargetActionBar,
String aActionBarID,
Object aContext,
TLcyActionBarManager aActionBarManager)
Deprecated.
The recommended way to mediate between two action bars is to use the
TLcyActionBarMediatorBuilder
class |
static ILcdDisposable |
mediateAcceleratorKeys(ILcyActionBar aActionBar,
JComponent aTargetComponent)
Mediates the accelerator keys between the
ILcyActionBar and the
JComponent . |
static void |
removeFromConfiguredActionBars(ILcdAction aAction,
Object aContext,
TLcyActionBarManager aActionBarManager,
ALcyProperties aProperties)
Removes the given action from all the action bars in which it would
have been inserted by
insertInConfiguredActionBars(ILcdAction, Object, TLcyActionBarManager, ALcyProperties) . |
static void |
removeFromConfiguredActionBars(ILcyActiveSettable aActiveSettable,
Object aContext,
TLcyActionBarManager aActionBarManager,
ALcyProperties aProperties)
Removes the given active settable from all the action bars in which it would
have been inserted by
insertInConfiguredActionBars(ILcyActiveSettable, Object, TLcyActionBarManager, ALcyProperties) . |
static ILcdDisposable |
setupAsConfiguredActionBar(ILcyActionBar aActionBarSFCT,
String aActionBarID,
Object aContext,
ALcyProperties aProperties,
String aPropertiesPrefix,
JComponent aTargetAcceleratorKeysComponent,
TLcyActionBarManager aActionBarManager)
Utility method to setup an
ILcyActionBar as 'configured action bar' designed to contain actions and active settables for the specified context. |
public static final String ID_KEY
The key with which the ActionID is saved in an action or active settable. The ID is for example
used in
insertInConfiguredActionBars
.
ILcdAction action = ...;
String actionID = "MyAddOn.someAction"; //prefix used in config file
action.putValue(TLcyActionBarUtil.ID_KEY, actionID);
When configuring actions,
TLcyDebugAddOn
can be of great help.
public static ILcdDisposable setupAsConfiguredActionBar(ILcyActionBar aActionBarSFCT, String aActionBarID, Object aContext, ALcyProperties aProperties, String aPropertiesPrefix, JComponent aTargetAcceleratorKeysComponent, TLcyActionBarManager aActionBarManager)
Utility method to setup an ILcyActionBar
as 'configured action bar' designed to contain actions and active settables for the specified context.
You typically call this method when you created your own action bar to insert into the UI, and you want it to behave like the standard Lucy action bars. Consult the "Modifying the menu and tool bars" chapter in the Lucy developer guide for more information.
This method will ensure that:
aActionBarSFCT
.null
, the action bar will also contain all global actions and active settables registered for aActionBarID
.
The major benefit is that this allows you to configure global actions (e.g. File | New | Map ) into a map specific action bar like the map tool bar.
aActionBarSFCT
is an ALcyActionBar
instance.
aTargetAcceleratorKeysComponent
.
Triggering the accelerator key of such action or active settable on aTargetAcceleratorKeysComponent
will trigger the corresponding action or active settable.
aActionBarSFCT
- The action bar.
Must not be null
.
The sorting defined in aProperties
will only be respected when this is a ALcyActionBar
instance.aActionBarID
- The ID for the action baraContext
- The context for the action bar.
Typically null
or an ILcyGenericMapComponent
aProperties
- The properties instance containing the settings of the action bar.
Consult the javadoc of ALcyActionBar.setProperties(ALcyProperties)
for more information.aPropertiesPrefix
- The prefix used in aProperties
aTargetAcceleratorKeysComponent
- The component that should respond to pressing accelerator keys (a.k.a. hot keys) that are configured in the action bar.
This is typically the panel to which the action bar 'belongs'.
For example, the map tool bar would provide the map here.
May be null
.aActionBarManager
- The action bar managerILcdDisposable
, allowing to clean up all bindings between aActionBarSFCT
and aTargetAcceleratorKeysComponent
.
In most cases you can ignore the return value.
You only need to call dispose on the ILcdDisposable
when the lifetime of
aActionBarSFCT
is different from the lifetime of aTargetAcceleratorKeysComponent
.
In that case, you need to dispose the disposable when one of both instances is end-of-life.public static ILcdDisposable mediateAcceleratorKeys(ILcyActionBar aActionBar, JComponent aTargetComponent)
Mediates the accelerator keys between the ILcyActionBar
and the
JComponent
. All existing and future ILcdAction
and
ILcyActiveSettable
accelerator keys will be added in the action map of the
JComponent
, and triggering the accelerator key on the JComponent
will
trigger the corresponding ILcdAction
or ILcyActiveSettable
.
Suppose there is a UI panel with some functionality, and it contains a tool bar. If a short cut key is used while the focus is in one of the sub-components of the panel, you probably want it to trigger the respective tool bar action. For this to work, this method needs to be called.
aActionBar
- The action bar. Must not be null
aTargetComponent
- The target component. Must not be null
ILcdDisposable
, allowing to stop mediating the two instances. Calling
the ILcdDisposable.dispose()
method will clean up all bindings
between aActionBar
and aTargetComponent
, and will remove all
accelerator keys of aActionBar
from aTargetComponent
.
Typically the life time of aActionBar
and aTargetComponent
is
the same. In such case, there is no need to call the dispose method.@Deprecated public static void mediate(ILcyActionBar aFirst, ILcyActionBar aSecond)
TLcyActionBarMediatorBuilder
classMediates between the two given action bars. Short for:
TLcyActionBarMediatorBuilder.newInstance(aActionBarManager)
.sourceActionBar(aFirst)
.targetActionBar(aSecond)
.bidirectional()
.mediate();
Consult the documentation of TLcyActionBarMediatorBuilder
for more information.
aFirst
- The first action bar.
Note that this method will only keep a WeakReference
to this action bar.aSecond
- The second action bar.
Note that this method will only keep a WeakReference
to this action bar.@Deprecated public static void mediate(ILcyActionBar aSource, ILcyActionBar aTarget, boolean aBidirectional)
TLcyActionBarMediatorBuilder
classMediates between the two given action bars. Short for:
TLcyActionBarMediatorBuilder mediator = TLcyActionBarMediatorBuilder.newInstance( aActionBarManager )
.sourceActionBar(aSource)
.targetActionBar(aTarget);
if ( aBidirectional ){
mediator.bidirectional();
}
mediator.mediate();
Consult the documentation of TLcyActionBarMediatorBuilder
for more information.
Note that if bidirectional synchronization is required, it is not valid to call this
method twice with aBidirectional
set to false
, e.g.
mediate( aBar, aOtherBar, false );
mediate( aOtherBar, aBar, false );
aSource
- The action bar with which the other action bar should be mediated. It
should not be null
. Note that this method will only keep a
WeakReference
to this action bar.aTarget
- The action bar with which aSource
should be mediated. It must
not be null
. Note that this method will only keep a
WeakReference
to this action bar.aBidirectional
- true
if synchronization between the two actions bars should
happen in both directions, false
to only synchronize from
source to target.@Deprecated public static void mediate(ILcyActionBar aTargetActionBar, String aActionBarID, boolean aMerge, TLcyActionBarManager aActionBarManager)
TLcyActionBarMediatorBuilder
classMediates between the two given action bars. Short for:
if ( aMerge ) {
TLcyActionBarMediatorBuilder.newInstance(aActionBarManager)
.sourceActionBarIncludingActiveContexts(aActionBarID)
.targetActionBar(aTargetActionBar)
.bidirectional()
.mediate();
} else {
TLcyActionBarMediatorBuilder.newInstance(aActionBarManager)
.sourceActionBar(aActionBarID, null)
.targetActionBar(aTargetActionBar)
.bidirectional()
.mediate();
}
Consult the documentation of TLcyActionBarMediatorBuilder
for more information.
aTargetActionBar
- The ILcyActionBar
to which the actions of the global
action bar, and possibly the actions of the action bars of the active
contexts, should be added. Note that this method will only keep a
WeakReference
to this action bar.aActionBarID
- The ID of the action bar in the action manager.aMerge
- If true
, the actions of the action bars of the active
contexts will also be added to the given aTargetActionBar
.
If false
, this method acts exactly as
mediate(aTargetActionBar, aActionBarID, null,aActionBarManager)
aActionBarManager
- The action bar manager containing the requested action bars.TLcyActionBarManager.getActionBar(String, Object)
,
TLcyActionBarManager.getActiveContextCount()
@Deprecated public static void mediate(ILcyActionBar aTargetActionBar, String aActionBarID, Object aContext, TLcyActionBarManager aActionBarManager)
TLcyActionBarMediatorBuilder
classMediates between the two given action bars. Short for:
TLcyActionBarMediatorBuilder.newInstance(aActionBarManager)
.sourceActionBar(aActionBarID, aContext)
.targetActionBar(aTargetActionBar)
.bidirectional()
.mediate();
Consult the documentation of TLcyActionBarMediatorBuilder
for more information.
aTargetActionBar
- The action bar with which the other action bar should be mediated. It
should not be null
. Note that this method will only keep a
WeakReference
to this action bar.aActionBarID
- The ID of the action bar in the TLcyActionBarManager
.aContext
- The context of the action bar in the TLcyActionBarManager
.aActionBarManager
- The action bar manager.TLcyActionBarManager.getActionBar(String, Object)
public static ILcdAction findAction(String aActionID, String aActionBarID, Object aActionBarContext, TLcyActionBarManager aActionBarManager)
Returns the action with id aActionID
from the action bar identified by aActionBarID
and aActionBarContext
.
TLcyActionBarUtil.findAction(aActionID, aActionBarManager.getActionBar(aActionBarID, aActionBarContext))
aActionID
- The id of the actionaActionBarID
- The id of the action baraActionBarContext
- The context of the action baraActionBarManager
- The action bar managernull
when not foundfindAction(String, ILcyActionBar)
public static ILcdAction findAction(String aActionID, ILcyActionBar aActionBar)
Method which loops over all actions present in aActionBar
, and returns the action with value
aActionID
for the key ID_KEY
.
aActionID
- The id of the searched actionaActionBar
- The action bar to searchnull
when no such action exists in aActionBar
.findAction(String, String, Object, TLcyActionBarManager)
public static ILcyActiveSettable findActiveSettable(String aActiveSettableID, String aActionBarID, Object aActionBarContext, TLcyActionBarManager aActionBarManager)
Returns the active settable with id aActiveSettableID
from the action bar identified by aActionBarID
and aActionBarContext
.
TLcyActionBarUtil.findActiveSettable(aActiveSettableID, aActionBarManager.getActionBar(aActionBarID, aActionBarContext))
aActiveSettableID
- The id of the active settableaActionBarID
- The id of the action baraActionBarContext
- The context of the action baraActionBarManager
- The action bar managernull
when not foundfindActiveSettable(String, ILcyActionBar)
public static ILcyActiveSettable findActiveSettable(String aActiveSettableID, ILcyActionBar aActionBar)
Method which loops over all active settables present in aActionBar
, and returns the active settable with value
aActiveSettableID
for the key ID_KEY
.
aActiveSettableID
- The id of the searched active settableaActionBar
- The action bar to searchnull
when no such active settable exists in aActionBar
.findActiveSettable(String, String, Object, TLcyActionBarManager)
public static String[] getConfiguredActionBarIDs(ALcyProperties aConfiguration, String aID)
Searches the given configuration for the ID's of the action bars in which an action with the given ID would be inserted.
For instance, if the the id is 'YourAddOn.yourAction'
, and the configuration
contains following keys:
YourAddOn.yourAction.fooBar.item=...
...
YourAddOn.yourAction.yourActionBar.item=...
...
YourAddOn.yourAction.menuBar.item=...
...
Then the returned ids would be {"fooBar", "yourActionBar", "menuBar"}
.
aConfiguration
- The configuration in which to look for the action bar IDs. It must not be
null
.aID
- The ID of the action or active settable for which to retrieve the
configured action bars. It must not be null
. Note that is
should be the ID of the action or active settable without the
trailing dot.null
. It may be an empty array with length zero.public static void insertInConfiguredActionBars(ILcdAction aAction, Object aContext, TLcyActionBarManager aActionBarManager, ALcyProperties aConfiguration)
Inserts the given action in all the configured action bars. The IDs of the configured action
bars (e.g. 'menuBar', 'toolBar') are retrieved using the getConfiguredActionBarIDs
method. The 'ActionID' of the action or active settable itself (that is, the ID passed to
getConfiguredActionBarIDs
) is taken from the given ILcdAction
using
aAction.getValue(ID_KEY)
. So the properties to configure an action could for
example look like this:
ActionID.menuBar.item = Menu, Action
ActionID.menuBar.groups = MenuGroup, ActionGroup
ActionID.menuBar.acceleratorKey = ctrl A
ActionID.menuBar.smallIcon = someIcon.png
ActionID.toolBar.item = Action
ActionID.toolBar.groups = ActionGroup
ActionID.toolBar.smallIcon = someLargerIcon.png
which inserts the action into the bar named 'menuBar' and into the bar named 'toolBar'. In the
'menuBar' the action is in the sub-menu 'Menu' and has an accelerator key. On the 'toolBar',
the action is represented using a larger icon 'someLargerIcon.png'.
The given ILcdAction
is not inserted directly, but instead wrapped by another
ILcdAction
that prevents the values set with putValue
on the wrapper
action to be set on the original action. Since these values determine the name, icon, short
description etc. of the action, wrapping the original action allows it to be configured to look
different in the different menu and tool bars.
aAction
- The action to insert into the configured action bars. It must not be
null
. It must have a unique ID as value for the ID_KEY
key. This ID is used to retrieve the configured action bars
(e.g. 'menuBar', 'toolBar'), as specified in
getConfiguredActionBarIDs
. This action is wrapped by
another action to allow for different names, icons, short
descriptions, ... in the different action bars.aContext
- The context for the action bars. If this context is null
,
the global context is used. Refer to the TLcyActionBarManager
for more details about contexts.aActionBarManager
- The TLcyActionBarManager
that should be used to retrieve
the action bars. One can be retrieved using ILcyLucyEnv.getUserInterfaceManager().getActionBarManager()
.aConfiguration
- The ALcyProperties
instance containing the configuration
of the action. Can for example be parsed from a file like this:
new TLcyStringPropertiesCodec().decode("myConfigFile.cfg")
getConfiguredActionBarIDs(ALcyProperties, String)
public static void insertInConfiguredActionBars(ILcyActiveSettable aActiveSettable, Object aContext, TLcyActionBarManager aActionBarManager, ALcyProperties aConfiguration)
insertInConfiguredActionBars(ILcdAction, Object,
TLcyActionBarManager, ALcyProperties)
for
ILcyActiveSettable
.public static void insertInConfiguredActionBars(ILcyActiveSettable aActiveSettable, Object aContext, TLcyActionBarManager aActionBarManager, ALcyProperties aConfiguration, boolean aDeactivatePossible)
insertInConfiguredActionBars(ILcdAction, Object,
TLcyActionBarManager, ALcyProperties)
for
ILcyActiveSettable
.aDeactivatePossible
- Specifies whether one should be able to deactivate the given
ILcyActiveSettable
.public static ILcdAction createGlobalProxyAction(String aActionID, String aActionBarID, TLcyActionBarManager aActionBarManager)
Creates an action that delegates its behaviour to the action in the active context. The
action is specified by the given aActionID
. If no action can be found in any of
the active contexts with the specified ID, the action returned by this method is disabled.
aActionID
- The ID of the action to which the behaviour should be delegated.
Should not be null
.aActionBarID
- The ID of the action bar in which the specified action can be found.
Should not be null
.aActionBarManager
- The action bar manager in which the specified action bar can be found.
Should not be null
.null
.TLcyActionBarManager.getActiveContext(int)
public static ILcyActiveSettable createGlobalProxyActiveSettable(String aActiveSettableID, String aActionBarID, TLcyActionBarManager aActionBarManager)
Equivalent of createGlobalProxyAction(String, String,
TLcyActionBarManager)
for ILcyActiveSettable
.
public static Object findFirstDefaultActionItem(ILcyActionBar aActionBar)
Searches for the first default ILcdAction
or ILcyActiveSettable
in the given aActionBar
. A default action has its Action.DEFAULT
property
set to true.
aActionBar
- The ILcyActionBar
in which to search for the specified
ILcdAction
or ILcyActiveSettable
. Should not be
null
.ILcdAction
or ILcyActiveSettable
if it
could be found, null
otherwise.public static Object findActionItem(String aActionID, ILcyActionBar aActionBar)
Searches for the ILcdAction
or ILcyActiveSettable
corresponding to
the given aActionID
in the given aActionBar
.
aActionID
- The ID of the ILcdAction
or ILcyActiveSettable
for
which to search. Should not be null
.aActionBar
- The ILcyActionBar
in which to search for the specified
ILcdAction
or ILcyActiveSettable
. Should not be
null
.ILcdAction
or ILcyActiveSettable
for the given ID if it
could be found, null
otherwise.public static ILcdAction findWrapperAction(ILcdAction aAction, ILcyActionBar aActionBar)
Searches for the ILcdAction
corresponding to
the given aAction
in the given aActionBar
.
This method either returns aAction
itself, a proxy action that delegates its
behaviour to aAction
, or null if no such actions could be found
aAction
- An ILcdAction
for
which to search. Should not be null
.aActionBar
- The ILcyActionBar
in which to search for the specified
ILcdAction
. Should not be
null
.ILcdAction
for the given aAction if it
could be found, null
otherwise.public static ILcyActiveSettable findWrapperActiveSettable(ILcyActiveSettable aActiveSettable, ILcyActionBar aActionBar)
Searches for the ILcyActiveSettable
corresponding to
the given aActiveSettable
in the given aActionBar
.
This method either returns aActiveSettable
itself, a proxy active settable that
delegates its behaviour to aActiveSettable
, or null if no such active settables
could be found
aActiveSettable
- An ILcyActiveSettable
for
which to search. Should not be null
.aActionBar
- The ILcyActionBar
in which to search for the specified
ILcyActiveSettable
. Should not be
null
.ILcyActiveSettable
for the given aActiveSettable if it
could be found, null
otherwise.public static void removeFromConfiguredActionBars(ILcdAction aAction, Object aContext, TLcyActionBarManager aActionBarManager, ALcyProperties aProperties)
Removes the given action from all the action bars in which it would
have been inserted by insertInConfiguredActionBars(ILcdAction, Object, TLcyActionBarManager, ALcyProperties)
.
aAction
- The action to remove from the configured action bars. It must not be
null
. It must have a unique ID as value for the ID_KEY
key. This ID is used to retrieve the configured action bars
(e.g. 'menuBar', 'toolBar'), as specified in
getConfiguredActionBarIDs
.aContext
- The context for the action bars. If this context is null
,
the global context is used. Refer to the TLcyActionBarManager
for more details about contexts.aActionBarManager
- The TLcyActionBarManager
that should be used to retrieve
the action bars. One can be retrieved using ILcyLucyEnv.getUserInterfaceManager().getActionBarManager()
.aProperties
- The ALcyProperties
instance containing the configuration
of the actions. Can for example be parsed from a file like this:
new TLcyStringPropertiesCodec().decode("myConfigFile.cfg")
public static void removeFromConfiguredActionBars(ILcyActiveSettable aActiveSettable, Object aContext, TLcyActionBarManager aActionBarManager, ALcyProperties aProperties)
Removes the given active settable from all the action bars in which it would
have been inserted by insertInConfiguredActionBars(ILcyActiveSettable, Object, TLcyActionBarManager, ALcyProperties)
.
aActiveSettable
- The active settable to remove from the configured action bars. It must not be
null
. It must have a unique ID as value for the ID_KEY
key. This ID is used to retrieve the configured action bars
(e.g. 'menuBar', 'toolBar'), as specified in
getConfiguredActionBarIDs
.aContext
- The context for the action bars. If this context is null
,
the global context is used. Refer to the TLcyActionBarManager
for more details about contexts.aActionBarManager
- The TLcyActionBarManager
that should be used to retrieve
the action bars. One can be retrieved using ILcyLucyEnv.getUserInterfaceManager().getActionBarManager()
.aProperties
- The ALcyProperties
instance containing the configuration
of the actions. Can for example be parsed from a file like this:
new TLcyStringPropertiesCodec().decode("myConfigFile.cfg")