jdk-sandbox: comparison jdk/src/share/classes/java/awt/Component.java

equal deleted inserted replaced

-:aade36e70da0
+:e2bf17cee34b
 /**
 * Gets the name of the component.
 * @return this component's name
 * @see    #setName
-* @since JDK1.1
+* @since 1.1
 */
 public String getName() {
 if (name == null && !nameExplicitlySet) {
 synchronized(getObjectLock()) {
 if (name == null && !nameExplicitlySet)
 /**
 * Sets the name of the component to the specified string.
 * @param name  the string that is to be this
 *           component's name
 * @see #getName
-* @since JDK1.1
+* @since 1.1
 */
 public void setName(String name) {
 String oldName;
 synchronized(getObjectLock()) {
 oldName = this.name;
 }
 /**
 * Gets the parent of this component.
 * @return the parent container of this component
-* @since JDK1.0
+* @since 1.0
 */
 public Container getParent() {
 return getParent_NoClientCode();
 }
 * Gets the toolkit of this component. Note that
 * the frame that contains a component controls which
 * toolkit is used by that component. Therefore if the component
 * is moved from one frame to another, the toolkit it uses may change.
 * @return  the toolkit of this component
-* @since JDK1.0
+* @since 1.0
 */
 public Toolkit getToolkit() {
 return getToolkitImpl();
 }
 * is fully realized, all its components will be valid.
 * @return <code>true</code> if the component is valid, <code>false</code>
 * otherwise
 * @see #validate
 * @see #invalidate
-* @since JDK1.0
+* @since 1.0
 */
 public boolean isValid() {
 return (peer != null) && valid;
 }
 * initially visible, with the exception of top level components such
 * as <code>Frame</code> objects.
 * @return <code>true</code> if the component is visible,
 * <code>false</code> otherwise
 * @see #setVisible
-* @since JDK1.0
+* @since 1.0
 */
 @Transient
 public boolean isVisible() {
 return isVisible_NoClientCode();
 }
 * {@code Container}.
 * </ul>
 * @return <code>true</code> if the component is showing,
 *          <code>false</code> otherwise
 * @see #setVisible
-* @since JDK1.0
+* @since 1.0
 */
 public boolean isShowing() {
 if (visible && (peer != null)) {
 Container parent = this.parent;
 return (parent == null) || parent.isShowing();
 * enabled initially by default. A component may be enabled or disabled by
 * calling its <code>setEnabled</code> method.
 * @return <code>true</code> if the component is enabled,
 *          <code>false</code> otherwise
 * @see #setEnabled
-* @since JDK1.0
+* @since 1.0
 */
 public boolean isEnabled() {
 return isEnabledImpl();
 }
 *
 * @param     b   If <code>true</code>, this component is
 *            enabled; otherwise this component is disabled
 * @see #isEnabled
 * @see #isLightweight
-* @since JDK1.1
+* @since 1.1
 */
 public void setEnabled(boolean b) {
 enable(b);
 }
 *
 * @param b  if <code>true</code>, shows this component;
 * otherwise, hides this component
 * @see #isVisible
 * @see #invalidate
-* @since JDK1.1
+* @since 1.1
 */
 public void setVisible(boolean b) {
 show(b);
 }
 * Gets the foreground color of this component.
 * @return this component's foreground color; if this component does
 * not have a foreground color, the foreground color of its parent
 * is returned
 * @see #setForeground
-* @since JDK1.0
+* @since 1.0
 * @beaninfo
 *       bound: true
 */
 @Transient
 public Color getForeground() {
 * @param c the color to become this component's
 *          foreground color; if this parameter is <code>null</code>
 *          then this component will inherit
 *          the foreground color of its parent
 * @see #getForeground
-* @since JDK1.0
+* @since 1.0
 */
 public void setForeground(Color c) {
 Color oldColor = foreground;
 ComponentPeer peer = this.peer;
 foreground = c;
 * Gets the background color of this component.
 * @return this component's background color; if this component does
 *          not have a background color,
 *          the background color of its parent is returned
 * @see #setBackground
-* @since JDK1.0
+* @since 1.0
 */
 @Transient
 public Color getBackground() {
 Color background = this.background;
 if (background != null) {
 *
 * @param c the color to become this component's color;
 *          if this parameter is <code>null</code>, then this
 *          component will inherit the background color of its parent
 * @see #getBackground
-* @since JDK1.0
+* @since 1.0
 * @beaninfo
 *       bound: true
 */
 public void setBackground(Color c) {
 Color oldColor = background;
 /**
 * Gets the font of this component.
 * @return this component's font; if a font has not been set
 * for this component, the font of its parent is returned
 * @see #setFont
-* @since JDK1.0
+* @since 1.0
 */
 @Transient
 public Font getFont() {
 return getFont_NoClientCode();
 }
 * @param f the font to become this component's font;
 *          if this parameter is <code>null</code> then this
 *          component will inherit the font of its parent
 * @see #getFont
 * @see #invalidate
-* @since JDK1.0
+* @since 1.0
 * @beaninfo
 *       bound: true
 */
 public void setFont(Font f) {
 Font oldFont, newFont;
 * @see #setLocale
 * @exception IllegalComponentStateException if the <code>Component</code>
 *          does not have its own locale and has not yet been added to
 *          a containment hierarchy such that the locale can be determined
 *          from the containing parent
-* @since  JDK1.1
+* @since  1.1
 */
 public Locale getLocale() {
 Locale locale = this.locale;
 if (locale != null) {
 return locale;
 * invalidates the component hierarchy.
 *
 * @param l the locale to become this component's locale
 * @see #getLocale
 * @see #invalidate
-* @since JDK1.1
+* @since 1.1
 */
 public void setLocale(Locale l) {
 Locale oldValue = locale;
 locale = l;
 * the component on the output device.
 * @return the color model used by this component
 * @see java.awt.image.ColorModel
 * @see java.awt.peer.ComponentPeer#getColorModel()
 * @see Toolkit#getColorModel()
-* @since JDK1.0
+* @since 1.0
 */
 public ColorModel getColorModel() {
 ComponentPeer peer = this.peer;
 if ((peer != null) && ! (peer instanceof LightweightPeer)) {
 return peer.getColorModel();
 * @return an instance of <code>Point</code> representing
 *          the top-left corner of the component's bounds in
 *          the coordinate space of the component's parent
 * @see #setLocation
 * @see #getLocationOnScreen
-* @since JDK1.1
+* @since 1.1
 */
 public Point getLocation() {
 return location();
 }
 * @param y the <i>y</i>-coordinate of the new location's
 *          top-left corner in the parent's coordinate space
 * @see #getLocation
 * @see #setBounds
 * @see #invalidate
-* @since JDK1.1
+* @since 1.1
 */
 public void setLocation(int x, int y) {
 move(x, y);
 }
 *          of the new location, given in the coordinate space of this
 *          component's parent
 * @see #getLocation
 * @see #setBounds
 * @see #invalidate
-* @since JDK1.1
+* @since 1.1
 */
 public void setLocation(Point p) {
 setLocation(p.x, p.y);
 }
 * field of the <code>Dimension</code> object contains
 * this component's width.
 * @return a <code>Dimension</code> object that indicates the
 *          size of this component
 * @see #setSize
-* @since JDK1.1
+* @since 1.1
 */
 public Dimension getSize() {
 return size();
 }
 * @param width the new width of this component in pixels
 * @param height the new height of this component in pixels
 * @see #getSize
 * @see #setBounds
 * @see #invalidate
-* @since JDK1.1
+* @since 1.1
 */
 public void setSize(int width, int height) {
 resize(width, height);
 }
 *          of this component
 * @throws NullPointerException if {@code d} is {@code null}
 * @see #setSize
 * @see #setBounds
 * @see #invalidate
-* @since JDK1.1
+* @since 1.1
 */
 public void setSize(Dimension d) {
 resize(d);
 }
 * @see #setLocation(int, int)
 * @see #setLocation(Point)
 * @see #setSize(int, int)
 * @see #setSize(Dimension)
 * @see #invalidate
-* @since JDK1.1
+* @since 1.1
 */
 public void setBounds(int x, int y, int width, int height) {
 reshape(x, y, width, height);
 }
 * @see       #setLocation(int, int)
 * @see       #setLocation(Point)
 * @see       #setSize(int, int)
 * @see       #setSize(Dimension)
 * @see #invalidate
-* @since     JDK1.1
+* @since     1.1
 */
 public void setBounds(Rectangle r) {
 setBounds(r.x, r.y, r.width, r.height);
 }
 *
 * @see       #invalidate
 * @see       #doLayout()
 * @see       LayoutManager
 * @see       Container#validate
-* @since     JDK1.0
+* @since     1.0
 */
 public void validate() {
 synchronized (getTreeLock()) {
 ComponentPeer peer = this.peer;
 boolean wasValid = isValid();
 *
 * @see       #validate
 * @see       #doLayout
 * @see       LayoutManager
 * @see       java.awt.Container#isValidateRoot
-* @since     JDK1.0
+* @since     1.0
 */
 public void invalidate() {
 synchronized (getTreeLock()) {
 /* Nullify cached layout and size information.
 * For efficiency, propagate invalidate() upwards only if
 * return <code>null</code> if this component is currently not
 * displayable.
 * @return a graphics context for this component, or <code>null</code>
 *             if it has none
 * @see       #paint
-* @since     JDK1.0
+* @since     1.0
 */
 public Graphics getGraphics() {
 if (peer instanceof LightweightPeer) {
 // This is for a lightweight component, need to
 // translate coordinate spaces and clip relative
 * @return the font metrics for <code>font</code>
 * @see       #getFont
 * @see       #getPeer
 * @see       java.awt.peer.ComponentPeer#getFontMetrics(Font)
 * @see       Toolkit#getFontMetrics(Font)
-* @since     JDK1.0
+* @since     1.0
 */
 public FontMetrics getFontMetrics(Font font) {
 // This is an unsupported hack, but left in for a customer.
 // Do not remove.
 FontManager fm = FontManagerFactory.getInstance();
 * @see       #isShowing
 * @see       #getCursor
 * @see       #contains
 * @see       Toolkit#createCustomCursor
 * @see       Cursor
-* @since     JDK1.1
+* @since     1.1
 */
 public void setCursor(Cursor cursor) {
 this.cursor = cursor;
 updateCursorImmediately();
 }
 * Gets the cursor set in the component. If the component does
 * not have a cursor set, the cursor of its parent is returned.
 * If no cursor is set in the entire hierarchy,
 * <code>Cursor.DEFAULT_CURSOR</code> is returned.
 * @see #setCursor
-* @since      JDK1.1
+* @since      1.1
 */
 public Cursor getCursor() {
 return getCursor_NoClientCode();
 }
 * efficient painting code, see
 * <a href="http://www.oracle.com/technetwork/java/painting-140037.html">Painting in AWT and Swing</a>.
 *
 * @param g the graphics context to use for painting
 * @see       #update
-* @since     JDK1.0
+* @since     1.0
 */
 public void paint(Graphics g) {
 }
 /**
 * <a href="http://www.oracle.com/technetwork/java/painting-140037.html">Painting in AWT and Swing</a>.
 *
 * @param g the specified context to use for updating
 * @see       #paint
 * @see       #repaint()
-* @since     JDK1.0
+* @since     1.0
 */
 public void update(Graphics g) {
 paint(g);
 }
 * top-left corner of this component. The clipping region of the
 * graphics context is the bounding rectangle of this component.
 *
 * @param     g   the graphics context to use for painting
 * @see       #paint
-* @since     JDK1.0
+* @since     1.0
 */
 public void paintAll(Graphics g) {
 if (isShowing()) {
 GraphicsCallback.PeerPaintCallback.getInstance().
 runOneComponent(this, new Rectangle(0, 0, width, height),
 * efficient painting code, see
 * <a href="http://www.oracle.com/technetwork/java/painting-140037.html">Painting in AWT and Swing</a>.
 *
 * @see       #update(Graphics)
-* @since     JDK1.0
+* @since     1.0
 */
 public void repaint() {
 repaint(0, 0, 0, width, height);
 }
 * <a href="http://www.oracle.com/technetwork/java/painting-140037.html">Painting in AWT and Swing</a>.
 *
 * @param tm maximum time in milliseconds before update
 * @see #paint
 * @see #update(Graphics)
-* @since JDK1.0
+* @since 1.0
 */
 public void repaint(long tm) {
 repaint(tm, 0, 0, width, height);
 }
 * @param     x   the <i>x</i> coordinate
 * @param     y   the <i>y</i> coordinate
 * @param     width   the width
 * @param     height  the height
 * @see       #update(Graphics)
-* @since     JDK1.0
+* @since     1.0
 */
 public void repaint(int x, int y, int width, int height) {
 repaint(0, x, y, width, height);
 }
 * @param     x    the <i>x</i> coordinate
 * @param     y    the <i>y</i> coordinate
 * @param     width    the width
 * @param     height   the height
 * @see       #update(Graphics)
-* @since     JDK1.0
+* @since     1.0
 */
 public void repaint(long tm, int x, int y, int width, int height) {
 if (this.peer instanceof LightweightPeer) {
 // Needs to be translated to parent coordinates since
 // a parent native container provides the actual repaint
 * (<code>0</code>,&nbsp;<code>0</code>) coordinate point, is the
 * top-left corner of this component. The clipping region of the
 * graphics context is the bounding rectangle of this component.
 * @param     g   the graphics context to use for printing
 * @see       #paint(Graphics)
-* @since     JDK1.0
+* @since     1.0
 */
 public void print(Graphics g) {
 paint(g);
 }
 * (<code>0</code>,&nbsp;<code>0</code>) coordinate point, is the
 * top-left corner of this component. The clipping region of the
 * graphics context is the bounding rectangle of this component.
 * @param     g   the graphics context to use for printing
 * @see       #print(Graphics)
-* @since     JDK1.0
+* @since     1.0
 */
 public void printAll(Graphics g) {
 if (isShowing()) {
 GraphicsCallback.PeerPrintCallback.getInstance().
 runOneComponent(this, new Rectangle(0, 0, width, height),
 * @see     Graphics#drawImage(Image, int, int, Color, java.awt.image.ImageObserver)
 * @see     Graphics#drawImage(Image, int, int, java.awt.image.ImageObserver)
 * @see     Graphics#drawImage(Image, int, int, int, int, Color, java.awt.image.ImageObserver)
 * @see     Graphics#drawImage(Image, int, int, int, int, java.awt.image.ImageObserver)
 * @see     java.awt.image.ImageObserver#imageUpdate(java.awt.Image, int, int, int, int, int)
-* @since   JDK1.0
+* @since   1.0
 */
 public boolean imageUpdate(Image img, int infoflags,
 int x, int y, int w, int h) {
 int rate = -1;
 if ((infoflags & (FRAMEBITS|ALLBITS)) != 0) {
 /**
 * Creates an image from the specified image producer.
 * @param     producer  the image producer
 * @return    the image produced
-* @since     JDK1.0
+* @since     1.0
 */
 public Image createImage(ImageProducer producer) {
 ComponentPeer peer = this.peer;
 if ((peer != null) && ! (peer instanceof LightweightPeer)) {
 return peer.createImage(producer);
 *    component is not displayable.  This will always happen if
 *    <code>GraphicsEnvironment.isHeadless()</code> returns
 *    <code>true</code>.
 * @see #isDisplayable
 * @see GraphicsEnvironment#isHeadless
-* @since     JDK1.0
+* @since     1.0
 */
 public Image createImage(int width, int height) {
 ComponentPeer peer = this.peer;
 if (peer instanceof LightweightPeer) {
 if (parent != null) { return parent.createImage(width, height); }
 *                    prepare a screen representation
 * @param     observer   the <code>ImageObserver</code> object
 *                       to be notified as the image is being prepared
 * @return    <code>true</code> if the image has already been fully
 *           prepared; <code>false</code> otherwise
-* @since     JDK1.0
+* @since     1.0
 */
 public boolean prepareImage(Image image, ImageObserver observer) {
 return prepareImage(image, -1, -1, observer);
 }
 * @param     observer   the <code>ImageObserver</code> object
 *            to be notified as the image is being prepared
 * @return    <code>true</code> if the image has already been fully
 *          prepared; <code>false</code> otherwise
 * @see       java.awt.image.ImageObserver
-* @since     JDK1.0
+* @since     1.0
 */
 public boolean prepareImage(Image image, int width, int height,
 ImageObserver observer) {
 ComponentPeer peer = this.peer;
 if (peer instanceof LightweightPeer) {
 *            <code>ImageObserver</code> flags indicating what
 *            information about the image is currently available
 * @see      #prepareImage(Image, int, int, java.awt.image.ImageObserver)
 * @see      Toolkit#checkImage(Image, int, int, java.awt.image.ImageObserver)
 * @see      java.awt.image.ImageObserver
-* @since    JDK1.0
+* @since    1.0
 */
 public int checkImage(Image image, ImageObserver observer) {
 return checkImage(image, -1, -1, observer);
 }
 *            <code>ImageObserver</code> flags indicating what
 *            information about the image is currently available
 * @see      #prepareImage(Image, int, int, java.awt.image.ImageObserver)
 * @see      Toolkit#checkImage(Image, int, int, java.awt.image.ImageObserver)
 * @see      java.awt.image.ImageObserver
-* @since    JDK1.0
+* @since    1.0
 */
 public int checkImage(Image image, int width, int height,
 ImageObserver observer) {
 ComponentPeer peer = this.peer;
 if (peer instanceof LightweightPeer) {
 * where <code>x</code> and <code>y</code> are defined to be
 * relative to the coordinate system of this component.
 * @param     x   the <i>x</i> coordinate of the point
 * @param     y   the <i>y</i> coordinate of the point
 * @see       #getComponentAt(int, int)
-* @since     JDK1.1
+* @since     1.1
 */
 public boolean contains(int x, int y) {
 return inside(x, y);
 }
 * where the point's <i>x</i> and <i>y</i> coordinates are defined
 * to be relative to the coordinate system of this component.
 * @param     p     the point
 * @throws    NullPointerException if {@code p} is {@code null}
 * @see       #getComponentAt(Point)
-* @since     JDK1.1
+* @since     1.1
 */
 public boolean contains(Point p) {
 return contains(p.x, p.y);
 }
 * @return    the component or subcomponent that contains the
 *                (<i>x</i>,&nbsp;<i>y</i>) location;
 *                <code>null</code> if the location
 *                is outside this component
 * @see       #contains(int, int)
-* @since     JDK1.0
+* @since     1.0
 */
 public Component getComponentAt(int x, int y) {
 return locate(x, y);
 }
 /**
 * Returns the component or subcomponent that contains the
 * specified point.
 * @param     p   the point
 * @see       java.awt.Component#contains
-* @since     JDK1.1
+* @since     1.1
 */
 public Component getComponentAt(Point p) {
 return getComponentAt(p.x, p.y);
 }
 * @param    l   the component listener
 * @see      java.awt.event.ComponentEvent
 * @see      java.awt.event.ComponentListener
 * @see      #removeComponentListener
 * @see      #getComponentListeners
-* @since    JDK1.1
+* @since    1.1
 */
 public synchronized void addComponentListener(ComponentListener l) {
 if (l == null) {
 return;
 }
 * @param    l   the component listener
 * @see      java.awt.event.ComponentEvent
 * @see      java.awt.event.ComponentListener
 * @see      #addComponentListener
 * @see      #getComponentListeners
-* @since    JDK1.1
+* @since    1.1
 */
 public synchronized void removeComponentListener(ComponentListener l) {
 if (l == null) {
 return;
 }
 * @param    l   the focus listener
 * @see      java.awt.event.FocusEvent
 * @see      java.awt.event.FocusListener
 * @see      #removeFocusListener
 * @see      #getFocusListeners
-* @since    JDK1.1
+* @since    1.1
 */
 public synchronized void addFocusListener(FocusListener l) {
 if (l == null) {
 return;
 }
 * @param    l   the focus listener
 * @see      java.awt.event.FocusEvent
 * @see      java.awt.event.FocusListener
 * @see      #addFocusListener
 * @see      #getFocusListeners
-* @since    JDK1.1
+* @since    1.1
 */
 public synchronized void removeFocusListener(FocusListener l) {
 if (l == null) {
 return;
 }
 * @param    l   the key listener.
 * @see      java.awt.event.KeyEvent
 * @see      java.awt.event.KeyListener
 * @see      #removeKeyListener
 * @see      #getKeyListeners
-* @since    JDK1.1
+* @since    1.1
 */
 public synchronized void addKeyListener(KeyListener l) {
 if (l == null) {
 return;
 }
 * @param    l   the key listener
 * @see      java.awt.event.KeyEvent
 * @see      java.awt.event.KeyListener
 * @see      #addKeyListener
 * @see      #getKeyListeners
-* @since    JDK1.1
+* @since    1.1
 */
 public synchronized void removeKeyListener(KeyListener l) {
 if (l == null) {
 return;
 }
 * @param    l   the mouse listener
 * @see      java.awt.event.MouseEvent
 * @see      java.awt.event.MouseListener
 * @see      #removeMouseListener
 * @see      #getMouseListeners
-* @since    JDK1.1
+* @since    1.1
 */
 public synchronized void addMouseListener(MouseListener l) {
 if (l == null) {
 return;
 }
 * @param    l   the mouse listener
 * @see      java.awt.event.MouseEvent
 * @see      java.awt.event.MouseListener
 * @see      #addMouseListener
 * @see      #getMouseListeners
-* @since    JDK1.1
+* @since    1.1
 */
 public synchronized void removeMouseListener(MouseListener l) {
 if (l == null) {
 return;
 }
 * @param    l   the mouse motion listener
 * @see      java.awt.event.MouseEvent
 * @see      java.awt.event.MouseMotionListener
 * @see      #removeMouseMotionListener
 * @see      #getMouseMotionListeners
-* @since    JDK1.1
+* @since    1.1
 */
 public synchronized void addMouseMotionListener(MouseMotionListener l) {
 if (l == null) {
 return;
 }
 * @param    l   the mouse motion listener
 * @see      java.awt.event.MouseEvent
 * @see      java.awt.event.MouseMotionListener
 * @see      #addMouseMotionListener
 * @see      #getMouseMotionListeners
-* @since    JDK1.1
+* @since    1.1
 */
 public synchronized void removeMouseMotionListener(MouseMotionListener l) {
 if (l == null) {
 return;
 }
 * or not a listener is registered.
 * @param      eventsToEnable   the event mask defining the event types
 * @see        #processEvent
 * @see        #disableEvents
 * @see        AWTEvent
-* @since      JDK1.1
+* @since      1.1
 */
 protected final void enableEvents(long eventsToEnable) {
 long notifyAncestors = 0;
 synchronized (this) {
 if ((eventsToEnable & AWTEvent.HIERARCHY_EVENT_MASK) != 0 &&
 /**
 * Disables the events defined by the specified event mask parameter
 * from being delivered to this component.
 * @param      eventsToDisable   the event mask defining the event types
 * @see        #enableEvents
-* @since      JDK1.1
+* @since      1.1
 */
 protected final void disableEvents(long eventsToDisable) {
 long notifyAncestors = 0;
 synchronized (this) {
 if ((eventsToDisable & AWTEvent.HIERARCHY_EVENT_MASK) != 0 &&
 * @see       #processMouseEvent
 * @see       #processMouseMotionEvent
 * @see       #processInputMethodEvent
 * @see       #processHierarchyEvent
 * @see       #processMouseWheelEvent
-* @since     JDK1.1
+* @since     1.1
 */
 protected void processEvent(AWTEvent e) {
 if (e instanceof FocusEvent) {
 processFocusEvent((FocusEvent)e);
 * @param       e the component event
 * @see         java.awt.event.ComponentEvent
 * @see         java.awt.event.ComponentListener
 * @see         #addComponentListener
 * @see         #enableEvents
-* @since       JDK1.1
+* @since       1.1
 */
 protected void processComponentEvent(ComponentEvent e) {
 ComponentListener listener = componentListener;
 if (listener != null) {
 int id = e.getID();
 * @see         java.awt.event.FocusListener
 * @see         java.awt.KeyboardFocusManager
 * @see         #addFocusListener
 * @see         #enableEvents
 * @see         #dispatchEvent
-* @since       JDK1.1
+* @since       1.1
 */
 protected void processFocusEvent(FocusEvent e) {
 FocusListener listener = focusListener;
 if (listener != null) {
 int id = e.getID();
 * @see         #processEvent
 * @see         #dispatchEvent
 * @see         #addKeyListener
 * @see         #enableEvents
 * @see         #isShowing
-* @since       JDK1.1
+* @since       1.1
 */
 protected void processKeyEvent(KeyEvent e) {
 KeyListener listener = keyListener;
 if (listener != null) {
 int id = e.getID();
 * @param       e the mouse event
 * @see         java.awt.event.MouseEvent
 * @see         java.awt.event.MouseListener
 * @see         #addMouseListener
 * @see         #enableEvents
-* @since       JDK1.1
+* @since       1.1
 */
 protected void processMouseEvent(MouseEvent e) {
 MouseListener listener = mouseListener;
 if (listener != null) {
 int id = e.getID();
 * @param       e the mouse motion event
 * @see         java.awt.event.MouseEvent
 * @see         java.awt.event.MouseMotionListener
 * @see         #addMouseMotionListener
 * @see         #enableEvents
-* @since       JDK1.1
+* @since       1.1
 */
 protected void processMouseMotionEvent(MouseEvent e) {
 MouseMotionListener listener = mouseMotionListener;
 if (listener != null) {
 int id = e.getID();
 * invalidates the component hierarchy.
 *
 * @see       #isDisplayable
 * @see       #removeNotify
 * @see #invalidate
-* @since JDK1.0
+* @since 1.0
 */
 public void addNotify() {
 synchronized (getTreeLock()) {
 ComponentPeer peer = this.peer;
 if (peer == null || peer instanceof LightweightPeer){
 * this method should call <code>super.removeNotify</code> as
 * the first line of the overriding method.
 *
 * @see       #isDisplayable
 * @see       #addNotify
-* @since JDK1.0
+* @since 1.0
 */
 public void removeNotify() {
 KeyboardFocusManager.clearMostRecentFocusOwner(this);
 if (KeyboardFocusManager.getCurrentKeyboardFocusManager().
 getPermanentFocusOwner() == this)
 * owner.
 *
 * @return <code>true</code> if this <code>Component</code> is
 * focusable; <code>false</code> otherwise
 * @see #setFocusable
-* @since JDK1.1
+* @since 1.1
 * @deprecated As of 1.4, replaced by <code>isFocusable()</code>.
 */
 @Deprecated
 public boolean isFocusTraversable() {
 if (isFocusTraversableOverridden == FOCUS_TRAVERSABLE_UNKNOWN) {
 * @see java.awt.event.FocusEvent
 * @see #addFocusListener
 * @see #isFocusable
 * @see #isDisplayable
 * @see KeyboardFocusManager#clearGlobalFocusOwner
-* @since JDK1.0
+* @since 1.0
 */
 public void requestFocus() {
 requestFocusHelper(false, true);
 }
 /**
 * Transfers the focus to the next component, as though this Component were
 * the focus owner.
 * @see       #requestFocus()
-* @since     JDK1.1
+* @since     1.1
 */
 public void transferFocus() {
 nextFocus();
 }
 /**
 * Adds the specified popup menu to the component.
 * @param     popup the popup menu to be added to the component.
 * @see       #remove(MenuComponent)
 * @exception NullPointerException if {@code popup} is {@code null}
-* @since     JDK1.1
+* @since     1.1
 */
 public void add(PopupMenu popup) {
 synchronized (getTreeLock()) {
 if (popup.parent != null) {
 popup.parent.remove(popup);
 /**
 * Removes the specified popup menu from the component.
 * @param     popup the popup menu to be removed
 * @see       #add(PopupMenu)
-* @since     JDK1.1
+* @since     1.1
 */
 @SuppressWarnings("unchecked")
 public void remove(MenuComponent popup) {
 synchronized (getTreeLock()) {
 if (popups == null) {
 * 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  a string representation of this component's state
-* @since     JDK1.0
+* @since     1.0
 */
 protected String paramString() {
 final String thisName = Objects.toString(getName(), "");
 final String invalid = isValid() ? "" : ",invalid";
 final String hidden = visible ? "" : ",hidden";
 }
 /**
 * Returns a string representation of this component and its values.
 * @return    a string representation of this component
-* @since     JDK1.0
+* @since     1.0
 */
 public String toString() {
 return getClass().getName() + '[' + paramString() + ']';
 }
 /**
 * Prints a listing of this component to the standard system output
 * stream <code>System.out</code>.
 * @see       java.lang.System#out
-* @since     JDK1.0
+* @since     1.0
 */
 public void list() {
 list(System.out, 0);
 }
 /**
 * Prints a listing of this component to the specified output
 * stream.
 * @param    out   a print stream
 * @throws   NullPointerException if {@code out} is {@code null}
-* @since    JDK1.0
+* @since    1.0
 */
 public void list(PrintStream out) {
 list(out, 0);
 }
 * specified print stream.
 * @param     out      a print stream
 * @param     indent   number of spaces to indent
 * @see       java.io.PrintStream#println(java.lang.Object)
 * @throws    NullPointerException if {@code out} is {@code null}
-* @since     JDK1.0
+* @since     1.0
 */
 public void list(PrintStream out, int indent) {
 for (int i = 0 ; i < indent ; i++) {
 out.print(" ");
 }
 /**
 * Prints a listing to the specified print writer.
 * @param  out  the print writer to print to
 * @throws NullPointerException if {@code out} is {@code null}
-* @since JDK1.1
+* @since 1.1
 */
 public void list(PrintWriter out) {
 list(out, 0);
 }
 * the specified print writer.
 * @param out the print writer to print to
 * @param indent the number of spaces to indent
 * @throws NullPointerException if {@code out} is {@code null}
 * @see       java.io.PrintStream#println(java.lang.Object)
-* @since JDK1.1
+* @since 1.1
 */
 public void list(PrintWriter out, int indent) {
 for (int i = 0 ; i < indent ; i++) {
 out.print(" ");
 }

changeset 25144	e2bf17cee34b
parent 25104	9a002d75bd42
parent 24865	09b1d992ca72
child 25162	c388078278d4
child 25554	8376663d83d7