javax.sound.sampled

クラスEnumControl

java.lang.Object

javax.sound.sampled.Control

javax.sound.sampled.EnumControl

public abstract class EnumControl
extends Control

EnumControlは離散的戻り値のセットのコントロールを提供し、各戻り値はオブジェクトによって表されます。グラフィカル・ユーザー・インタフェースでは、こうしたコントロールはボタンのセットで表示でき、各ボタンで1つの値または設定を選択します。たとえば、リバーブ・コントロールは、FloatControlオブジェクトで表示されるような連続調整が可能なパラメータを提供する代わりに、プリセット・リバーブ設定をいくつか提供することができます。

二者択一のみを提供しているコントロールは、代わりにBooleanControlとして実装可能な場合がよくあり、定量化できる側面で一連の値を提供するコントロールは、代わりに低い精度を持つFloatControlとして実装可能な場合があります。しかし、EnumControlの重要な特徴は、戻り値が数値やboolean型の値ではなく、任意のオブジェクトであるという点です。これはつまり、返された各オブジェクトはさらに情報を提供できるということです。例を挙げると、REVERBコントロールの設定は、各設定に使用されるパラメータ値を照会できる、ReverbTypeのインスタンスです。

導入されたバージョン:

1.3

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラスと説明
static class	EnumControl.Type EnumControl.Type内部クラスのインスタンスは、列挙されたコントロールの種類を識別します。

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタと説明
protected	EnumControl(EnumControl.Type type, Object[] values, Object value) 指定されたパラメータで、列挙されたコントロール・オブジェクトを新しく構築します。

メソッドのサマリー

修飾子と型	メソッドと説明
Object	getValue() このコントロールの現在の値を取得します。
Object[]	getValues() このコントロールの可能な値のセットを返します。
void	setValue(Object value) コントロールの現在の値を設定します。
String	toString() コントロールの文字列表現を提供します。

クラス javax.sound.sampled.Controlから継承されたメソッド

getType

クラス java.lang.Objectから継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

EnumControl

protected EnumControl(EnumControl.Type type,
                      Object[] values,
                      Object value)

指定されたパラメータで、列挙されたコントロール・オブジェクトを新しく構築します。

パラメータ:

type - この列挙されたコントロール・オブジェクトを表すコントロールのタイプ

values - コントロールの可能な値のセット

value - 初期コントロールの値

メソッドの詳細

setValue

public void setValue(Object value)

コントロールの現在の値を設定します。デフォルト実装では、指定された値を単に設定するだけです。指示された値がサポートされていない場合、IllegalArgumentExceptionがスローされます。コントロールによっては、値が設定されたときに影響を受けるためにラインを開く必要があります。

パラメータ:

value - 目的の新しい値

例外:

IllegalArgumentException - 指示された値が許容範囲に入らない場合

getValue

public Object getValue()

このコントロールの現在の値を取得します。

戻り値:

現行値

getValues

public Object[] getValues()

このコントロールの可能な値のセットを返します。

戻り値:

可能な値のセット

toString

public String toString()

コントロールの文字列表現を提供します。

オーバーライド:

toString、クラス: Control

戻り値:

文字列説明