javax.microedition.media
インタフェース Controllable

既知のサブインタフェースの一覧:

Player

public interface Controllable

Controllable は Player のようなオブジェクトから Control を入手するためのインタフェースを提供します。 それは全てのサポートする Control について問い合わせ、クラス名に基づく特定の Control を入手するメソッドを提供します。

getControls

Control[] getControls()

このインタフェースを実装するオブジェクトから Control のコレクションを取得します。

単一のオブジェクトが複数の Control インタフェースを実装することができるため、各オブジェクト対して異なった Control タイプでチェックすることが必要です。 例えば：

 Controllable controllable;
     :
 Control cs[];
 cs = controllable.getControls();
 for (int i = 0; i < cs.length; i++) {
     if (cs[i] instanceof ControlTypeA)
         doSomethingA();
     if (cs[i] instanceof ControlTypeB)
         doSomethingB();
     // etc. 
 }

オブジェクトが返す Control のリストにはどのような重複も含みません。 そしてリストは時間が経過しても変化しません。

Control をまったくサポートしないのであれば長さがゼロの配列を返します。

戻り値:

Control オブジェクトのコレクションを返します。

例外:

IllegalStateException - getControls が間違った状態で呼ばれたときに throw します。その他の詳細については Player を参照してください。

getControl

Control getControl(String controlType)

指定された Control インタフェースを実装するオブジェクトを取得します。

指定された Control インタフェースをサポートしていなければ null を返します。

Controllable は、指定された Control インタフェースを実装する複数のオブジェクトをサポートしているなら、それらのうち１つだけを返します。 Control タイプの全てを取得するためには getControls メソッドを使用してください。そして要求されたタイプが存在するか否かリストをチェックしてください。

パラメータ:

controlType - Control のクラス名を渡します。 クラス名はクラスの完全修飾名を渡さなければなりません； また、クラスのパッケージ名を指定しないのであれば、パッケージ javax.microedition.media.control が指定されたものと想定します。

戻り値:

コントロールを実装するオブジェクトまたは null を返します。

例外:

IllegalArgumentException - パラメータ controlType が null ならば throw します。

IllegalStateException - getControl が間違った状態で呼ばれたときに throw します。その他の詳細については Player を参照してください。