Displayable (MID 프로필)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

MID 프로필

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

javax.microedition.lcdui
Class Displayable

java.lang.Object
  |
  +--javax.microedition.lcdui.Displayable

Direct Known Subclasses:: Canvas, Screen

public abstract class Displayable
extends Object

디스플레이에 놓일 수 있는 기능을 보유한 객체입니다. Displayable 객체에는 제목, 티커, 0개 이상의 명령 및 이와 연관된 수신기가 있습니다. 표시되는 내용 및 사용자와의 상호 작용은 서브 클래스에 의해 정의됩니다.

제목 문자열에는 줄 바꿈이 포함될 수 있습니다. 제목 문자열을 표시할 때는 적절하게 줄을 바꿔야 합니다. 예를 들어, 제목줄로 한 줄만 사용할 수 있고 줄 바꿈 문자열이 포함된 경우에는 줄 바꿈한 줄의 문자만 표시됩니다.

서브 클래스에 의해 다르게 지정되지 않는 경우 새로 만든 Displayable 객체의 기본 상태는 다음과 같습니다.

Display에 표시되지 않습니다.
이 Displayable과 연관된 Ticker가 없습니다.
제목이 null입니다.
Commands가 없습니다.
CommandListener가 없습니다.

Since:: MIDP 1.0

Method Summary

void addCommand(Command cmd)
          명령을 Displayable에 추가합니다.

int getHeight()
          응용 프로그램에서 사용 가능한 표시 가능 영역의 높이(픽셀 단위)를 가져옵니다.

Ticker getTicker()
          이 Displayable에 사용되는 티커를 가져옵니다.

String getTitle()
          Displayable의 제목을 가져옵니다.

int getWidth()
          응용 프로그램에서 사용 가능한 표시 가능 영역의 너비(픽셀 단위)를 가져옵니다.

boolean isShown()
          Displayable이 디스플레이에서 실제로 표시되는지 확인합니다.

void removeCommand(Command cmd)
          Displayable에서 명령을 제거합니다.

void setCommandListener(CommandListener l)
          Commands의 수신기를 Displayable로 설정하여 이전 CommandListener를 대체합니다.

void setTicker(Ticker ticker)
          이 Displayable과 함께 사용할 티커를 설정하면 이전 티커를 대체합니다.

void setTitle(String s)
          Displayable의 제목을 설정합니다.

protected void sizeChanged(int w, int h)
          Displayable의 사용 가능 영역이 변경되면 구현 시 이 메소드를 호출합니다.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getTitle

public String getTitle()

Displayable의 제목을 가져옵니다. 제목이 없는 경우 null을 반환합니다.

Returns:: 인스턴스의 제목, 또는 제목이 없는 경우 null
Since:: MIDP 2.0
See Also:: setTitle(java.lang.String)

setTitle

public void setTitle(String s)

Displayable의 제목을 설정합니다. null이 지정되면 제목을 제거합니다.

Displayable이 디스플레이에 실제로 표시되는 경우 구현 시 가능한 한 빨리 디스플레이를 업데이트해야 합니다.

제목이 있으면 Displayable 내용에서 사용 가능한 영역의 크기에 영향을 미칠 수 있습니다. 런타임 시 제목 텍스트를 추가, 제거 또는 설정하여 컨텐트 영역의 크기를 동적으로 변경할 수 있습니다. 이는 Canvas 클래스의 사용 시기를 알기 위해 가장 중요합니다. 사용 가능한 영역이 변경되면 sizeChanged()가 호출되어 응용 프로그램에 알립니다.

Parameters:: s - 새 제목, 또는 제목이 없는 경우 null
Since:: MIDP 2.0
See Also:: getTitle()

setTicker

public void setTicker(Ticker ticker)

이 Displayable과 함께 사용할 티커를 설정하면 이전 티커를 대체합니다. null인 경우 이 Displayable에서 티커 객체를 제거합니다. 같은 티커는 응용 프로그램 내의 여러 Displayable 객체에 의해 공유될 수 있습니다. 여러 다양한 Displayable 객체에서 같은 Ticker 객체와 함께 setTicker()를 호출하여 공유합니다. Displayable이 디스플레이에 실제로 표시되는 경우 구현 시 가능한 한 빨리 디스플레이를 업데이트해야 합니다.

티커가 있으면 Displayable 내용에서 사용할 수 있는 영역의 크기에 영향을 미칩니다. 런타임 시 시계를 추가, 제거 또는 설정하여 컨텐트 영역의 크기를 동적으로 변경할 수 있습니다. 이는 Canvas 클래스 사용 시기를 알기 위해 가장 중요합니다. 사용 가능한 영역이 변경되면 sizeChanged()가 호출되어 응용 프로그램에 알립니다.

Parameters:: ticker - 이 화면에 사용된 티커 객체
Since:: MIDP 2.0
See Also:: getTicker()

getTicker

public Ticker getTicker()

이 Displayable에 사용되는 티커를 가져옵니다.

Returns:: 사용된 티커 객체, 또는 티커가 없는 경우 null
Since:: MIDP 2.0
See Also:: setTicker(javax.microedition.lcdui.Ticker)

isShown

public boolean isShown()

Displayable이 디스플레이에서 실제로 표시되는지 확인합니다. Displayable이 표시되게 하려면 Display의 MIDlet이 포그라운드에서 실행 중이어야 하고 Displayable이 Display의 현재 화면이어야 하며 Displayable이 시스템 화면에 의해 흐려지면 안 됩니다.

Returns:: Displayable이 현재 표시되는 경우 true

addCommand

public void addCommand(Command cmd)

명령을 Displayable에 추가합니다. 예를 들어, 구현 시 명령을 사용 가능한 소프트 버튼 중 하나에 추가하거나 메뉴에 두도록 선택할 수 있습니다. 추가된 명령이 이미 화면에 있는 경우(객체 참조를 비교하여 테스트한 경우) 이 메소드는 아무 효과가 없습니다. Displayable이 디스플레이에 실제로 표시되고 이러한 호출이 표시 가능한 명령 집합에 영향을 미치는 경우 구현 시 가능한 한 빨리 디스플레이를 업데이트해야 합니다.

Parameters:: cmd - 추가되는 명령
Throws:: NullPointerException - cmd가 null인 경우

removeCommand

public void removeCommand(Command cmd)

Displayable에서 명령을 제거합니다. 명령이 Displayable에 있지 않은 경우(객체 참조를 비교하여 테스트한 경우), 이 메소드는 아무 효과가 없습니다. Displayable이 디스플레이에 실제로 표시되고 이러한 호출이 표시 가능한 명령 집합에 영향을 미치는 경우 구현 시 가능한 한 빨리 디스플레이를 업데이트해야 합니다. cmd가 null인 경우 이 메소드는 어떤 작업도 수행하지 않습니다.

Parameters:: cmd - 제거되는 명령

setCommandListener

public void setCommandListener(CommandListener l)

Commands의 수신기를 Displayable로 설정하여 이전 CommandListener를 대체합니다. null 참조가 허용되며 기존 수신기를 제거하는 효과가 있습니다.

Parameters:: l - 새 수신기 또는 null.

getWidth

public int getWidth()

응용 프로그램에서 사용 가능한 표시 가능 영역의 너비(픽셀 단위)를 가져옵니다. 반환되는 값은 특정 Displayable 서브 클래스에 적합합니다. 이 값은 장치가 디스플레이를 사용하는 방식에 따라 달라지며 제목, 티커 또는 명령의 존재에 영향을 받습니다. Displayable 객체가 아직 표시되어 있지 않더라도 이 메소드는 항상 올바른 결과를 반환합니다.

Returns:: 응용 프로그램에서 사용 가능한 영역의 너비
Since:: MIDP 2.0

getHeight

public int getHeight()

응용 프로그램에서 사용 가능한 표시 가능 영역의 높이(픽셀 단위)를 가져옵니다. 반환되는 특정 값은 특정 Displayable 서브 클래스에 적합합니다. 이 값은 장치가 디스플레이를 사용하는 방식에 따라 달라지며 제목, 티커 또는 명령의 존재에 영향을 받습니다. Displayable 객체가 아직 표시되지 않더라도 이 메소드는 항상 올바른 결과를 반환합니다.

Returns:: 응용 프로그램에서 사용 가능한 영역의 높이
Since:: MIDP 2.0

sizeChanged

protected void sizeChanged(int w,
                           int h)

Displayable의 사용 가능 영역이 변경되면 구현 시 이 메소드를 호출합니다. "사용 가능한 영역"은 Form에 있는 Item이나 Canvas 내의 그래픽처럼 응용 프로그램 내용이 차지할 수 있는 디스플레이의 영역입니다. 제목, 티커, 명령 레이블, 스크롤 막대, 시스템 상태 영역 등이 차지하는 공간은 포함하지 않습니다. 이러한 디스플레이 기능의 내용 변경이나 추가, 제거의 결과로 크기가 변경될 수 있습니다.

Displayable이 처음으로 표시되기 전에 이 메소드는 적어도 한 번 호출됩니다. Displayable이 표시되는 동안 크기가 변경되면 sizeChanged가 호출됩니다. Displayable이 표시되지 않는 동안 크기가 변경되면 sizeChanged에 대한 호출이 지연될 수 있습니다. Displayable이 표시되지 않는 동안 크기가 변경되는 경우 Displayable이 다시 한 번 표시되면 sizeChanged가 적어도 한 번 호출됩니다.

Displayable에 있는 이 메소드의 기본 구현 및 이 사양에 정의되는 해당 서브 클래스는 비어 있어야 합니다. 이 메소드는 응용 프로그램에 의해 무시되어야 합니다. 응용 프로그램은 Displayable의 직속 서브 클래스를 만들 수 없지만 이 메소드는 Displayable에 정의되어 있습니다. 이는 응용 프로그램이 Canvas와 Form의 서브 클래스에서 무시할 수 있도록 정의되어 있습니다. 이는 사용 가능한 디스플레이 영역 내에 내용을 맞추기 위해 Canvas 서브 클래스에서 그래픽을 맞추는데, Form에서 Item 크기 및 레이아웃 지시어를 수정하는 데 유용합니다.

Parameters:: w - 사용 가능한 영역의 새 너비(픽셀 단위); h - 사용 가능한 영역의 새 높이(픽셀 단위)
Since:: MIDP 2.0