|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--java.awt.Component | +--java.awt.Container | +--javax.swing.JComponent | +--javax.swing.JMenuBar
An implementation of a menu bar. You add JMenu
objects to the
menu bar to construct a menu. When the user selects a JMenu
object, its associated JPopupMenu
is displayed, allowing the
user to select one of the JMenuItems
on it.
For information and examples of using menu bars see How to Use Menus, a section in The Java Tutorial. For the keyboard keys used by this component in the standard Look and Feel (L&F) renditions, see the JMenuBar key assignments.
Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. A future release of Swing will provide support for long term persistence.
JMenu
,
JPopupMenu
,
JMenuItem
, Serialized FormInner Class Summary | |
protected class |
JMenuBar.AccessibleJMenuBar
This class implements accessibility support for the JMenuBar class. |
Inner classes inherited from class javax.swing.JComponent |
JComponent.AccessibleJComponent |
Inner classes inherited from class java.awt.Container |
Container.AccessibleAWTContainer |
Inner classes inherited from class java.awt.Component |
Component.AccessibleAWTComponent |
Fields inherited from class javax.swing.JComponent |
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW |
Fields inherited from class java.awt.Component |
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT |
Fields inherited from interface java.awt.image.ImageObserver |
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH |
Constructor Summary | |
JMenuBar()
Creates a new menu bar. |
Method Summary | |
JMenu |
add(JMenu c)
Appends the specified menu to the end of the menu bar. |
void |
addNotify()
Overrides JComponent.addNotify to register this
menu bar with the current keyboard manager. |
AccessibleContext |
getAccessibleContext()
Gets the AccessibleContext associated with this JMenuBar. |
Component |
getComponent()
Implemented to be a MenuElement . |
Component |
getComponentAtIndex(int i)
Deprecated. replaced by getComponent(int i) |
int |
getComponentIndex(Component c)
Returns the index of the specified component. |
JMenu |
getHelpMenu()
Gets the help menu for the menu bar. |
Insets |
getMargin()
Returns the margin between the menubar's border and its menus. |
JMenu |
getMenu(int index)
Returns the menu at the specified position in the menu bar. |
int |
getMenuCount()
Returns the number of items in the menu bar. |
SingleSelectionModel |
getSelectionModel()
Returns the model object that handles single selections. |
MenuElement[] |
getSubElements()
Implemented to be a MenuElement -- returns the
menus in this menu bar. |
MenuBarUI |
getUI()
Returns the menubar's current UI. |
String |
getUIClassID()
Returns the name of the L&F class that renders this component. |
boolean |
isBorderPainted()
Returns true if the menu bars border should be painted. |
boolean |
isManagingFocus()
Returns true to indicate that this component manages focus events internally. |
boolean |
isSelected()
Returns true if the menu bar currently has a component selected. |
void |
menuSelectionChanged(boolean isIncluded)
Implemented to be a MenuElemen |
protected void |
paintBorder(Graphics g)
Paints the menubar's border if BorderPainted
property is true. |
protected String |
paramString()
Returns a string representation of this JMenuBar . |
protected boolean |
processKeyBinding(KeyStroke ks,
KeyEvent e,
int condition,
boolean pressed)
Subclassed to check all the child menus. |
void |
processKeyEvent(KeyEvent e,
MenuElement[] path,
MenuSelectionManager manager)
Implemented to be a MenuElement -- does nothing. |
void |
processMouseEvent(MouseEvent event,
MenuElement[] path,
MenuSelectionManager manager)
Implemented to be a MenuElement -- does nothing. |
void |
removeNotify()
Overrides JComponent.removeNotify to unregister this
menu bar with the current keyboard manager. |
void |
setBorderPainted(boolean b)
Sets whether the border should be painted. |
void |
setHelpMenu(JMenu menu)
Sets the help menu that appears when the user selects the "help" option in the menu bar. |
void |
setMargin(Insets m)
Sets the margin between the menubar's border and its menus. |
void |
setSelected(Component sel)
Sets the currently selected component, producing a a change to the selection model. |
void |
setSelectionModel(SingleSelectionModel model)
Sets the model object to handle single selections. |
void |
setUI(MenuBarUI ui)
Sets the L&F object that renders this component. |
void |
updateUI()
Notification from the UIFactory that the L&F has changed. |
Methods inherited from class java.awt.Container |
add, add, add, add, add, addContainerListener, addImpl, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getLayout, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setLayout, validate, validateTree |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
public JMenuBar()
Method Detail |
public MenuBarUI getUI()
setUI(javax.swing.plaf.MenuBarUI)
public void setUI(MenuBarUI ui)
ui
- the new MenuBarUI L&F objectUIDefaults.getUI(javax.swing.JComponent)
public void updateUI()
UIFactory
that the L&F has changed.
Called to replace the UI with the latest version from the
UIFactory
.updateUI
in class JComponent
JComponent.updateUI()
public String getUIClassID()
getUIClassID
in class JComponent
JComponent.getUIClassID()
,
UIDefaults.getUI(javax.swing.JComponent)
public SingleSelectionModel getSelectionModel()
SingleSelectionModel
propertySingleSelectionModel
public void setSelectionModel(SingleSelectionModel model)
model
- the SingleSelectionModel
to useSingleSelectionModel
public JMenu add(JMenu c)
c
- the JMenu
component to addpublic JMenu getMenu(int index)
index
- an integer giving the position in the menu bar, where
0 is the first positionJMenu
at that position, or null
if
if there is no JMenu
at that position (ie. if
it is a JMenuItem
)public int getMenuCount()
public void setHelpMenu(JMenu menu)
menu
- the JMenu that delivers help to the userpublic JMenu getHelpMenu()
JMenu
that delivers help to the userpublic Component getComponentAtIndex(int i)
getComponent(int i)
i
- an integer specifying the position, where 0 is firstComponent
at the position,
or null
for an invalid indexpublic int getComponentIndex(Component c)
c
- the Component
to findpublic void setSelected(Component sel)
sel
- the Component
to selectpublic boolean isSelected()
public boolean isBorderPainted()
public void setBorderPainted(boolean b)
b
- if true and border property is not null
,
the border is painted.isBorderPainted()
protected void paintBorder(Graphics g)
BorderPainted
property is true.paintBorder
in class JComponent
g
- the Graphics
context to use for paintingJComponent.paint(java.awt.Graphics)
,
JComponent.setBorder(javax.swing.border.Border)
public void setMargin(Insets m)
null
will cause the menubar to
use the default margins.margin
- an Insets object containing the margin valuesInsets
public Insets getMargin()
Insets
object containing the margin valuesInsets
public void processMouseEvent(MouseEvent event, MenuElement[] path, MenuSelectionManager manager)
MenuElement
-- does nothing.processMouseEvent
in interface MenuElement
getSubElements()
public void processKeyEvent(KeyEvent e, MenuElement[] path, MenuSelectionManager manager)
MenuElement
-- does nothing.processKeyEvent
in interface MenuElement
getSubElements()
public void menuSelectionChanged(boolean isIncluded)
MenuElement -- does nothing.
- Specified by:
menuSelectionChanged
in interface MenuElement
- See Also:
getSubElements()
public MenuElement[] getSubElements()
MenuElement
-- returns the
menus in this menu bar.
This is the reason for implementing the MenuElement
interface -- so that the menu bar can be treated the same as
other menu elements.getSubElements
in interface MenuElement
public Component getComponent()
MenuElement
. Returns this object.getComponent
in interface MenuElement
Component
(this)getSubElements()
protected String paramString()
JMenuBar
.
This method
is intended to be used only for debugging purposes, and the
content and format of the returned string may vary between
implementations. The returned string may be empty but may not
be null
.paramString
in class JComponent
JMenuBar
public AccessibleContext getAccessibleContext()
getAccessibleContext
in interface Accessible
getAccessibleContext
in class JComponent
public boolean isManagingFocus()
isManagingFocus
in class JComponent
protected boolean processKeyBinding(KeyStroke ks, KeyEvent e, int condition, boolean pressed)
processKeyBinding
in class JComponent
javax.swing.JComponent
public void addNotify()
JComponent.addNotify
to register this
menu bar with the current keyboard manager.addNotify
in class JComponent
javax.swing.JComponent
JComponent.registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)
public void removeNotify()
JComponent.removeNotify
to unregister this
menu bar with the current keyboard manager.removeNotify
in class JComponent
javax.swing.JComponent
JComponent.registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)
|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.