javax.microedition.media
Interface Controllable

All Known Subinterfaces:

Player

public interface Controllable

Controllable은 Player와 같은 객체에서 Control을 가져오기 위한 인터페이스를 제공합니다. 또한 지원되는 Control을 모두 쿼리하고 클래스 이름을 기반으로 특정 Control을 가져오기 위한 메소드를 제공합니다.

Method Summary

Control	getControl(String controlType) 지정된 Control 인터페이스를 구현하는 객체를 가져옵니다.
Control[]	getControls() 이 인터페이스를 구현하는 객체에서 Control 모음을 가져옵니다.

Method Detail

getControls

public 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이 지원되지 않으면 길이가 0인 배열이 반환됩니다.

Returns:

Control 객체 모음

Throws:

IllegalStateException - getControls가 잘못된 상태에서 호출된 경우 발생합니다. 자세한 내용은 Player를 참조하십시오.

getControl

public Control getControl(String controlType)

지정된 Control 인터페이스를 구현하는 객체를 가져옵니다.

지정된 Control 인터페이스가 지원되지 않는 경우에는 null이 반환됩니다.

Controllable이 지정된 동일한 Control 인터페이스를 구현하는 여러 객체를 지원하는 경우에는 그 중 하나만이 반환됩니다. 해당 유형의 모든 Control을 얻으려면 getControls 메소드를 사용하여 요청된 유형의 목록을 확인합니다.

Parameters:

controlType - Control의 클래스 이름. 클래스 이름은 클래스의 전체 이름으로 제공되어야 하며 클래스의 패키지가 제공되지 않는 경우 javax.microedition.media.control 패키지로 간주합니다.

Returns:

컨트롤을 구현하는 객체 또는 null

Throws:

IllegalArgumentException - controlType이 null인 경우 발생합니다.

IllegalStateException - getControl이 잘못된 상태에서 호출된 경우 발생합니다. 자세한 내용은 Player를 참조하십시오.