< 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 >