The Dimension class is similar to the Point class, except it encapsulates a width and height in a single object. Like Point, Dimension is somewhat underused; it is used primarily by methods that need to return a width and a height as a single object; for example, getSize() returns a Dimension object.
A Dimension instance has two variables, one for width and one for height. They are accessible directly or through use of the getSize() method.
The width variable represents the size of an object along the x axis (left to right). Width should not be negative; however, there is nothing within the class to prevent this from happening.
The height variable represents the size of an object along the y axis (top to bottom). Height should not be negative; however, there is nothing within the class to prevent this from happening.
This constructor creates a Dimension instance with a width and height of 0.
This constructor creates a copy of dim. The initial width is dim.width. The initial height is dim.height.
This constructor creates a Dimension with an initial width of width and an initial height of height.
The getSize() method retrieves the current size as a new Dimension, even though the instance variables are public.
The setSize() method changes the dimension's size to width x height.
The setSize() method changes the dimension's size to d.width x d.height.
The equals() method overrides the Object.equals() method to define equality for dimensions. Two Dimension objects are equal if their width and height values are equal.
The toString() method of Dimension returns a string showing the current width and height settings. For example:
java.awt.Dimension[width=0,height=0]
This HTML Help has been published using the chm2web software. |