JavaTM Platform
Standard Ed. 6

java.awt
类 Dimension

java.lang.Object
  继承者 java.awt.geom.Dimension2D
      继承者 java.awt.Dimension
所有已实现的接口:
Serializable, Cloneable
直接已知子类:
DimensionUIResource

public class Dimension
extends Dimension2D
implements Serializable

Dimension 类封装单个对象中组件的宽度和高度(精确到整数)。该类与组件的某个属性关联。由 Component 类和 LayoutManager 接口定义的一些方法将返回 Dimension 对象。

通常,widthheight 的值是非负整数。允许创建 dimension 的构造方法不会阻止您为这些属性设置负值。如果 widthheight 的值为负,则由其他对象定义的一些方法的行为是不明确的。

从以下版本开始:
1.0
另请参见:
Component, LayoutManager, 序列化表格

字段摘要
 int height
          dimension 的高度,可以使用负值。
 int width
          dimension 的宽度,可以使用负值。
 
构造方法摘要
Dimension()
          创建 Dimension 的一个实例(宽度为零,高度为零)。
Dimension(Dimension d)
          创建 Dimension 的一个实例(宽度和高度与指定的 dimension 相同)。
Dimension(int width, int height)
          构造一个 Dimension,并将其初始化为指定宽度和高度。
 
方法摘要
 boolean equals(Object obj)
          检查两个 dimension 对象是否具有相同的值。
 double getHeight()
          返回此 Dimension 的高度(以 double 精度表示)。
 Dimension getSize()
          获取此 Dimension 对象的大小。
 double getWidth()
          返回此 Dimension 的宽度(以 double 精度表示)。
 int hashCode()
          返回此 Dimension 的哈希码。
 void setSize(Dimension d)
          将 Dimension 对象的大小设置为指定大小。
 void setSize(double width, double height)
          将此 Dimension 对象的大小设置为指定的宽度和高度(以双精度表示)。
 void setSize(int width, int height)
          将此 Dimension 对象的大小设置为指定的宽度和高度。
 String toString()
          返回此 Dimension 对象的 heightwidth 字段的字符串表示形式。
 
从类 java.awt.geom.Dimension2D 继承的方法
clone, setSize
 
从类 java.lang.Object 继承的方法
finalize, getClass, notify, notifyAll, wait, wait, wait
 

字段详细信息

width

public int width
dimension 的宽度,可以使用负值。

从以下版本开始:
1.0
另请参见:
getSize(), setSize(double, double)

height

public int height
dimension 的高度,可以使用负值。

从以下版本开始:
1.0
另请参见:
getSize(), setSize(double, double)
构造方法详细信息

Dimension

public Dimension()
创建 Dimension 的一个实例(宽度为零,高度为零)。


Dimension

public Dimension(Dimension d)
创建 Dimension 的一个实例(宽度和高度与指定的 dimension 相同)。

参数:
d - 带有 widthheight 值的指定 dimension

Dimension

public Dimension(int width,
                 int height)
构造一个 Dimension,并将其初始化为指定宽度和高度。

参数:
width - 指定宽度
height - 指定高度
方法详细信息

getWidth

public double getWidth()
返回此 Dimension 的宽度(以 double 精度表示)。

指定者:
Dimension2D 中的 getWidth
返回:
Dimension 的宽度。
从以下版本开始:
1.2

getHeight

public double getHeight()
返回此 Dimension 的高度(以 double 精度表示)。

指定者:
Dimension2D 中的 getHeight
返回:
Dimension 的高度。
从以下版本开始:
1.2

setSize

public void setSize(double width,
                    double height)
将此 Dimension 对象的大小设置为指定的宽度和高度(以双精度表示)。注意,如果 widthheight 大于 Integer.MAX_VALUE,则将其重新设置为 Integer.MAX_VALUE

指定者:
Dimension2D 中的 setSize
参数:
width - Dimension 对象的新宽度
height - Dimension 对象的新高度
从以下版本开始:
1.2

getSize

public Dimension getSize()
获取此 Dimension 对象的大小。包含此方法是出于完整性考虑,它与 Component 定义的 getSize 方法相似。

返回:
此 dimension 的大小,一个具有相同宽度和高度的 Dimension 的新实例
从以下版本开始:
1.1
另请参见:
setSize(double, double), Component.getSize()

setSize

public void setSize(Dimension d)
Dimension 对象的大小设置为指定大小。包含此方法是出于完整性考虑,它与 Component 定义的 setSize 方法相似。

参数:
d - Dimension 对象的新大小
从以下版本开始:
1.1
另请参见:
getSize(), Component.setSize(int, int)

setSize

public void setSize(int width,
                    int height)
将此 Dimension 对象的大小设置为指定的宽度和高度。包含此方法是出于完整性考虑,它与 Component 定义的 setSize 方法相似。

参数:
width - Dimension 对象的新宽度
height - Dimension 对象的新高度
从以下版本开始:
1.1
另请参见:
getSize(), Component.setSize(int, int)

equals

public boolean equals(Object obj)
检查两个 dimension 对象是否具有相同的值。

覆盖:
Object 中的 equals
参数:
obj - 要与之比较的引用对象。
返回:
如果此对象与 obj 参数相同,则返回 true;否则返回 false
另请参见:
Object.hashCode(), Hashtable

hashCode

public int hashCode()
返回此 Dimension 的哈希码。

覆盖:
Object 中的 hashCode
返回:
Dimension 的哈希码
另请参见:
Object.equals(java.lang.Object), Hashtable

toString

public String toString()
返回此 Dimension 对象的 heightwidth 字段的字符串表示形式。此方法仅用于调试目的,对于这两种实现,返回字符串的内容和格式可能有所不同。返回的字符串可以为空,但不可以为 null

覆盖:
Object 中的 toString
返回:
Dimension 对象的字符串表示形式

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策