Use is subject to License Terms. Your use of this web site or any of its content or software indicates your agreement to be bound by these License Terms.
Copyright © 2006 Sun Microsystems, Inc. All rights reserved.
javax.microedition.lcdui
Class AlertType
java.lang.Object
|
+--javax.microedition.lcdui.AlertType
- public class AlertType
- extends Object
The AlertType provides an indication of the nature of alerts.
Alerts are used by an application to present various kinds of
information to the user.
An AlertType may be used to directly signal the user without changing
the current Displayable.
The playSound
method can be used to spontaneously
generate a sound to alert the user. For example, a game using a
Canvas can use playSound
to indicate success or progress.
The predefined types are INFO
, WARNING
,
ERROR
, ALARM
, and CONFIRMATION
.
- See Also:
Alert
Field Summary |
static AlertType |
ALARM
An ALARM AlertType is a hint to alert the user to an event for which
the user has previously requested to be notified. |
static AlertType |
CONFIRMATION
A CONFIRMATION AlertType is a hint to confirm user actions. |
static AlertType |
ERROR
An ERROR AlertType is a hint to alert the user to an erroneous operation. |
static AlertType |
INFO
An INFO AlertType typically provides non-threatening information to the
user. |
static AlertType |
WARNING
A WARNING AlertType is a hint to warn the user of a potentially
dangerous operation. |
Constructor Summary |
protected |
AlertType()
Protected constructor for subclasses. |
Method Summary |
boolean |
playSound(Display display)
Alert the user by playing the sound for this AlertType. |
INFO
public static final AlertType INFO
- An INFO AlertType typically provides non-threatening information to the
user. For example, a simple splash screen might be an INFO AlertType.
WARNING
public static final AlertType WARNING
- A WARNING AlertType is a hint to warn the user of a potentially
dangerous operation.
For example, the warning message may contain the message, "Warning:
this operation will erase your data."
ERROR
public static final AlertType ERROR
- An ERROR AlertType is a hint to alert the user to an erroneous operation.
For example, an error alert might show the message,
"There is not enough room to install the application."
ALARM
public static final AlertType ALARM
- An ALARM AlertType is a hint to alert the user to an event for which
the user has previously requested to be notified.
For example, the message might say, "Staff meeting in five minutes."
CONFIRMATION
public static final AlertType CONFIRMATION
- A CONFIRMATION AlertType is a hint to confirm user actions.
For example, "Saved!" might be shown to indicate that a Save
operation has completed.
AlertType
protected AlertType()
- Protected constructor for subclasses.
playSound
public boolean playSound(Display display)
- Alert the user by playing the sound for this AlertType.
The AlertType instance is used as a hint by the device
to generate an appropriate sound. Instances other than
those predefined above may be ignored.
The actual sound made by the device,
if any, is determined by the device. The device may
ignore the request, use the same sound for
several AlertTypes or use any other means suitable to alert
the user.
- Parameters:
display
- to which the AlertType's sound should be played.- Returns:
true
if the user was alerted,
false
otherwise.- Throws:
- NullPointerException - if
display
is null
Copyright © 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to License Terms. Your use of this web site or any of its content or software indicates your agreement to be bound by these License Terms.
For more information, please consult the JSR 37 specification.