< prev index next >
src/java.desktop/share/classes/java/awt/MenuComponent.java
Print this page
*** 36,52 ****
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 1.0
*/
public abstract class MenuComponent implements java.io.Serializable {
--- 36,52 ----
import java.security.AccessControlContext;
import java.security.AccessController;
/**
! * The abstract class {@code MenuComponent} is the superclass
* of all menu-related components. In this respect, the class
! * {@code MenuComponent} is analogous to the abstract superclass
! * {@code Component} for AWT components.
* <p>
* Menu components receive and process AWT events, just as components do,
! * through the method {@code processEvent}.
*
* @author Arthur van Hoff
* @since 1.0
*/
public abstract class MenuComponent implements java.io.Serializable {
*** 61,105 ****
transient volatile 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;
--- 61,105 ----
transient volatile MenuComponentPeer peer;
transient MenuContainer parent;
/**
! * The {@code AppContext} of the {@code MenuComponent}.
* This is set in the constructor and never changes.
*/
transient AppContext appContext;
/**
* The menu component's font. This value can be
! * {@code null} at which point a default will be used.
! * This defaults to {@code null}.
*
* @serial
* @see #setFont(Font)
* @see #getFont()
*/
volatile Font font;
/**
! * The menu component's name, which defaults to {@code null}.
* @serial
* @see #getName()
* @see #setName(String)
*/
private String name;
/**
* A variable to indicate whether a name is explicitly set.
! * If {@code true} the name will be set explicitly.
! * This defaults to {@code false}.
* @serial
* @see #setName(String)
*/
private boolean nameExplicitlySet = false;
/**
! * Defaults to {@code false}.
* @serial
* @see #dispatchEvent(AWTEvent)
*/
boolean newEventsOnly = false;
*** 162,186 ****
}
});
}
/**
! * 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()
--- 162,186 ----
}
});
}
/**
! * Creates a {@code MenuComponent}.
* @exception HeadlessException if
! * {@code GraphicsEnvironment.isHeadless}
! * returns {@code true}
* @see java.awt.GraphicsEnvironment#isHeadless
*/
public MenuComponent() throws HeadlessException {
GraphicsEnvironment.checkHeadless();
appContext = AppContext.getAppContext();
}
/**
! * Constructs a name for this {@code MenuComponent}.
! * Called by {@code getName} when the name is {@code null}.
! * @return a name for this {@code MenuComponent}
*/
String constructComponentName() {
return null; // For strict compliance with prior platform versions, a MenuComponent
// that doesn't set its name should return null from
// getName()
*** 224,234 ****
}
/**
* 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();
}
--- 224,234 ----
}
/**
* Returns the parent container for this menu component.
* @return the menu component containing this menu component,
! * or {@code null} if this menu component
* is the outermost component, the menu bar itself
*/
public MenuContainer getParent() {
return getParent_NoClientCode();
}
*** 241,251 ****
}
/**
* 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) {
--- 241,251 ----
}
/**
* Gets the font used for this menu component.
* @return the font used in this menu component, if there is one;
! * {@code null} otherwise
* @see java.awt.MenuComponent#setFont
*/
public Font getFont() {
Font font = this.font;
if (font != null) {
*** 288,298 ****
* 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.
*
--- 288,298 ----
* 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}
* 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.
*
*** 383,393 ****
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 1.1
--- 383,393 ----
boolean eventEnabled(AWTEvent e) {
return false;
}
/**
* Processes events occurring on this menu component.
! * <p>Note that if the event parameter is {@code null}
* the behavior is unspecified and may result in an
* exception.
*
* @param e the event
* @since 1.1
*** 395,408 ****
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();
--- 395,408 ----
protected void processEvent(AWTEvent e) {
}
/**
* Returns a string representing the state of this
! * {@code MenuComponent}. 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}.
*
* @return the parameter string of this menu component
*/
protected String paramString() {
String thisName = getName();
*** 428,441 ****
}
/**
* 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
--- 428,441 ----
}
/**
* Reads the menu component from an object input stream.
*
! * @param s the {@code ObjectInputStream} to read
* @exception HeadlessException if
! * {@code GraphicsEnvironment.isHeadless} returns
! * {@code true}
* @serial
* @see java.awt.GraphicsEnvironment#isHeadless
*/
private void readObject(ObjectInputStream s)
throws ClassNotFoundException, IOException, HeadlessException
*** 464,491 ****
*/
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.
--- 464,491 ----
*/
AccessibleContext accessibleContext = null;
/**
! * Gets the {@code AccessibleContext} associated with
! * this {@code MenuComponent}.
*
! * The method implemented by this base class returns {@code null}.
! * Classes that extend {@code MenuComponent}
* should implement this method to return the
! * {@code AccessibleContext} associated with the subclass.
*
! * @return the {@code AccessibleContext} of this
! * {@code MenuComponent}
* @since 1.3
*/
public AccessibleContext getAccessibleContext() {
return accessibleContext;
}
/**
! * Inner class of {@code MenuComponent} 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.
*** 510,540 ****
// 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;
--- 510,540 ----
// AccessibleContext methods
//
/**
! * Gets the {@code AccessibleSelection} associated with this
! * object which allows its {@code Accessible} children to be selected.
*
! * @return {@code AccessibleSelection} if supported by object;
! * else return {@code null}
* @see AccessibleSelection
*/
public AccessibleSelection getAccessibleSelection() {
return this;
}
/**
* Gets the accessible name of this object. This should almost never
! * return {@code java.awt.MenuComponent.getName}, 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}
* if this object does not have a name
* @see AccessibleContext#setAccessibleName
*/
public String getAccessibleName() {
return accessibleName;
*** 550,596 ****
* 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 {
--- 550,596 ----
* 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} 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}
* 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}
* containing the current state set of the object
* @see AccessibleState
*/
public AccessibleStateSet getAccessibleStateSet() {
return MenuComponent.this.getAccessibleStateSet();
}
/**
! * Gets the {@code Accessible} parent of this object.
! * If the parent of this object implements {@code Accessible},
! * this method should simply return {@code getParent}.
! *
! * @return the {@code Accessible} parent of this object -- can
! * be {@code null} if this object does not have an
! * {@code Accessible} parent
*/
public Accessible getAccessibleParent() {
if (accessibleParent != null) {
return accessibleParent;
} else {
*** 613,633 ****
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) {
--- 613,633 ----
return MenuComponent.this.getAccessibleIndexInParent();
}
/**
* Returns the number of accessible children in the object. If all
! * of the children of this object implement {@code Accessible},
* 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} child of the object.
*
* @param i zero-based index of child
* @return the nth Accessible child of the object
*/
public Accessible getAccessibleChild(int i) {
*** 646,657 ****
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;
--- 646,657 ----
else
return java.util.Locale.getDefault();
}
/**
! * Gets the {@code AccessibleComponent} associated with
! * this object if one exists. Otherwise return {@code null}.
*
* @return the component
*/
public AccessibleComponent getAccessibleComponent() {
return this;
*** 662,754 ****
//
/**
* 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
}
--- 662,754 ----
//
/**
* Gets the background color of this object.
*
* @return the background color, if supported, of the object;
! * otherwise, {@code null}
*/
public Color getBackground() {
return null; // Not supported for MenuComponents
}
/**
* Sets the background color of this object.
! * (For transparency, see {@code isOpaque}.)
*
! * @param c the new {@code Color} 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}
*/
public Color getForeground() {
return null; // Not supported for MenuComponents
}
/**
* Sets the foreground color of this object.
*
! * @param c the new {@code Color} for the foreground
*/
public void setForeground(Color c) {
// Not supported for MenuComponents
}
/**
! * Gets the {@code Cursor} of this object.
*
! * @return the {@code Cursor}, if supported, of the object;
! * otherwise, {@code null}
*/
public Cursor getCursor() {
return null; // Not supported for MenuComponents
}
/**
! * Sets the {@code Cursor} 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} for the object
*/
public void setCursor(Cursor cursor) {
// Not supported for MenuComponents
}
/**
! * Gets the {@code Font} of this object.
*
! * @return the {@code Font},if supported, for the object;
! * otherwise, {@code null}
*/
public Font getFont() {
return MenuComponent.this.getFont();
}
/**
! * Sets the {@code Font} of this object.
*
! * @param f the new {@code Font} for the object
*/
public void setFont(Font f) {
MenuComponent.this.setFont(f);
}
/**
! * Gets the {@code FontMetrics} of this object.
*
! * @param f the {@code Font}
* @return the FontMetrics, if supported, the object;
! * otherwise, {@code null}
* @see #getFont
*/
public FontMetrics getFontMetrics(Font f) {
return null; // Not supported for MenuComponents
}
*** 774,784 ****
/**
* 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
--- 774,784 ----
/**
* 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}.
*
* @return true if object is visible; otherwise, false
*/
public boolean isVisible() {
return true; // Not supported for MenuComponents
*** 809,830 ****
/**
* 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
}
--- 809,830 ----
/**
* 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} relative to the coordinate
* system of the object
! * @return true if object contains {@code Point}; 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}
* if this object is not on the screen
*/
public Point getLocationOnScreen() {
return null; // Not supported for MenuComponents
}
*** 832,844 ****
/**
* 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
}
--- 832,844 ----
/**
* 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} representing the
* top-left corner of the object's bounds in the coordinate
! * space of the screen; {@code null} if
* this object or its parent are not on the screen
*/
public Point getLocation() {
return null; // Not supported for MenuComponents
}
*** 850,873 ****
// 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
*/
--- 850,873 ----
// Not supported for MenuComponents
}
/**
* Gets the bounds of this object in the form of a
! * {@code Rectangle} 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} 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} object.
* The bounds specify this object's width, height, and location
* relative to its parent.
*
* @param r a rectangle indicating this component's bounds
*/
*** 875,918 ****
// 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
}
--- 875,918 ----
// Not supported for MenuComponents
}
/**
* Returns the size of this object in the form of a
! * {@code Dimension} object. The height field of
! * the {@code Dimension} object contains this object's
! * height, and the width field of the {@code Dimension}
* object contains this object's width.
*
! * @return a {@code Dimension} object that indicates the
! * size of this component; {@code null}
* 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} specifying the
* new size of the object
*/
public void setSize(Dimension d) {
// Not supported for MenuComponents
}
/**
! * Returns the {@code Accessible} child, if one exists,
! * contained at the local coordinate {@code Point}.
! * If there is no {@code Accessible} child, {@code null}
* is returned.
*
* @param p the point defining the top-left corner of the
! * {@code Accessible}, given in the coordinate space
* of the object's parent
! * @return the {@code Accessible}, if it exists,
! * at the specified location; else {@code null}
*/
public Accessible getAccessibleAt(Point p) {
return null; // MenuComponents don't have children
}
*** 954,977 ****
// 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
--- 954,977 ----
// AccessibleSelection methods
//
/**
! * Returns the number of {@code Accessible} 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} 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}.
* <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
*** 985,1003 ****
* 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.
*
--- 985,1003 ----
* 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} object
* @see AccessibleContext#getAccessibleChild
*/
public boolean isAccessibleChildSelected(int i) {
return false; // To be fully implemented in a future release
}
/**
! * Adds the specified {@code Accessible} 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.
*
*** 1066,1076 ****
}
/**
* 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();
--- 1066,1076 ----
}
/**
* Gets the state of this object.
*
! * @return an instance of {@code AccessibleStateSet}
* containing the current state set of the object
* @see AccessibleState
*/
AccessibleStateSet getAccessibleStateSet() {
AccessibleStateSet states = new AccessibleStateSet();
< prev index next >