java.awt

クラス DisplayMode

java.lang.Object

java.awt.DisplayMode

public final class DisplayMode
extends Object

DisplayMode クラスは、GraphicsDevice のビットの深さ、高さ、幅、およびリフレッシュレートをカプセル化します。 グラフィックデバイスのディスプレイモードを変更する機能は、プラットフォームおよび設定に依存し、常に利用できるとはかぎりません (GraphicsDevice.isDisplayChangeSupported() を参照)。

フルスクリーン排他モード API の詳細は、「Full-Screen Exclusive Mode API Tutorial」を参照してください。

導入されたバージョン:

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) 2 つのディスプレイモードが一致するかどうかを返します。
boolean	equals(Object dm) このオブジェクトと他のオブジェクトが等しいかどうかを示します。
int	getBitDepth() ピクセルごとのビット単位で表した、ディスプレイのビットの深さを返します。
int	getHeight() ピクセル単位で表したディスプレイの高さを返します。
int	getRefreshRate() Hz 単位で表した、ディスプレイのリフレッシュレートを返します。
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 - Hz 単位で表した、ディスプレイのリフレッシュレート。 情報が利用できない場合は 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()

Hz 単位で表した、ディスプレイのリフレッシュレートを返します。 情報が利用できない場合は REFRESH_RATE_UNKNOWN になります。

戻り値:

Hz 単位で表した、ディスプレイのリフレッシュレート。

関連項目:

REFRESH_RATE_UNKNOWN

equals

public boolean equals(DisplayMode dm)

2 つのディスプレイモードが一致するかどうかを返します。

戻り値:

2 つのディスプレイモードが一致するかどうか

equals

public boolean equals(Object dm)

このオブジェクトと他のオブジェクトが等しいかどうかを示します。

equals メソッドは、null 以外のオブジェクト参照での同値関係を実装します。

• 反射性 (reflexive): null 以外の参照値 x について、x.equals(x) は true を返します。
• 対称性 (symmetric): null 以外の参照値 x および y について、y.equals(x) が true を返す場合に限り、x.equals(y) は true を返します。
• 推移性 (transitive): null 以外の参照値 x、y、および z について、x.equals(y) が true を返し、y.equals(z) が true を返す場合、x.equals(z) は true を返します。
• 一貫性 (consistent): null 以外の参照値 x および y について、x.equals(y) の複数の呼び出しは、このオブジェクトに対する equals による比較で使われた情報が変更されていなければ、一貫して true を返すか、一貫して false を返します。
• null 以外の参照値 x について、x.equals(null) は false を返します。

Object クラスの equals メソッドは、もっとも比較しやすいオブジェクトの同値関係を実装します。つまり、null 以外の参照値 x と y について、このメソッドは x と y が同じオブジェクトを参照する (x == y が true) 場合にだけ true を返します。

通常、このメソッドをオーバーライドする場合は、hashCode メソッドを常にオーバーライドして、「等価なオブジェクトは等価なハッシュコードを保持する必要がある」という hashCode メソッドの汎用規約に従う必要があることに留意してください。

オーバーライド:

equals、クラス: Object

パラメータ:

dm - 比較対象の参照オブジェクト。

戻り値:

このオブジェクトが obj 引数と同じである場合は true、それ以外の場合は false。

関連項目:

Object.hashCode(), HashMap

hashCode

public int hashCode()

オブジェクトのハッシュコード値を返します。このメソッドは、HashMap によって提供されるハッシュテーブルなどの、ハッシュテーブルの利点のためにサポートされています。

hashCode の一般的な規則は次のとおりです。

• Java アプリケーションの実行中に同じオブジェクトに対して複数回呼び出された場合は常に、このオブジェクトに対する equals の比較で使用される情報が変更されていなければ、hashCode メソッドは常に同じ整数を返す必要があります。ただし、この整数は同じアプリケーションの実行ごとに同じである必要はありません。
• equals(Object) メソッドに従って 2 つのオブジェクトが等しい場合は、2 つの各オブジェクトに対する hashCode メソッドの呼び出しによって同じ整数の結果が生成される必要があります。
• Object.equals(java.lang.Object) メソッドに従って 2 つのオブジェクトが等しくない場合は、2 つの各オブジェクトに対する hashCode メソッドの呼び出しによって異なる整数の結果が生成される必要はありません。ただし、プログラマは、等しくないオブジェクトに対して異なる整数の結果を生成すると、ハッシュテーブルのパフォーマンスが向上する場合があることに気付くはずです。

クラス Object によって定義された hashCode メソッドは、可能なかぎり、異なるオブジェクトに対して異なる整数を返します。(これは通常、オブジェクトの内部アドレスを整数に変換することによって実装されますが、この実装テクニックは Java^TM プログラミング言語では必要ありません。)

オーバーライド:

hashCode、クラス: Object

戻り値:

このオブジェクトのハッシュコード値。

関連項目:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)