Class Alert

package javax.microedition.lcdui

java.lang.Object
  |
  +--javax.microedition.lcdui.Displayable
        |
        +--javax.microedition.lcdui.Screen
              |
              +--javax.microedition.lcdui.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

필드 요약

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

생성자 요약

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

메서드 요약

• 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 의 유형을 설정합니다.

필드 상세

FOREVER

public static final int FOREVER

See Also:

• Constant Field Values

DISMISS_COMMAND

public static final Command DISMISS_COMMAND

Since:

• MIDP 2.0

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:

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

getDefaultTimeout

public int getDefaultTimeout()

Returns:

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

getTimeout

public int getTimeout()

Returns:

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

See Also:

• setTimeout(int)

setTimeout

public void setTimeout(int time)

Parameters:

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

Throws:

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

See Also:

• getTimeout()

getType

public AlertType getType()

Returns:

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

See Also:

• setType(javax.microedition.lcdui.AlertType)

setType

public void setType(AlertType type)

Parameters:

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

See Also:

• getType()

getString

public String getString()

Returns:

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

See Also:

• setString(java.lang.String)

setString

public void setString(String str)

Parameters:

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

See Also:

• getString()

getImage

public Image getImage()

Returns:

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

See Also:

• setImage(javax.microedition.lcdui.Image)

setImage

public void setImage(Image img)

Parameters:

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

See Also:

• getImage()

setIndicator

public void setIndicator(Gauge indicator)

Parameters:

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

Throws:

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

Since:

• MIDP 2.0

See Also:

• getIndicator()

getIndicator

public Gauge getIndicator()

Returns:

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

Since:

• MIDP 2.0

See Also:

• setIndicator(javax.microedition.lcdui.Gauge)

addCommand

public void addCommand(Command cmd)

Overrides:

• addCommand in class Displayable

Parameters:

• cmd - 추가되는 명령

Throws:

• NullPointerException - cmd가 null인 경우

removeCommand

public void removeCommand(Command cmd)

Overrides:

• removeCommand in class Displayable

Parameters:

• cmd - 제거되는 명령

setCommandListener

public void setCommandListener(CommandListener l)

Overrides:

• setCommandListener in class Displayable

Parameters:

• l - 새 수신기 또는 null

생성자 상세

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:

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

getDefaultTimeout

public int getDefaultTimeout()

Returns:

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

getTimeout

public int getTimeout()

Returns:

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

See Also:

• setTimeout(int)

setTimeout

public void setTimeout(int time)

Parameters:

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

Throws:

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

See Also:

• getTimeout()

getType

public AlertType getType()

Returns:

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

See Also:

• setType(javax.microedition.lcdui.AlertType)

setType

public void setType(AlertType type)

Parameters:

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

See Also:

• getType()

getString

public String getString()

Returns:

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

See Also:

• setString(java.lang.String)

setString

public void setString(String str)

Parameters:

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

See Also:

• getString()

getImage

public Image getImage()

Returns:

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

See Also:

• setImage(javax.microedition.lcdui.Image)

setImage

public void setImage(Image img)

Parameters:

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

See Also:

• getImage()

setIndicator

public void setIndicator(Gauge indicator)

Parameters:

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

Throws:

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

Since:

• MIDP 2.0

See Also:

• getIndicator()

getIndicator

public Gauge getIndicator()

Returns:

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

Since:

• MIDP 2.0

See Also:

• setIndicator(javax.microedition.lcdui.Gauge)

addCommand

public void addCommand(Command cmd)

Overrides:

• addCommand in class Displayable

Parameters:

• cmd - 추가되는 명령

Throws:

• NullPointerException - cmd가 null인 경우

removeCommand

public void removeCommand(Command cmd)

Overrides:

• removeCommand in class Displayable

Parameters:

• cmd - 제거되는 명령

setCommandListener

public void setCommandListener(CommandListener l)

Overrides:

• setCommandListener in class Displayable

Parameters:

• l - 새 수신기 또는 null

메서드 상세

getDefaultTimeout

public int getDefaultTimeout()

Returns:

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

getTimeout

public int getTimeout()

Returns:

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

See Also:

• setTimeout(int)

setTimeout

public void setTimeout(int time)

Parameters:

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

Throws:

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

See Also:

• getTimeout()

getType

public AlertType getType()

Returns:

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

See Also:

• setType(javax.microedition.lcdui.AlertType)

setType

public void setType(AlertType type)

Parameters:

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

See Also:

• getType()

getString

public String getString()

Returns:

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

See Also:

• setString(java.lang.String)

setString

public void setString(String str)

Parameters:

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

See Also:

• getString()

getImage

public Image getImage()

Returns:

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

See Also:

• setImage(javax.microedition.lcdui.Image)

setImage

public void setImage(Image img)

Parameters:

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

See Also:

• getImage()

setIndicator

public void setIndicator(Gauge indicator)

Parameters:

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

Throws:

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

Since:

• MIDP 2.0

See Also:

• getIndicator()

getIndicator

public Gauge getIndicator()

Returns:

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

Since:

• MIDP 2.0

See Also:

• setIndicator(javax.microedition.lcdui.Gauge)

addCommand

public void addCommand(Command cmd)

Overrides:

• addCommand in class Displayable

Parameters:

• cmd - 추가되는 명령

Throws:

• NullPointerException - cmd가 null인 경우

removeCommand

public void removeCommand(Command cmd)

Overrides:

• removeCommand in class Displayable

Parameters:

• cmd - 제거되는 명령

setCommandListener

public void setCommandListener(CommandListener l)

Overrides:

• setCommandListener in class Displayable

Parameters:

• l - 새 수신기 또는 null