Back to index...

	/*
	* Copyright (c) 1995, 2013, Oracle and/or its affiliates. All rights reserved.
	* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
	*
	* This code is free software; you can redistribute it and/or modify it
	* under the terms of the GNU General Public License version 2 only, as
	* published by the Free Software Foundation. Oracle designates this
	* particular file as subject to the "Classpath" exception as provided
	* by Oracle in the LICENSE file that accompanied this code.
	*
	* This code is distributed in the hope that it will be useful, but WITHOUT
	* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
	* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
	* version 2 for more details (a copy is included in the LICENSE file that
	* accompanied this code).
	*
	* You should have received a copy of the GNU General Public License version
	* 2 along with this work; if not, write to the Free Software Foundation,
	* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
	*
	* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
	* or visit www.oracle.com if you need additional information or have any
	* questions.
	*/
	package java.awt;

	import java.awt.peer.MenuComponentPeer;
	import java.awt.event.ActionEvent;
	import java.io.IOException;
	import java.io.ObjectInputStream;
	import sun.awt.AppContext;
	import sun.awt.AWTAccessor;
	import javax.accessibility.*;

	import java.security.AccessControlContext;
	import java.security.AccessController;

	/**
	* The abstract class <code>MenuComponent</code> is the superclass
	* of all menu-related components. In this respect, the class
	* <code>MenuComponent</code> is analogous to the abstract superclass
	* <code>Component</code> for AWT components.
	* <p>
	* Menu components receive and process AWT events, just as components do,
	* through the method <code>processEvent</code>.
	*
	* @author Arthur van Hoff
	* @since JDK1.0
	*/
	public abstract class MenuComponent implements java.io.Serializable {

	static {
	/* ensure that the necessary native libraries are loaded */
	Toolkit.loadLibraries();
	if (!GraphicsEnvironment.isHeadless()) {
	initIDs();
	}
	}

	transient MenuComponentPeer peer;
	transient MenuContainer parent;

	/**
	* The <code>AppContext</code> of the <code>MenuComponent</code>.
	* This is set in the constructor and never changes.
	*/
	transient AppContext appContext;

	/**
	* The menu component's font. This value can be
	* <code>null</code> at which point a default will be used.
	* This defaults to <code>null</code>.
	*
	* @serial
	* @see #setFont(Font)
	* @see #getFont()
	*/
	volatile Font font;

	/**
	* The menu component's name, which defaults to <code>null</code>.
	* @serial
	* @see #getName()
	* @see #setName(String)
	*/
	private String name;

	/**
	* A variable to indicate whether a name is explicitly set.
	* If <code>true</code> the name will be set explicitly.
	* This defaults to <code>false</code>.
	* @serial
	* @see #setName(String)
	*/
	private boolean nameExplicitlySet = false;

	/**
	* Defaults to <code>false</code>.
	* @serial
	* @see #dispatchEvent(AWTEvent)
	*/
	boolean newEventsOnly = false;

	/*
	* The menu's AccessControlContext.
	*/
	private transient volatile AccessControlContext acc =
	AccessController.getContext();

	/*
	* Returns the acc this menu component was constructed with.
	*/
	final AccessControlContext getAccessControlContext() {
	if (acc == null) {
	throw new SecurityException(
	"MenuComponent is missing AccessControlContext");
	}
	return acc;
	}

	/*
	* Internal constants for serialization.
	*/
	final static String actionListenerK = Component.actionListenerK;
	final static String itemListenerK = Component.itemListenerK;

	/*
	* JDK 1.1 serialVersionUID
	*/
	private static final long serialVersionUID = -4536902356223894379L;

	static {
	AWTAccessor.setMenuComponentAccessor(
	new AWTAccessor.MenuComponentAccessor() {
	public AppContext getAppContext(MenuComponent menuComp) {
	return menuComp.appContext;
	}
	public void setAppContext(MenuComponent menuComp,
	AppContext appContext) {
	menuComp.appContext = appContext;
	}
	public MenuContainer getParent(MenuComponent menuComp) {
	return menuComp.parent;
	}
	public Font getFont_NoClientCode(MenuComponent menuComp) {
	return menuComp.getFont_NoClientCode();
	}
	@SuppressWarnings("unchecked")
	public <T extends MenuComponentPeer> T getPeer(MenuComponent menuComp) {
	return (T) menuComp.peer;
	}
	});
	}

	/**
	* Creates a <code>MenuComponent</code>.
	* @exception HeadlessException if
	* <code>GraphicsEnvironment.isHeadless</code>
	* returns <code>true</code>
	* @see java.awt.GraphicsEnvironment#isHeadless
	*/
	public MenuComponent() throws HeadlessException {
	GraphicsEnvironment.checkHeadless();
	appContext = AppContext.getAppContext();
	}

	/**
	* Constructs a name for this <code>MenuComponent</code>.
	* Called by <code>getName</code> when the name is <code>null</code>.
	* @return a name for this <code>MenuComponent</code>
	*/
	String constructComponentName() {
	return null; // For strict compliance with prior platform versions, a MenuComponent
	// that doesn't set its name should return null from
	// getName()
	}

	/**
	* Gets the name of the menu component.
	* @return the name of the menu component
	* @see java.awt.MenuComponent#setName(java.lang.String)
	* @since JDK1.1
	*/
	public String getName() {
	if (name == null && !nameExplicitlySet) {
	synchronized(this) {
	if (name == null && !nameExplicitlySet)
	name = constructComponentName();
	}
	}
	return name;
	}

	/**
	* Sets the name of the component to the specified string.
	* @param name the name of the menu component
	* @see java.awt.MenuComponent#getName
	* @since JDK1.1
	*/
	public void setName(String name) {
	synchronized(this) {
	this.name = name;
	nameExplicitlySet = true;
	}
	}

	/**
	* Returns the parent container for this menu component.
	* @return the menu component containing this menu component,
	* or <code>null</code> if this menu component
	* is the outermost component, the menu bar itself
	*/
	public MenuContainer getParent() {
	return getParent_NoClientCode();
	}
	// NOTE: This method may be called by privileged threads.
	// This functionality is implemented in a package-private method
	// to insure that it cannot be overridden by client subclasses.
	// DO NOT INVOKE CLIENT CODE ON THIS THREAD!
	final MenuContainer getParent_NoClientCode() {
	return parent;
	}

	/**
	* @deprecated As of JDK version 1.1,
	* programs should not directly manipulate peers.
	*/
	@Deprecated
	public MenuComponentPeer getPeer() {
	return peer;
	}

	/**
	* Gets the font used for this menu component.
	* @return the font used in this menu component, if there is one;
	* <code>null</code> otherwise
	* @see java.awt.MenuComponent#setFont
	*/
	public Font getFont() {
	Font font = this.font;
	if (font != null) {
	return font;
	}
	MenuContainer parent = this.parent;
	if (parent != null) {
	return parent.getFont();
	}
	return null;
	}

	// NOTE: This method may be called by privileged threads.
	// This functionality is implemented in a package-private method
	// to insure that it cannot be overridden by client subclasses.
	// DO NOT INVOKE CLIENT CODE ON THIS THREAD!
	final Font getFont_NoClientCode() {
	Font font = this.font;
	if (font != null) {
	return font;
	}

	// The MenuContainer interface does not have getFont_NoClientCode()
	// and it cannot, because it must be package-private. Because of
	// this, we must manually cast classes that implement
	// MenuContainer.
	Object parent = this.parent;
	if (parent != null) {
	if (parent instanceof Component) {
	font = ((Component)parent).getFont_NoClientCode();
	} else if (parent instanceof MenuComponent) {
	font = ((MenuComponent)parent).getFont_NoClientCode();
	}
	}
	return font;
	} // getFont_NoClientCode()


	/**
	* Sets the font to be used for this menu component to the specified
	* font. This font is also used by all subcomponents of this menu
	* component, unless those subcomponents specify a different font.
	* <p>
	* Some platforms may not support setting of all font attributes
	* of a menu component; in such cases, calling <code>setFont</code>
	* will have no effect on the unsupported font attributes of this
	* menu component. Unless subcomponents of this menu component
	* specify a different font, this font will be used by those
	* subcomponents if supported by the underlying platform.
	*
	* @param f the font to be set
	* @see #getFont
	* @see Font#getAttributes
	* @see java.awt.font.TextAttribute
	*/
	public void setFont(Font f) {
	synchronized (getTreeLock()) {
	font = f;
	//Fixed 6312943: NullPointerException in method MenuComponent.setFont(Font)
	MenuComponentPeer peer = this.peer;
	if (peer != null) {
	peer.setFont(f);
	}
	}
	}

	/**
	* Removes the menu component's peer. The peer allows us to modify the
	* appearance of the menu component without changing the functionality of
	* the menu component.
	*/
	public void removeNotify() {
	synchronized (getTreeLock()) {
	MenuComponentPeer p = this.peer;
	if (p != null) {
	Toolkit.getEventQueue().removeSourceEvents(this, true);
	this.peer = null;
	p.dispose();
	}
	}
	}

	/**
	* Posts the specified event to the menu.
	* This method is part of the Java 1.0 event system
	* and it is maintained only for backwards compatibility.
	* Its use is discouraged, and it may not be supported
	* in the future.
	* @param evt the event which is to take place
	* @deprecated As of JDK version 1.1, replaced by {@link
	* #dispatchEvent(AWTEvent) dispatchEvent}.
	*/
	@Deprecated
	public boolean postEvent(Event evt) {
	MenuContainer parent = this.parent;
	if (parent != null) {
	parent.postEvent(evt);
	}
	return false;
	}

	/**
	* Delivers an event to this component or one of its sub components.
	* @param e the event
	*/
	public final void dispatchEvent(AWTEvent e) {
	dispatchEventImpl(e);
	}

	void dispatchEventImpl(AWTEvent e) {
	EventQueue.setCurrentEventAndMostRecentTime(e);

	Toolkit.getDefaultToolkit().notifyAWTEventListeners(e);

	if (newEventsOnly \|\|
	(parent != null && parent instanceof MenuComponent &&
	((MenuComponent)parent).newEventsOnly)) {
	if (eventEnabled(e)) {
	processEvent(e);
	} else if (e instanceof ActionEvent && parent != null) {
	e.setSource(parent);
	((MenuComponent)parent).dispatchEvent(e);
	}

	} else { // backward compatibility
	Event olde = e.convertToOld();
	if (olde != null) {
	postEvent(olde);
	}
	}
	}

	// REMIND: remove when filtering is done at lower level
	boolean eventEnabled(AWTEvent e) {
	return false;
	}
	/**
	* Processes events occurring on this menu component.
	* <p>Note that if the event parameter is <code>null</code>
	* the behavior is unspecified and may result in an
	* exception.
	*
	* @param e the event
	* @since JDK1.1
	*/
	protected void processEvent(AWTEvent e) {
	}

	/**
	* Returns a string representing the state of this
	* <code>MenuComponent</code>. 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 <code>null</code>.
	*
	* @return the parameter string of this menu component
	*/
	protected String paramString() {
	String thisName = getName();
	return (thisName != null? thisName : "");
	}

	/**
	* Returns a representation of this menu component as a string.
	* @return a string representation of this menu component
	*/
	public String toString() {
	return getClass().getName() + "[" + paramString() + "]";
	}

	/**
	* Gets this component's locking object (the object that owns the thread
	* synchronization monitor) for AWT component-tree and layout
	* operations.
	* @return this component's locking object
	*/
	protected final Object getTreeLock() {
	return Component.LOCK;
	}

	/**
	* Reads the menu component from an object input stream.
	*
	* @param s the <code>ObjectInputStream</code> to read
	* @exception HeadlessException if
	* <code>GraphicsEnvironment.isHeadless</code> returns
	* <code>true</code>
	* @serial
	* @see java.awt.GraphicsEnvironment#isHeadless
	*/
	private void readObject(ObjectInputStream s)
	throws ClassNotFoundException, IOException, HeadlessException
	{
	GraphicsEnvironment.checkHeadless();

	acc = AccessController.getContext();

	s.defaultReadObject();

	appContext = AppContext.getAppContext();
	}

	/**
	* Initialize JNI field and method IDs.
	*/
	private static native void initIDs();


	/*
	* --- Accessibility Support ---
	*
	* MenuComponent will contain all of the methods in interface Accessible,
	* though it won't actually implement the interface - that will be up
	* to the individual objects which extend MenuComponent.
	*/

	AccessibleContext accessibleContext = null;

	/**
	* Gets the <code>AccessibleContext</code> associated with
	* this <code>MenuComponent</code>.
	*
	* The method implemented by this base class returns <code>null</code>.
	* Classes that extend <code>MenuComponent</code>
	* should implement this method to return the
	* <code>AccessibleContext</code> associated with the subclass.
	*
	* @return the <code>AccessibleContext</code> of this
	* <code>MenuComponent</code>
	* @since 1.3
	*/
	public AccessibleContext getAccessibleContext() {
	return accessibleContext;
	}

	/**
	* Inner class of <code>MenuComponent</code> used to provide
	* default support for accessibility. This class is not meant
	* to be used directly by application developers, but is instead
	* meant only to be subclassed by menu component developers.
	* <p>
	* The class used to obtain the accessible role for this object.
	* @since 1.3
	*/
	protected abstract class AccessibleAWTMenuComponent
	extends AccessibleContext
	implements java.io.Serializable, AccessibleComponent,
	AccessibleSelection
	{
	/*
	* JDK 1.3 serialVersionUID
	*/
	private static final long serialVersionUID = -4269533416223798698L;

	/**
	* Although the class is abstract, this should be called by
	* all sub-classes.
	*/
	protected AccessibleAWTMenuComponent() {
	}

	// AccessibleContext methods
	//

	/**
	* Gets the <code>AccessibleSelection</code> associated with this
	* object which allows its <code>Accessible</code> children to be selected.
	*
	* @return <code>AccessibleSelection</code> if supported by object;
	* else return <code>null</code>
	* @see AccessibleSelection
	*/
	public AccessibleSelection getAccessibleSelection() {
	return this;
	}

	/**
	* Gets the accessible name of this object. This should almost never
	* return <code>java.awt.MenuComponent.getName</code>, as that
	* generally isn't a localized name, and doesn't have meaning for the
	* user. If the object is fundamentally a text object (e.g. a menu item), the
	* accessible name should be the text of the object (e.g. "save").
	* If the object has a tooltip, the tooltip text may also be an
	* appropriate String to return.
	*
	* @return the localized name of the object -- can be <code>null</code>
	* if this object does not have a name
	* @see AccessibleContext#setAccessibleName
	*/
	public String getAccessibleName() {
	return accessibleName;
	}

	/**
	* Gets the accessible description of this object. This should be
	* a concise, localized description of what this object is - what
	* is its meaning to the user. If the object has a tooltip, the
	* tooltip text may be an appropriate string to return, assuming
	* it contains a concise description of the object (instead of just
	* the name of the object - e.g. a "Save" icon on a toolbar that
	* had "save" as the tooltip text shouldn't return the tooltip
	* text as the description, but something like "Saves the current
	* text document" instead).
	*
	* @return the localized description of the object -- can be
	* <code>null</code> if this object does not have a description
	* @see AccessibleContext#setAccessibleDescription
	*/
	public String getAccessibleDescription() {
	return accessibleDescription;
	}

	/**
	* Gets the role of this object.
	*
	* @return an instance of <code>AccessibleRole</code>
	* describing the role of the object
	* @see AccessibleRole
	*/
	public AccessibleRole getAccessibleRole() {
	return AccessibleRole.AWT_COMPONENT; // Non-specific -- overridden in subclasses
	}

	/**
	* Gets the state of this object.
	*
	* @return an instance of <code>AccessibleStateSet</code>
	* containing the current state set of the object
	* @see AccessibleState
	*/
	public AccessibleStateSet getAccessibleStateSet() {
	return MenuComponent.this.getAccessibleStateSet();
	}

	/**
	* Gets the <code>Accessible</code> parent of this object.
	* If the parent of this object implements <code>Accessible</code>,
	* this method should simply return <code>getParent</code>.
	*
	* @return the <code>Accessible</code> parent of this object -- can
	* be <code>null</code> if this object does not have an
	* <code>Accessible</code> parent
	*/
	public Accessible getAccessibleParent() {
	if (accessibleParent != null) {
	return accessibleParent;
	} else {
	MenuContainer parent = MenuComponent.this.getParent();
	if (parent instanceof Accessible) {
	return (Accessible) parent;
	}
	}
	return null;
	}

	/**
	* Gets the index of this object in its accessible parent.
	*
	* @return the index of this object in its parent; -1 if this
	* object does not have an accessible parent
	* @see #getAccessibleParent
	*/
	public int getAccessibleIndexInParent() {
	return MenuComponent.this.getAccessibleIndexInParent();
	}

	/**
	* Returns the number of accessible children in the object. If all
	* of the children of this object implement <code>Accessible</code>,
	* then this method should return the number of children of this object.
	*
	* @return the number of accessible children in the object
	*/
	public int getAccessibleChildrenCount() {
	return 0; // MenuComponents don't have children
	}

	/**
	* Returns the nth <code>Accessible</code> child of the object.
	*
	* @param i zero-based index of child
	* @return the nth Accessible child of the object
	*/
	public Accessible getAccessibleChild(int i) {
	return null; // MenuComponents don't have children
	}

	/**
	* Returns the locale of this object.
	*
	* @return the locale of this object
	*/
	public java.util.Locale getLocale() {
	MenuContainer parent = MenuComponent.this.getParent();
	if (parent instanceof Component)
	return ((Component)parent).getLocale();
	else
	return java.util.Locale.getDefault();
	}

	/**
	* Gets the <code>AccessibleComponent</code> associated with
	* this object if one exists. Otherwise return <code>null</code>.
	*
	* @return the component
	*/
	public AccessibleComponent getAccessibleComponent() {
	return this;
	}


	// AccessibleComponent methods
	//
	/**
	* Gets the background color of this object.
	*
	* @return the background color, if supported, of the object;
	* otherwise, <code>null</code>
	*/
	public Color getBackground() {
	return null; // Not supported for MenuComponents
	}

	/**
	* Sets the background color of this object.
	* (For transparency, see <code>isOpaque</code>.)
	*
	* @param c the new <code>Color</code> for the background
	* @see Component#isOpaque
	*/
	public void setBackground(Color c) {
	// Not supported for MenuComponents
	}

	/**
	* Gets the foreground color of this object.
	*
	* @return the foreground color, if supported, of the object;
	* otherwise, <code>null</code>
	*/
	public Color getForeground() {
	return null; // Not supported for MenuComponents
	}

	/**
	* Sets the foreground color of this object.
	*
	* @param c the new <code>Color</code> for the foreground
	*/
	public void setForeground(Color c) {
	// Not supported for MenuComponents
	}

	/**
	* Gets the <code>Cursor</code> of this object.
	*
	* @return the <code>Cursor</code>, if supported, of the object;
	* otherwise, <code>null</code>
	*/
	public Cursor getCursor() {
	return null; // Not supported for MenuComponents
	}

	/**
	* Sets the <code>Cursor</code> of this object.
	* <p>
	* The method may have no visual effect if the Java platform
	* implementation and/or the native system do not support
	* changing the mouse cursor shape.
	* @param cursor the new <code>Cursor</code> for the object
	*/
	public void setCursor(Cursor cursor) {
	// Not supported for MenuComponents
	}

	/**
	* Gets the <code>Font</code> of this object.
	*
	* @return the <code>Font</code>,if supported, for the object;
	* otherwise, <code>null</code>
	*/
	public Font getFont() {
	return MenuComponent.this.getFont();
	}

	/**
	* Sets the <code>Font</code> of this object.
	*
	* @param f the new <code>Font</code> for the object
	*/
	public void setFont(Font f) {
	MenuComponent.this.setFont(f);
	}

	/**
	* Gets the <code>FontMetrics</code> of this object.
	*
	* @param f the <code>Font</code>
	* @return the FontMetrics, if supported, the object;
	* otherwise, <code>null</code>
	* @see #getFont
	*/
	public FontMetrics getFontMetrics(Font f) {
	return null; // Not supported for MenuComponents
	}

	/**
	* Determines if the object is enabled.
	*
	* @return true if object is enabled; otherwise, false
	*/
	public boolean isEnabled() {
	return true; // Not supported for MenuComponents
	}

	/**
	* Sets the enabled state of the object.
	*
	* @param b if true, enables this object; otherwise, disables it
	*/
	public void setEnabled(boolean b) {
	// Not supported for MenuComponents
	}

	/**
	* Determines if the object is visible. Note: this means that the
	* object intends to be visible; however, it may not in fact be
	* showing on the screen because one of the objects that this object
	* is contained by is not visible. To determine if an object is
	* showing on the screen, use <code>isShowing</code>.
	*
	* @return true if object is visible; otherwise, false
	*/
	public boolean isVisible() {
	return true; // Not supported for MenuComponents
	}

	/**
	* Sets the visible state of the object.
	*
	* @param b if true, shows this object; otherwise, hides it
	*/
	public void setVisible(boolean b) {
	// Not supported for MenuComponents
	}

	/**
	* Determines if the object is showing. This is determined by checking
	* the visibility of the object and ancestors of the object. Note:
	* this will return true even if the object is obscured by another
	* (for example, it happens to be underneath a menu that was pulled
	* down).
	*
	* @return true if object is showing; otherwise, false
	*/
	public boolean isShowing() {
	return true; // Not supported for MenuComponents
	}

	/**
	* Checks whether the specified point is within this object's bounds,
	* where the point's x and y coordinates are defined to be relative to
	* the coordinate system of the object.
	*
	* @param p the <code>Point</code> relative to the coordinate
	* system of the object
	* @return true if object contains <code>Point</code>; otherwise false
	*/
	public boolean contains(Point p) {
	return false; // Not supported for MenuComponents
	}

	/**
	* Returns the location of the object on the screen.
	*
	* @return location of object on screen -- can be <code>null</code>
	* if this object is not on the screen
	*/
	public Point getLocationOnScreen() {
	return null; // Not supported for MenuComponents
	}

	/**
	* Gets the location of the object relative to the parent in the form
	* of a point specifying the object's top-left corner in the screen's
	* coordinate space.
	*
	* @return an instance of <code>Point</code> representing the
	* top-left corner of the object's bounds in the coordinate
	* space of the screen; <code>null</code> if
	* this object or its parent are not on the screen
	*/
	public Point getLocation() {
	return null; // Not supported for MenuComponents
	}

	/**
	* Sets the location of the object relative to the parent.
	*/
	public void setLocation(Point p) {
	// Not supported for MenuComponents
	}

	/**
	* Gets the bounds of this object in the form of a
	* <code>Rectangle</code> object.
	* The bounds specify this object's width, height, and location
	* relative to its parent.
	*
	* @return a rectangle indicating this component's bounds;
	* <code>null</code> if this object is not on the screen
	*/
	public Rectangle getBounds() {
	return null; // Not supported for MenuComponents
	}

	/**
	* Sets the bounds of this object in the form of a
	* <code>Rectangle</code> object.
	* The bounds specify this object's width, height, and location
	* relative to its parent.
	*
	* @param r a rectangle indicating this component's bounds
	*/
	public void setBounds(Rectangle r) {
	// Not supported for MenuComponents
	}

	/**
	* Returns the size of this object in the form of a
	* <code>Dimension</code> object. The height field of
	* the <code>Dimension</code> object contains this object's
	* height, and the width field of the <code>Dimension</code>
	* object contains this object's width.
	*
	* @return a <code>Dimension</code> object that indicates the
	* size of this component; <code>null</code>
	* if this object is not on the screen
	*/
	public Dimension getSize() {
	return null; // Not supported for MenuComponents
	}

	/**
	* Resizes this object.
	*
	* @param d - the <code>Dimension</code> specifying the
	* new size of the object
	*/
	public void setSize(Dimension d) {
	// Not supported for MenuComponents
	}

	/**
	* Returns the <code>Accessible</code> child, if one exists,
	* contained at the local coordinate <code>Point</code>.
	* If there is no <code>Accessible</code> child, <code>null</code>
	* is returned.
	*
	* @param p the point defining the top-left corner of the
	* <code>Accessible</code>, given in the coordinate space
	* of the object's parent
	* @return the <code>Accessible</code>, if it exists,
	* at the specified location; else <code>null</code>
	*/
	public Accessible getAccessibleAt(Point p) {
	return null; // MenuComponents don't have children
	}

	/**
	* Returns whether this object can accept focus or not.
	*
	* @return true if object can accept focus; otherwise false
	*/
	public boolean isFocusTraversable() {
	return true; // Not supported for MenuComponents
	}

	/**
	* Requests focus for this object.
	*/
	public void requestFocus() {
	// Not supported for MenuComponents
	}

	/**
	* Adds the specified focus listener to receive focus events from this
	* component.
	*
	* @param l the focus listener
	*/
	public void addFocusListener(java.awt.event.FocusListener l) {
	// Not supported for MenuComponents
	}

	/**
	* Removes the specified focus listener so it no longer receives focus
	* events from this component.
	*
	* @param l the focus listener
	*/
	public void removeFocusListener(java.awt.event.FocusListener l) {
	// Not supported for MenuComponents
	}

	// AccessibleSelection methods
	//

	/**
	* Returns the number of <code>Accessible</code> children currently selected.
	* If no children are selected, the return value will be 0.
	*
	* @return the number of items currently selected
	*/
	public int getAccessibleSelectionCount() {
	return 0; // To be fully implemented in a future release
	}

	/**
	* Returns an <code>Accessible</code> representing the specified
	* selected child in the object. If there isn't a selection, or there are
	* fewer children selected than the integer passed in, the return
	* value will be <code>null</code>.
	* <p>Note that the index represents the i-th selected child, which
	* is different from the i-th child.
	*
	* @param i the zero-based index of selected children
	* @return the i-th selected child
	* @see #getAccessibleSelectionCount
	*/
	public Accessible getAccessibleSelection(int i) {
	return null; // To be fully implemented in a future release
	}

	/**
	* Determines if the current child of this object is selected.
	*
	* @return true if the current child of this object is selected;
	* else false
	* @param i the zero-based index of the child in this
	* <code>Accessible</code> object
	* @see AccessibleContext#getAccessibleChild
	*/
	public boolean isAccessibleChildSelected(int i) {
	return false; // To be fully implemented in a future release
	}

	/**
	* Adds the specified <code>Accessible</code> child of the object
	* to the object's selection. If the object supports multiple selections,
	* the specified child is added to any existing selection, otherwise
	* it replaces any existing selection in the object. If the
	* specified child is already selected, this method has no effect.
	*
	* @param i the zero-based index of the child
	* @see AccessibleContext#getAccessibleChild
	*/
	public void addAccessibleSelection(int i) {
	// To be fully implemented in a future release
	}

	/**
	* Removes the specified child of the object from the object's
	* selection. If the specified item isn't currently selected, this
	* method has no effect.
	*
	* @param i the zero-based index of the child
	* @see AccessibleContext#getAccessibleChild
	*/
	public void removeAccessibleSelection(int i) {
	// To be fully implemented in a future release
	}

	/**
	* Clears the selection in the object, so that no children in the
	* object are selected.
	*/
	public void clearAccessibleSelection() {
	// To be fully implemented in a future release
	}

	/**
	* Causes every child of the object to be selected
	* if the object supports multiple selections.
	*/
	public void selectAllAccessibleSelection() {
	// To be fully implemented in a future release
	}

	} // inner class AccessibleAWTComponent

	/**
	* Gets the index of this object in its accessible parent.
	*
	* @return -1 if this object does not have an accessible parent;
	* otherwise, the index of the child in its accessible parent.
	*/
	int getAccessibleIndexInParent() {
	MenuContainer localParent = parent;
	if (!(localParent instanceof MenuComponent)) {
	// MenuComponents only have accessible index when inside MenuComponents
	return -1;
	}
	MenuComponent localParentMenu = (MenuComponent)localParent;
	return localParentMenu.getAccessibleChildIndex(this);
	}

	/**
	* Gets the index of the child within this MenuComponent.
	*
	* @param child MenuComponent whose index we are interested in.
	* @return -1 if this object doesn't contain the child,
	* otherwise, index of the child.
	*/
	int getAccessibleChildIndex(MenuComponent child) {
	return -1; // Overridden in subclasses.
	}

	/**
	* Gets the state of this object.
	*
	* @return an instance of <code>AccessibleStateSet</code>
	* containing the current state set of the object
	* @see AccessibleState
	*/
	AccessibleStateSet getAccessibleStateSet() {
	AccessibleStateSet states = new AccessibleStateSet();
	return states;
	}

	}

Back to index...