After adding a point, a call to contains with the added point as an argument does not necessarily return true. The contains method does not return true for points on the right or bottom edges of a rectangle. Therefore, if the added point falls on the left or bottom edge of the enlarged rectangle, contains returns false for that point.
Parameters:
- newx - the X coordinate of the new point
- newy - the Y coordinate of the new point
Since: 1.2

If this Rectangle has any dimension less than zero, the rules for non-existant rectangles apply. In that case, the new bounds of this Rectangle will have a location equal to the specified coordinates and width and height equal to zero.

After adding a point, a call to contains with the added point as an argument does not necessarily return true. The contains method does not return true for points on the right or bottom edges of a Rectangle. Therefore, if the added point falls on the right or bottom edge of the enlarged Rectangle, contains returns false for that point. If the specified point must be contained within the new Rectangle, a 1x1 rectangle should be added instead:

     r.add(newx, newy, 1, 1);
 

If this Rectangle has any dimension less than zero, the rules for non-existant rectangles apply. In that case, the new bounds of this Rectangle will have a location equal to the coordinates of the specified Point and width and height equal to zero.

After adding a Point, a call to contains with the added Point as an argument does not necessarily return true. The contains method does not return true for points on the right or bottom edges of a Rectangle. Therefore if the added Point falls on the right or bottom edge of the enlarged Rectangle, contains returns false for that Point. If the specified point must be contained within the new Rectangle, a 1x1 rectangle should be added instead:

     r.add(pt.x, pt.y, 1, 1);
 

After adding a point, a call to contains with the added point as an argument does not necessarily return true. The contains method does not return true for points on the right or bottom edges of a rectangle. Therefore, if the added point falls on the left or bottom edge of the enlarged rectangle, contains returns false for that point.
Parameters:
- pt - the new Point2D to add to this Rectangle2D.
Since: 1.2

If either Rectangle has any dimension less than 0, the result will have the dimensions of the other Rectangle. If both Rectangles have at least one dimension less than 0, the result will have at least one dimension less than 0.

If either Rectangle has one or both dimensions equal to 0, the result along those axes with 0 dimensions will be equivalent to the results obtained by adding the corresponding origin coordinate to the result rectangle along that axis, similar to the operation of the Rectangle.add(Point) method, but contribute no further dimension beyond that.

If the resulting Rectangle would have a dimension too large to be expressed as an int, the result will have a dimension of Integer.MAX_VALUE along that dimension.
Parameters:
- r - the specified Rectangle

The Shape.contains() method allows a Shape implementation to conservatively return false when:

• the intersect method returns true and
• the calculations to determine whether or not the Shape entirely contains the rectangular area are prohibitively expensive.

• 
  the intersect method returns true and
  
• 
  the calculations to determine whether or not the
  Shape entirely contains the Rectangle2D
  are prohibitively expensive.
  

This method is included for completeness, to parallel the getBounds method of Component.
Returns: a new Rectangle, equal to the bounding Rectangle for this Rectangle.
Since: 1.1
See Also: Component.getBounds(), Rectangle.setBounds(Rectangle), Rectangle.setBounds(int, int, int, int),

You can specify the listenerType argument with a class literal, such as FooListener.class. For example, you can query a DefaultCaret c for its change listeners with the following code:

ChangeListener[] cls = (ChangeListener[])(c.getListeners(ChangeListener.class));

This method is included for completeness, to parallel the getLocation method of Component.
Returns: the Point that is the upper-left corner of this Rectangle.
Since: 1.1
See Also: Component.getLocation(), Rectangle.setLocation(Point), Rectangle.setLocation(int, int),

This method is included for completeness, to parallel the getSize method of Component.
Returns: a Dimension, representing the size of this Rectangle.
Since: 1.1
See Also: Component.getSize(), Rectangle.setSize(Dimension), Rectangle.setSize(int, int),

This method modifies the Rectangle so that it is h units larger on both the left and right side, and v units larger at both the top and bottom.

The new Rectangle has (x - h, y - v) as its upper-left corner, width of (width + 2h), and a height of (height + 2v).

If negative values are supplied for h and v, the size of the Rectangle decreases accordingly. The grow method will check for integer overflow and underflow, but does not check whether the resulting values of width and height grow from negative to non-negative or shrink from non-negative to negative.
Parameters:
- h - the horizontal expansion
- v - the vertical expansion

The Shape.intersects() method allows a Shape implementation to conservatively return true when:

• there is a high probability that the rectangular area and the Shape intersect, but
• the calculations to accurately determine this intersection are prohibitively expensive.

• 
  there is a high probability that the Rectangle2D and the
  Shape intersect, but
  
• 
  the calculations to accurately determine this intersection
  are prohibitively expensive.
  

This method returns whether or not the Caret is currently in a blinking state. It does not provide information as to whether it is currently blinked on or off. To determine if the caret is currently painted use the isVisible method.
Returns: true if active else false
Since: 1.5
See Also: DefaultCaret.isVisible(),

Subclasses that wish to render a different flashing caret should override paint and only paint the caret if this method returns true.
Returns: true if visible else false
See Also: Caret.isVisible(), DefaultCaret.isActive(),

Parameters:
- x - the X coordinate of the new location
- y - the Y coordinate of the new location

If there are multiple text directions present in the associated document, a flag indicating the caret bias will be rendered. This will occur only if the associated document is a subclass of AbstractDocument and there are multiple bidi levels present in the bidi element structure (i.e. the text has multiple directions associated with it).
Parameters:
- g - the graphics context
See Also: DefaultCaret.damage(java.awt.Rectangle),

This method is thread safe, although most Swing methods are not. Please see How to Use Threads for more information.

Parameters:
- x - the new X coordinate for the upper-left corner of this Rectangle
- y - the new Y coordinate for the upper-left corner of this Rectangle
- width - the new width for this Rectangle
- height - the new height for this Rectangle

Parameters:
- width - the new width for this Rectangle
- height - the new height for this Rectangle

This method is included for completeness, to parallel the setBounds method of Component.
Parameters:
- x - the new X coordinate for the upper-left corner of this Rectangle
- y - the new Y coordinate for the upper-left corner of this Rectangle
- width - the new width for this Rectangle
- height - the new height for this Rectangle
Since: 1.1
See Also: Rectangle.getBounds(), Component.setBounds(int, int, int, int),

This method is included for completeness, to parallel the setBounds method of Component.
Parameters:
- r - the specified Rectangle
Since: 1.1
See Also: Rectangle.getBounds(), Component.setBounds(java.awt.Rectangle),

This method is included for completeness, to parallel the setLocation method of Component.
Parameters:
- x - the X coordinate of the new location
- y - the Y coordinate of the new location
Since: 1.1
See Also: Rectangle.getLocation(), Component.setLocation(int, int),

This method is included for completeness, to parallel the setLocation method of Component.
Parameters:
- p - the Point specifying the new location for this Rectangle
Since: 1.1
See Also: Component.setLocation(java.awt.Point), Rectangle.getLocation(),

This method is included for completeness, to parallel the setSize method of Component.
Parameters:
- d - the new size for the Dimension object
Since: 1.1
See Also: Component.setSize(java.awt.Dimension), Rectangle.getSize(),

This method is included for completeness, to parallel the setSize method of Component.
Parameters:
- width - the new width for this Rectangle
- height - the new height for this Rectangle
Since: 1.1
See Also: Component.setSize(int, int), Rectangle.getSize(),

The following update policies are allowed:

• NEVER_UPDATE: the caret stays at the same absolute position in the document regardless of any document updates, except when document length becomes less than the current caret position due to removal. In that case caret position is adjusted to the end of the document. The caret doesn't try to keep itself visible by scrolling the associated view when using this policy.
• ALWAYS_UPDATE: the caret always tracks document changes. For regular changes it increases its position if an insertion occurs before or at its current position, and decreases position if a removal occurs before its current position. For undo/redo updates it is always moved to the position where update occurred. The caret also tries to keep itself visible by calling adjustVisibility method.
• UPDATE_WHEN_ON_EDT: acts like ALWAYS_UPDATE if the document updates are performed on the Event Dispatching Thread and like NEVER_UPDATE if updates are performed on other thread.

The default property value is UPDATE_WHEN_ON_EDT.
Parameters:
- policy - one of the following values : UPDATE_WHEN_ON_EDT, NEVER_UPDATE, ALWAYS_UPDATE
Throws:
- IllegalArgumentException - if invalid value is passed
Since: 1.5
See Also: DefaultCaret.getUpdatePolicy(), DefaultCaret.adjustVisibility(java.awt.Rectangle), DefaultCaret.UPDATE_WHEN_ON_EDT, DefaultCaret.NEVER_UPDATE, DefaultCaret.ALWAYS_UPDATE,

Here's a list showing the potential return values of both isActive and isVisible after calling this method:

setVisible(true):

• isActive(): true
• isVisible(): true or false depending on whether or not the caret is blinked on or off

setVisible(false):

• isActive(): false
• isVisible(): false

If either Rectangle has any dimension less than zero the rules for non-existant rectangles apply. If only one has a dimension less than zero, then the result will be a copy of the other Rectangle. If both have dimension less than zero, then the result will have at least one dimension less than zero.

If the resulting Rectangle would have a dimension too large to be expressed as an int, the result will have a dimension of Integer.MAX_VALUE along that dimension.
Returns: the smallest Rectangle containing both the specified Rectangle and this Rectangle.
Parameters:
- r - the specified Rectangle