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

@Native
public static final int BIT_DEPTH_MULTI

このディスプレイ・モードで複数のビット深さがサポートされている場合の、ビット深さを示す値です。

関連項目:

getBitDepth(), 定数フィールド値

REFRESH_RATE_UNKNOWN

@Native
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™プログラミング言語では必要ありません。)

オーバーライド:

hashCode、クラス: Object

戻り値:

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

関連項目:

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