java.awt
类 DisplayMode

java.lang.Object
  java.awt.DisplayMode

public final class DisplayMode
extends Object

DisplayMode 类封装 GraphicsDevice 的位深、高度、宽度和刷新率。更改图形设备的显示模式的能力是与平台和配置有关的，可能并不总是可用的（请参见 GraphicsDevice.isDisplayChangeSupported()）。

有关全屏独占模式的更多信息，请参阅全屏独占模式 API 教程。

从以下版本开始：

1.4

另请参见：

GraphicsDevice, GraphicsDevice.isDisplayChangeSupported(), GraphicsDevice.getDisplayModes(), GraphicsDevice.setDisplayMode(java.awt.DisplayMode)

字段摘要

static int	BIT_DEPTH_MULTI 位深的值（如果此显示模式支持多个位深）。
static int	REFRESH_RATE_UNKNOWN 刷新率的值（如果未知）。

构造方法摘要

DisplayMode(int width, int height, int bitDepth, int refreshRate)
使用提供的参数创建一个新的显示模式对象。

方法摘要

boolean	equals(DisplayMode dm) 返回对两个显示模式是否相同的判断。
boolean	equals(Object dm) 指示其他某个对象是否与此对象“相等”。
int	getBitDepth() 返回显示的位深（以位/像素表示）。
int	getHeight() 返回显示的高度（以像素表示）。
int	getRefreshRate() 返回显示的刷新率（以赫兹表示）如果信息不可用，则它可以是 REFRESH_RATE_UNKNOWN。
int	getWidth() 返回显示的宽度（以像素表示）。
int	hashCode() 返回该对象的哈希码值。

从类 java.lang.Object 继承的方法

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

字段详细信息

BIT_DEPTH_MULTI

public static final int BIT_DEPTH_MULTI

位深的值（如果此显示模式支持多个位深）。

另请参见：

getBitDepth(), 常量字段值

REFRESH_RATE_UNKNOWN

public static final int REFRESH_RATE_UNKNOWN

刷新率的值（如果未知）。

另请参见：

getRefreshRate(), 常量字段值

构造方法详细信息

DisplayMode

public DisplayMode(int width,
                   int height,
                   int bitDepth,
                   int refreshRate)

使用提供的参数创建一个新的显示模式对象。

参数：

width - 显示的宽度（用像素表示）

height - 显示的高度（用像素表示）

bitDepth - 显示的位深（用位/像素表示）。如果有多个位深可用，它可以是 BIT_DEPTH_MULTI。

refreshRate - 显示的刷新率（以赫兹表示）。如果信息不可用，则它可以是 REFRESH_RATE_UNKNOWN。

另请参见：

BIT_DEPTH_MULTI, REFRESH_RATE_UNKNOWN

方法详细信息

getHeight

public int getHeight()

返回显示的高度（以像素表示）。

返回：

显示的高度（以像素表示）

getWidth

public int getWidth()

返回显示的宽度（以像素表示）。

返回：

显示的宽度（以像素表示）

getBitDepth

public int getBitDepth()

返回显示的位深（以位/像素表示）。如果此显示模式支持多个位深，则它可以是 BIT_DEPTH_MULTI。

返回：

显示的刷新率（以赫兹表示）。

另请参见：

BIT_DEPTH_MULTI

getRefreshRate

public int getRefreshRate()

返回显示的刷新率（以赫兹表示）如果信息不可用，则它可以是 REFRESH_RATE_UNKNOWN。 返回显示的刷新率（以赫兹表示）。

另请参见：

REFRESH_RATE_UNKNOWN

equals

public boolean equals(DisplayMode dm)

返回对两个显示模式是否相同的判断。

返回：

两个显示模式是否相同

equals

public boolean equals(Object dm)

指示其他某个对象是否与此对象“相等”。

equals 方法在非空对象引用上实现相等关系：

• 自反性：对于任何非空引用值 x，x.equals(x) 都应返回 true。
• 对称性：对于任何非空引用值 x 和 y，当且仅当 y.equals(x) 返回 true 时，x.equals(y) 才应返回 true。
• 传递性：对于任何非空引用值 x、y 和 z，如果 x.equals(y) 返回 true，并且 y.equals(z) 返回 true，那么 x.equals(z) 应返回 true。
• 一致性：对于任何非空引用值 x 和 y，多次调用 x.equals(y) 始终返回 true 或始终返回 false，前提是对象上 equals 比较中所用的信息没有被修改。
• 对于任何非空引用值 x，x.equals(null) 都应返回 false。

Object 类的 equals 方法实现对象上差别可能性最大的相等关系；即，对于任何非空引用值 x 和 y，当且仅当 x 和 y 引用同一个对象时，此方法才返回 true（x == y 具有值 true）。

注意：当此方法被重写时，通常有必要重写 hashCode 方法，以维护 hashCode 方法的常规协定，该协定声明相等对象必须具有相等的哈希码。

覆盖：

类 Object 中的 equals

参数：

dm - 要与之比较的引用对象。

返回：

如果此对象与 obj 参数相同，则返回 true；否则返回 false。

另请参见：

Object.hashCode(), Hashtable

hashCode

public int hashCode()

返回该对象的哈希码值。支持此方法是为了提高哈希表（例如 java.util.Hashtable 提供的哈希表）的性能。

hashCode 的常规协定是：

• 在 Java 应用程序执行期间，在对同一对象多次调用 hashCode 方法时，必须一致地返回相同的整数，前提是将对象进行 equals 比较时所用的信息没有被修改。从某一应用程序的一次执行到同一应用程序的另一次执行，该整数无需保持一致。
• 如果根据 equals(Object) 方法，两个对象是相等的，那么对这两个对象中的每个对象调用 hashCode 方法都必须生成相同的整数结果。
• 如果根据 Object.equals(java.lang.Object) 方法，两个对象不相等，那么对这两个对象中的任一对象上调用 hashCode 方法不 要求一定生成不同的整数结果。但是，程序员应该意识到，为不相等的对象生成不同整数结果可以提高哈希表的性能。

实际上，由 Object 类定义的 hashCode 方法确实会针对不同的对象返回不同的整数。（这一般是通过将该对象的内部地址转换成一个整数来实现的，但是 Java^TM 编程语言不需要这种实现技巧。）

覆盖：

类 Object 中的 hashCode

返回：

此对象的一个哈希码值。

另请参见：

Object.equals(java.lang.Object), Hashtable