javax.microedition.lcdui
Class Alert

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

public class Alert

extends Screen

경고는 다음 Displayable로 이동하기 전에 사용자에게 데이터를 표시하고 특정 시간 동안 대기하는 화면입니다. 경고에는 텍스트 문자열과 이미지가 포함될 수 있습니다. Alert의 용도는 사용자에게 오류 및 기타 예외 조건에 대해 알리는 것입니다.

응용 프로그램에서는 setTimeout(Alert.FOREVER)을 사용하여 경고 시간을 무한대로 설정할 수 있습니다. 이 경우 Alert는 모달로 간주되며 구현 시 사용자가 경고를 "닫을 수" 있는 기능을 제공하므로 경고를 닫으면 시간 초과가 즉시 만료되었을 때와 마찬가지로 다음 Displayable이 표시됩니다.

응용 프로그램에서 경고의 시간을 다양하게 지정하고 스크롤해야 할 정도로 많은 내용을 제공한 경우에는 자동으로 모달 경고가 됩니다.

경고는 자신의 특성을 표시하기 위해 연관된 AlertType을 가질 수도 있습니다. 구현 시에는 이러한 유형을 사용하여 사용자에게 Alert를 표시할 때 적절한 사운드를 재생할 수도 있습니다. AlertType.playSound()를 참조하십시오.

경고에는 선택적 Image가 포함될 수도 있습니다. Image는 변경 가능하거나 변경 불가능할 수 있습니다. Image가 변경 가능한 경우에는 Alert가 이 Image로 구성되고 setImage가 Image와 함께 호출될 때 이미지 내용의 스냅샷을 생성하는 것과 같은 기능을 합니다. Alert의 내용이 표시될 때마다 이 스냅샷이 사용됩니다. 그 후 응용 프로그램이 해당 Image를 가져오더라도 setImage에 대한 다음 호출이 있을 때까지 스냅샷은 수정되지 않습니다. Alert가 현재 디스플레이에 표시되어 있으면 스냅샷을 업데이트할 수 없습니다. 이는 응용 프로그램에서 Displayables가 표시된 다음 디스플레이에서 사라져야 할 정확한 시점을 제어할 수 없기 때문입니다.

작업 표시기

경고에는 작업 표시기나 진행 표시기로 사용되는 선택적 Gauge 객체가 포함될 수도 있습니다. 기본적으로 Alert에는 작업 표시기가 없지만 setIndicator(javax.microedition.lcdui.Gauge) 메소드를 사용하여 작업 표시기를 설정할 수 있습니다. 작업 표시기로 사용되는 Gauge 객체는 다음 제한 사항을 모두 준수해야 합니다.

• 비대화형이어야 합니다.
• 다른 컨테이너(Alert 또는 Form)가 소유하지 않아야 합니다.
• Commands가 없어야 합니다.
• ItemCommandListener가 없어야 합니다.
• 레이블이 없어야 합니다(즉, 레이블이 null이어야 함).
• 기본 너비와 높이는 모두 잠금 해제되어 있어야 합니다.
• 레이아웃 값은 LAYOUT_DEFAULT이어야 합니다.

이러한 제한 사항 중 하나라도 위반하는 Gauge 객체를 응용 프로그램에서 사용하려고 시도하면 오류가 발생합니다. 또한 Gauge 객체가 Alert 내에서 표시기로 사용되고 있는 경우 응용 프로그램은 이러한 Gauge 상태의 어느 조각도 수정할 수 없습니다.

명령 및 수신기

다른 Displayable 클래스와 같이 Alert도 응용 프로그램에 의해 설정된 CommandListener로 전달될 수 있는 Commands를 사용할 수 있습니다. Alert 클래스는 Commands 및 수신기에 대해 몇 가지 특수 동작을 추가합니다.

Alert가 만들어지는 경우 그 내부에는 암시적인 특수 Command DISMISS_COMMAND가 있습니다. 응용 프로그램이 다른 Commands를 Alert에 추가하면 DISMISS_COMMAND는 암시적으로 제거됩니다. 응용 프로그램이 다른 Commands를 모두 제거하면 DISMISS_COMMAND는 암시적으로 복원됩니다. DISMISS_COMMAND를 추가하거나 제거하려는 시도는 명시적으로 무시됩니다. 따라서 Alert에는 항상 최소 한 개의 Command가 있습니다.

Alert에 두 개 이상의 Commands가 있는 경우에는 자동으로 모달 Alert로 변경되며 시간 초과 값은 항상 FOREVER입니다. Command가 호출될 때까지 Alert는 디스플레이에 남아 있습니다. 경고에 한 개의 Command(DISMISS_COMMAND 또는 응용 프로그램에서 제공한 명령)가 있는 경우 위에 설명된 대로 Alert에는 시간이 지정된 동작이 있을 수 있습니다. 시간 초과가 발생하면 그 결과는 사용자가 Command를 명시적으로 호출한 것과 동일합니다.

Alert는 만들어질 때 해당 경고와 연관된 기본 수신기라는 CommandListener를 암시적으로 가집니다. setCommandListener(javax.microedition.lcdui.CommandListener) 메소드를 사용하여 이 수신기를 응용 프로그램에서 제공한 수신기로 바꿀 수 있습니다. 응용 프로그램이 null을 setCommandListener 메소드에 전달하여 수신기를 제거한 경우 기본 수신기가 암시적으로 복원됩니다.

Display.setCurrent(Alert, Displayable) 메소드와 Display.setCurrent(Displayable) 메소드가 Alert와 함께 호출되는 경우에는 Alert가 닫힌 후에 다른 Displayable로 자동으로 이동하는 특수 동작을 정의합니다. Alert가 닫힐 때나 명령이 호출될 때 기본 수신기가 있는 경우에만 이러한 특수 동작이 발생합니다. 사용자가 Command를 호출하고 기본 수신기가 있는 경우 기본 수신기는 Command를 무시하고 자동 진행 동작을 구현합니다.

응용 프로그램에 자체 CommandListener가 설정되어 있는 경우 자동 진행 동작을 사용할 수 없습니다. listener 코드에서 다른 Displayable로 이동해야 합니다. 응용 프로그램에서 수신기를 제공하면 일반적으로 수신기의 commandAction 메소드에 명령을 전달하여 Commands가 호출됩니다. 전달된 Command는 Alert에 있는 Commands인 DISMISS_COMMAND 또는 응용 프로그램 제공 Commands 중 하나가 됩니다.

응용 프로그램은 null을 setCommandListener 메소드에 전달하여 기본 수신기를 복원할 수 있습니다.

주: 응용 프로그램은 Alert에서 Displayable.setTicker를 사용하여 Ticker를 설정할 수 있지만 구현 제한으로 인해 표시되지 않을 수 있습니다.

Since:

MIDP 1.0

See Also:

AlertType

Field Summary

static Command	DISMISS_COMMAND Alert가 닫혔음을 나타내기 위해 Command가 수신기에 전달됩니다.
static int	FOREVER FOREVER는 사용자가 닫을 때까지 Alert가 계속 표시된다는 것을 나타냅니다.

Constructor Summary

Alert(String title)
주어진 제목으로 비어 있는 새 Alert 객체를 구성합니다.

Alert(String title, String alertText, Image alertImage, AlertType alertType)
지정된 제목, 내용 문자열 및 이미지, 경고 유형과 함께 새 Alert 객체를 구성합니다.

Method Summary

void	addCommand(Command cmd) Displayable.addCommand(javax.microedition.lcdui.Command)와 유사하지만 응용 프로그램이 먼저 Alert에 명령을 추가하면 DISMISS_COMMAND가 암시적으로 제거됩니다.
int	getDefaultTimeout() Alert를 표시하기 위한 기본 시간을 가져옵니다.
Image	getImage() Alert에 사용된 Image를 가져옵니다.
Gauge	getIndicator() 이 Alert에 대한 작업 표시기를 가져옵니다.
String	getString() Alert에 사용된 텍스트 문자열을 가져옵니다.
int	getTimeout() Alert가 표시될 시간을 가져옵니다.
AlertType	getType() Alert의 유형을 가져옵니다.
void	removeCommand(Command cmd) Displayable.removeCommand(javax.microedition.lcdui.Command)와 유사하지만 응용 프로그램이 Alert에서 마지막 명령을 제거하면 DISMISS_COMMAND가 암시적으로 추가됩니다.
void	setCommandListener(CommandListener l) Displayable.setCommandListener(javax.microedition.lcdui.CommandListener)와 같지만 다음과 같은 의미가 추가됩니다.
void	setImage(Image img) Alert에 사용된 Image를 설정합니다.
void	setIndicator(Gauge indicator) 이 Alert에 작업 표시기를 설정합니다.
void	setString(String str) Alert에 사용된 텍스트 문자열을 설정합니다.
void	setTimeout(int time) Alert를 표시해야 할 시간을 설정합니다.
void	setType(AlertType type) Alert의 유형을 설정합니다.

Methods inherited from class javax.microedition.lcdui.Displayable

getHeight, getTicker, getTitle, getWidth, isShown, setTicker, setTitle, sizeChanged

Methods inherited from class java.lang.Object

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

Field Detail

FOREVER

public static final int FOREVER

FOREVER는 사용자가 닫을 때까지 Alert가 계속 표시된다는 것을 나타냅니다. 그리고 경고가 모달임을 나타내기 위해 setTimeout()에 대한 매개 변수 값으로 사용됩니다. 모달 Alert는 지정된 시간 동안 대기하는 대신 다음 Displayable로 진행하기 전에 사용자가 버튼을 누르는 것과 같은 몇 가지 명시적 작업을 수행하기를 기다립니다.

값 -2는 FOREVER에 할당됩니다.

See Also:

Constant Field Values

DISMISS_COMMAND

public static final Command DISMISS_COMMAND

Alert가 닫혔음을 나타내기 위해 Command가 수신기에 전달됩니다. 이 명령은 다른 아무런 Command가 없는 경우 암시적으로 Alert에 있습니다. DISMISS_COMMAND의 필드 값은 다음과 같습니다.

• label = "" (빈 문자열)
• type = Command.OK
• priority = 0

응용 프로그램에 표시하는 레이블 값은 위에 지정된 것과 같아야 합니다. 하지만 구현별 레이블을 사용하여 구현 시 사용자에게 DISMISS_COMMAND를 표시할 수 있습니다.

Alert에서 DISMISS_COMMAND를 추가하거나 제거하려는 시도는 아무런 효과가 없습니다. 하지만 DISMISS_COMMAND를 다른 Displayable 유형과 함께 사용하는 경우 일반 Command로 간주됩니다.

Since:

MIDP 2.0

Constructor Detail

Alert

public Alert(String title)

주어진 제목으로 비어 있는 새 Alert 객체를 구성합니다. null이 전달되면 Alert에는 제목이 없습니다. 이 구성체를 호출하는 것은 다음을 호출하는 것과 같습니다.

    Alert(title, null, null, null)

Parameters:

title - 제목 문자열 또는 null

See Also:

Alert(String, String, Image, AlertType)

Alert

public Alert(String title,
             String alertText,
             Image alertImage,
             AlertType alertType)

지정된 제목, 내용 문자열 및 이미지, 경고 유형과 함께 새 Alert 객체를 구성합니다. 내용의 레이아웃은 구현에 따라 달라집니다. 이러한 새 경고의 시간 초과 값은 getDefaultTimeout()에서 반환하는 것과 같은 값입니다. 제공되는 Image는 변경 가능한 경우도 있고 변경 불가능한 경우도 있습니다. 특정 AlertTypes의 처리 및 동작은 AlertType에 설명되어 있습니다. null을 alertType 매개 변수 값으로 사용할 수 있으며 Alert가 특정 경고 유형을 갖지 않음을 나타냅니다. DISMISS_COMMAND는 새 Alert에 있는 유일한 Command입니다. 새 Alert와 연관된 CommandListener는 default listener로 해당 동작은 명령 및 수신기 절에 보다 자세히 설명되어 있습니다.

Parameters:

title - 제목 문자열, 또는 제목이 없는 경우 null

alertText - 문자열 내용, 또는 문자열이 없는 경우 null

alertImage - 이미지 내용, 또는 이미지가 없는 경우 null

alertType - Alert 유형, 또는 Alert에 특정 유형이 없는 경우 null

Method Detail

getDefaultTimeout

public int getDefaultTimeout()

Alert를 표시하기 위한 기본 시간을 가져옵니다. 이는 시간을 밀리초로 나타내는 양수 값이거나 Alert가 기본적으로 모달임을 나타내는 특수 값 FOREVER입니다. 반환되는 값은 구현에 따라 달라지며 각 구현에 맞게 조정됩니다.

Returns:

기본 시간 초과(밀리초) 또는 FOREVER

getTimeout

public int getTimeout()

Alert가 표시될 시간을 가져옵니다. 시간을 밀리초로 나타내는 양수 값이거나 Alert가 모달임을 나타내는 특수 값 FOREVER입니다. 이 값은 응용 프로그램이 setTimeout(int)을 호출하여 설정한 값과 반드시 같은 것은 아닙니다. 특히 Alert가 스크롤해야 할 정도로 많은 경고 내용으로 인해 모달이 된 경우 getTimeout에서 반환하는 값은 FOREVER가 됩니다.

Returns:

기본 시간 초과(밀리초) 또는 FOREVER

See Also:

setTimeout(int)

setTimeout

public void setTimeout(int time)

Alert를 표시해야 할 시간을 설정합니다. 이 시간은 양수 시간 값(밀리초)이거나 특수 값 FOREVER입니다.

Parameters:

time - 기본 시간 초과(밀리초) 또는 FOREVER

Throws:

IllegalArgumentException - 시간이 양수도 아니고 FOREVER도 아닌 경우

See Also:

getTimeout()

getType

public AlertType getType()

Alert의 유형을 가져옵니다.

Returns:

AlertType의 인스턴스에 대한 참조, 또는 Alert에 특정 유형이 없는 경우 null

See Also:

setType(javax.microedition.lcdui.AlertType)

setType

public void setType(AlertType type)

Alert의 유형을 설정합니다. 특정 AlertTypes의 처리 및 동작은 AlertType에 설명되어 있습니다

Parameters:

type - AlertType, 또는 Alert에 특정 유형이 없는 경우 null

See Also:

getType()

getString

public String getString()

Alert에 사용된 텍스트 문자열을 가져옵니다.

Returns:

Alert의 텍스트 문자열, 또는 텍스트가 없는 경우 null

See Also:

setString(java.lang.String)

setString

public void setString(String str)

Alert에 사용된 텍스트 문자열을 설정합니다.

setString에 대한 호출을 통해 내용이 업데이트될 때 Alert가 디스플레이에 표시되면 구현 시 실행 가능한 경우 디스플레이가 즉시 새 내용으로 업데이트됩니다.

Parameters:

str - Alert의 텍스트 문자열, 또는 텍스트가 없는 경우 null

See Also:

getString()

getImage

public Image getImage()

Alert에 사용된 Image를 가져옵니다.

Returns:

Alert의 이미지, 또는 이미지가 없는 경우 null

See Also:

setImage(javax.microedition.lcdui.Image)

setImage

public void setImage(Image img)

Alert에 사용된 Image를 설정합니다. Image는 변경 가능한 경우도 있고 변경 불가능한 경우도 있습니다. img가 null인 경우 이 Alert에 이미지가 없도록 지정합니다. img가 변경 가능한 경우에는 setImage를 호출하기 직전에 img 내용의 스냅샷을 생성하는 것과 같은 기능을 합니다. Alert의 내용이 표시될 때마다 이 스냅샷이 사용됩니다. img가 이미 이 Alert의 Image인 경우에는 이미지 내용의 새 스냅샷을 생성하는 것과 같은 기능을 합니다. 따라서 Alert에 포함된 변경 가능한 이미지를 그린 후 응용 프로그램에서 다음 명령

    alert.setImage(alert.getImage());    

를 호출하여 해당 Image의 Alert 스냅샷을 갱신할 수 있습니다.

setImage에 대한 호출을 통해 내용이 업데이트될 때 Alert가 디스플레이에 표시되는 경우 구현 시 실행 가능한 경우 디스플레이가 즉시 새 스냅샷으로 업데이트됩니다.

Parameters:

img - Alert의 이미지, 또는 이미지가 없는 경우 null

See Also:

getImage()

setIndicator

public void setIndicator(Gauge indicator)

이 Alert에 작업 표시기를 설정합니다. 작업 표시기는 Gauge 객체입니다. Alert의 작업 표시기로 사용하려면 제한된 상태에 있어야 합니다. 제한 사항은 위에 나열되어 있습니다. Gauge 객체가 이러한 제한 사항 중 하나를 위반하면 IllegalArgumentException이 발생합니다.

indicator가 null인 경우 이 Alert에 있는 작업 표시기를 제거합니다.

Parameters:

indicator - 이 Alert에 대한 작업 표시기, 또는 작업 표시기가 없는 경우 null

Throws:

IllegalArgumentException - indicator가 Alert의 사용에 대한 제한을 충족시키지 못하는 경우

Since:

MIDP 2.0

See Also:

getIndicator()

getIndicator

public Gauge getIndicator()

이 Alert에 대한 작업 표시기를 가져옵니다.

Returns:

이 Alert의 작업 표시기에 대한 참조, 또는 참조가 없는 경우 null

Since:

MIDP 2.0

See Also:

setIndicator(javax.microedition.lcdui.Gauge)

addCommand

public void addCommand(Command cmd)

Displayable.addCommand(javax.microedition.lcdui.Command)와 유사하지만 응용 프로그램이 먼저 Alert에 명령을 추가하면 DISMISS_COMMAND가 암시적으로 제거됩니다. DISMISS_COMMAND를 매개 변수로 사용하여 이 메소드를 호출하면 효과가 없습니다.

Overrides:

addCommand in class Displayable

Parameters:

cmd - 추가되는 명령

Throws:

NullPointerException - cmd가 null인 경우

removeCommand

public void removeCommand(Command cmd)

Displayable.removeCommand(javax.microedition.lcdui.Command)와 유사하지만 응용 프로그램이 Alert에서 마지막 명령을 제거하면 DISMISS_COMMAND가 암시적으로 추가됩니다. DISMISS_COMMAND를 매개 변수로 사용하여 이 메소드를 호출하면 효과가 없습니다.

Overrides:

removeCommand in class Displayable

Parameters:

cmd - 제거되는 명령

setCommandListener

public void setCommandListener(CommandListener l)

Displayable.setCommandListener(javax.microedition.lcdui.CommandListener)와 같지만 다음과 같은 의미가 추가됩니다. listener 매개 변수가 null인 경우 기본 수신기가 복원됩니다. 기본 수신기의 동작 정의에 대해서는 명령 및 수신기를 참조하십시오.

Overrides:

setCommandListener in class Displayable

Parameters:

l - 새 수신기 또는 null