|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.jvnet.flamingo.ribbon.RibbonApplicationMenuEntryPrimary
public class RibbonApplicationMenuEntryPrimary
Metadata description for the primary menu entries of the
RibbonApplicationMenu
. The primary menu entries at runtime are
represented by command menu buttons placed in the left panel of the
application menu.
There are three different types of primary entries:
ActionListener
passed to the
RibbonApplicationMenuEntryPrimary#RibbonApplicationMenuEntryPrimary(ResizableIcon, String, ActionListener, CommandButtonKind)
. When this entry is armed (with mouse rollover or via keyboard navigation),
the contents of the secondary area are cleared. The Quit
menu
item is an example of such a primary menu entry.RibbonApplicationMenuEntryPrimary.PrimaryRolloverCallback
set by the
setRolloverCallback(PrimaryRolloverCallback)
. When this entry is
armed (with mouse rollover or via keyboard navigation), the contents of the
secondary area are populated by the application callback implementation of
RibbonApplicationMenuEntryPrimary.PrimaryRolloverCallback.menuEntryActivated(javax.swing.JPanel)
. The
Open
menu item is an example of such a primary menu entry,
showing a list of recently opened files.RibbonApplicationMenuEntrySecondary
s added
with the
addSecondaryMenuGroup(String, RibbonApplicationMenuEntrySecondary...)
API. When this entry is armed (with mouse rollover or via keyboard
navigation), the secondary area shows menu buttons for the registered
secondary menu entries. The Save As
menu item is an example of
such a primary menu item, showing a list of default save formats.
Nested Class Summary | |
---|---|
static interface |
RibbonApplicationMenuEntryPrimary.PrimaryRolloverCallback
Callback that allows application code to provide custom content on the secondary panel of the RibbonApplicationMenu . |
Constructor Summary | |
---|---|
RibbonApplicationMenuEntryPrimary(ResizableIcon icon,
java.lang.String text,
java.awt.event.ActionListener mainActionListener,
JCommandButton.CommandButtonKind entryKind)
Creates the metadata description of a RibbonApplicationMenu
primary menu entry. |
Method Summary | |
---|---|
void |
addSecondaryMenuGroup(java.lang.String groupName,
RibbonApplicationMenuEntrySecondary... entries)
Adds a titled group of secondary menu entries. |
java.lang.String |
getActionKeyTip()
Returns the key tip for the action area of the command button that represents this menu entry. |
JCommandButton.CommandButtonKind |
getEntryKind()
Returns the kind of the command button that represents this menu entry. |
ResizableIcon |
getIcon()
Returns the icon of this application menu entry. |
java.awt.event.ActionListener |
getMainActionListener()
Returns the main action listener associated with this application menu entry. |
java.lang.String |
getPopupKeyTip()
Returns the key tip for the popup area of the command button that represents this menu entry. |
RibbonApplicationMenuEntryPrimary.PrimaryRolloverCallback |
getRolloverCallback()
Returns the current application callback that allows placing custom content in the secondary panel of the RibbonApplicationMenu when
this primary menu entry is activated. |
int |
getSecondaryGroupCount()
Returns the number of secondary menu groups of this primary menu entry. |
java.util.List<RibbonApplicationMenuEntrySecondary> |
getSecondaryGroupEntries(int groupIndex)
Returns an unmodifiable list of menu entries of the secondary menu group at the specified index. |
java.lang.String |
getSecondaryGroupTitleAt(int groupIndex)
Returns the title of the secondary menu group at the specified index. |
java.lang.String |
getText()
Returns the text of this application menu entry. |
boolean |
isEnabled()
Returns the enabled state of the command button that represents this menu entry. |
void |
setActionKeyTip(java.lang.String actionKeyTip)
Sets the new value for the key tip for the action area of the command button that represents this menu entry. |
void |
setEnabled(boolean isEnabled)
Sets the enabled state of the command button that represents this menu entry. |
void |
setPopupKeyTip(java.lang.String popupKeyTip)
Sets the new value for the key tip for the popup area of the command button that represents this menu entry. |
void |
setRolloverCallback(RibbonApplicationMenuEntryPrimary.PrimaryRolloverCallback rolloverCallback)
Sets the rollover callback that allows the application to place custom content in the secondary panel of the RibbonApplicationMenu when
this primary menu entry is activated. |
void |
setText(java.lang.String text)
Sets the new text for this application menu entry. |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public RibbonApplicationMenuEntryPrimary(ResizableIcon icon, java.lang.String text, java.awt.event.ActionListener mainActionListener, JCommandButton.CommandButtonKind entryKind)
RibbonApplicationMenu
primary menu entry.
icon
- The icon of this menu entry. Must be non-null
.text
- The text of this menu entry. Must be non-null
.mainActionListener
- The main action listener for this menu entry. If the entry
kind is JCommandButton.CommandButtonKind.POPUP_ONLY
, this listener
will be ignored.entryKind
- The kind of the command button that will represent this menu
entry. Must be non- null
.Method Detail |
---|
public void addSecondaryMenuGroup(java.lang.String groupName, RibbonApplicationMenuEntrySecondary... entries)
groupName
- The title of the group.entries
- The secondary menu entries belonging to this group.getSecondaryGroupCount()
,
getSecondaryGroupTitleAt(int)
,
getSecondaryGroupEntries(int)
public int getSecondaryGroupCount()
addSecondaryMenuGroup(String,
RibbonApplicationMenuEntrySecondary...)
,
getSecondaryGroupTitleAt(int)
,
getSecondaryGroupEntries(int)
public java.lang.String getSecondaryGroupTitleAt(int groupIndex)
groupIndex
- The index of a secondary menu group.
addSecondaryMenuGroup(String,
RibbonApplicationMenuEntrySecondary...)
,
getSecondaryGroupCount()
,
getSecondaryGroupEntries(int)
public java.util.List<RibbonApplicationMenuEntrySecondary> getSecondaryGroupEntries(int groupIndex)
groupIndex
- The index of a secondary menu group.
addSecondaryMenuGroup(String,
RibbonApplicationMenuEntrySecondary...)
,
getSecondaryGroupCount()
,
getSecondaryGroupTitleAt(int)
public void setRolloverCallback(RibbonApplicationMenuEntryPrimary.PrimaryRolloverCallback rolloverCallback)
RibbonApplicationMenu
when
this primary menu entry is activated.
rolloverCallback
- The new rollover callback for populating the secondary panel
of the RibbonApplicationMenu
.getRolloverCallback()
public RibbonApplicationMenuEntryPrimary.PrimaryRolloverCallback getRolloverCallback()
RibbonApplicationMenu
when
this primary menu entry is activated.
RibbonApplicationMenu
.setRolloverCallback(PrimaryRolloverCallback)
public ResizableIcon getIcon()
public java.lang.String getText()
setText(String)
public void setText(java.lang.String text)
text
- The new text for this application menu entry.getText()
public java.awt.event.ActionListener getMainActionListener()
public JCommandButton.CommandButtonKind getEntryKind()
public void setEnabled(boolean isEnabled)
isEnabled
- If true
, the command button that represents this
menu entry will be enabled, if false
, the command
button will be disabled.isEnabled
public boolean isEnabled()
true
if the command button that represents this menu
entry is enabled, false
otherwise.public java.lang.String getActionKeyTip()
setActionKeyTip(String)
,
getPopupKeyTip()
public void setActionKeyTip(java.lang.String actionKeyTip)
actionKeyTip
- The new value for the key tip for the action area of the
command button that represents this menu entry.getActionKeyTip()
,
setPopupKeyTip(String)
public java.lang.String getPopupKeyTip()
setPopupKeyTip(String)
,
getActionKeyTip()
public void setPopupKeyTip(java.lang.String popupKeyTip)
popupKeyTip
- The new value for the key tip for the popup area of the
command button that represents this menu entry.getPopupKeyTip()
,
setActionKeyTip(String)
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |