On 6/5/2014 9:58 PM, Steve Sides wrote:
While adding @param and @return to various swing files, I came across this. The javadoc descriptions for javax.swing.plaf.TreeUI.getPathBounds() and javax.swing.plaf.basic.BasicTreeUI.getPathBounds() have stated it returns null "if any component in path is currently valid". Is that right?

It looks wrong. It should be "hidden" instead of "valid". There are other cases when the method can return null (for example if one of the parameters is null)
   that are not described in this javadoc.
Could you create an issue on it? This API change can require the CCC request.

  Thanks,
  Alexandr.


The getPathBounds() in BasicTreeUI returns null if tree or treeState is null. Should it be l "if any component in path is currently *invalid*"? Since I essentially parrot this in the @return tag statement for TreeUI.getPathBound() , I'd rather make sure it 's correct in the first revision.

thanks for any help,

-steve

http://docs.oracle.com/javase/8/docs/api/javax/swing/plaf/TreeUI.html#getPathBounds-javax.swing.JTree-javax.swing.tree.TreePath-

 *


            getPathBounds

    public abstractRectangle  
<http://jre.us.oracle.com/java/re/jdk/9/promoted/latest/docs/api/java/awt/Rectangle.html>
  getPathBounds(JTree  
<http://jre.us.oracle.com/java/re/jdk/9/promoted/latest/docs/api/javax/swing/JTree.html>
  tree,
                                             TreePath  
<http://jre.us.oracle.com/java/re/jdk/9/promoted/latest/docs/api/javax/swing/tree/TreePath.html>
  path)
    Returns the Rectangle enclosing the label portion that the last
    item in path will be drawn into. Will return null if any component
    in path is currently valid.


http://docs.oracle.com/javase/8/docs/api/javax/swing/plaf/basic/BasicTreeUI.html#getPathBounds-javax.swing.JTree-javax.swing.tree.TreePath-

 *


            getPathBounds

    publicRectangle  
<http://jre.us.oracle.com/java/re/jdk/9/promoted/latest/docs/api/java/awt/Rectangle.html>
  getPathBounds(JTree  
<http://jre.us.oracle.com/java/re/jdk/9/promoted/latest/docs/api/javax/swing/JTree.html>
  tree,
                                    TreePath  
<http://jre.us.oracle.com/java/re/jdk/9/promoted/latest/docs/api/javax/swing/tree/TreePath.html>
  path)
    Returns the Rectangle enclosing the label portion that the last
    item in path will be drawn into. Will return null if any component
    in path is currently valid.

    Specified by:
        |getPathBounds
        
<http://jre.us.oracle.com/java/re/jdk/9/promoted/latest/docs/api/javax/swing/plaf/TreeUI.html#getPathBounds-javax.swing.JTree-javax.swing.tree.TreePath->|
 in
        class |TreeUI
        
<http://jre.us.oracle.com/java/re/jdk/9/promoted/latest/docs/api/javax/swing/plaf/TreeUI.html>|










Reply via email to