/*
* Copyright (c) 1995, 2013, Oracle and/or its affiliates. All rights reserved.
* ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*/
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;
}
}