Overview  Package   Class  Use  Tree  Deprecated  Index  Help 
Extension SDK 10.1.2
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

oracle.ide.dialogs
Class MessageDialog

java.lang.Object
  extended byoracle.ide.dialogs.MessageDialog
public final class MessageDialog
extends java.lang.Object

A utility class for displaying alerts. Most of the methods on this class just call the equivalent methods on oracle.javatools.dialogs.MessageDialog, which should be used in preference to this class. oracle.ide.dialogs.MessageDialog mostly exists for backward API compatibility.

Field Summary
static int CONFIRM_CANCEL
          Return value from confirmOrCancel( Component, Object, String, String, boolean ) indicating that the user dismissed the alert using the Cancel button.
static int CONFIRM_NO
          Return value from confirmOrCancel( Component, Object, String, String, boolean ) indicating that the user dismissed the alert using the No button.
static int CONFIRM_YES
          Return value from confirmOrCancel( Component, Object, String, String, boolean ) indicating that the user dismissed the alert using the Yes button.
 
Constructor Summary
MessageDialog()
           
 
Method Summary
static void alert(java.awt.Component parent, java.lang.Object message)
          Deprecated. use error( Component, Object, String, String )
static void alert(java.awt.Component parent, java.lang.Object message, java.lang.String helptopic)
          Deprecated. use error( Component, Object, String, String )
static void alert(java.awt.Component parent, java.lang.Object message, java.lang.String title, java.lang.String helptopic)
          Deprecated. use error( Component, Object, String, String )
static void alert(java.lang.Object message)
          Deprecated. use error( Component, Object, String, String )
static boolean ask(java.awt.Component parent, java.lang.Object message)
          Deprecated. use confirm( Component, Object, String, String )
static boolean ask(java.awt.Component parent, java.lang.Object message, java.lang.String helptopic)
          Deprecated. use confirm( Component, Object, String, String )
static boolean ask(java.awt.Component parent, java.lang.Object message, java.lang.String title, java.lang.String helptopic)
          Deprecated. use confirm( Component, Object, String, String )
static boolean ask(java.awt.Component parent, java.lang.Object message, java.lang.String title, java.lang.String helptopic, boolean noIsDefault)
          Deprecated. use confirm( Component, Object, String, String, boolean )
static boolean ask(java.lang.Object message)
          Deprecated. use confirm( Component, Object, String, String )
static boolean confirm(java.awt.Component parent, java.lang.Object message, java.lang.String title, java.lang.String helptopic)
          Display a warning / confirmation alert.
static boolean confirm(java.awt.Component parent, java.lang.Object message, java.lang.String title, java.lang.String helptopic, boolean isDestructive)
          Display a warning / confirmation alert.
static boolean confirm(java.awt.Component parent, java.lang.Object message, java.lang.String title, java.lang.String helptopic, boolean isDestructive, java.lang.String yesText, java.lang.String noText)
          Display a warning / confirmation alert.
static int confirmOrCancel(java.awt.Component parent, java.lang.Object message, java.lang.String title)
          Display a confirmation alert with the option to cancel.
static int confirmOrCancel(java.awt.Component parent, java.lang.Object message, java.lang.String title, java.lang.String helptopic)
          Display a confirmation alert with the option to cancel.
static int confirmOrCancel(java.awt.Component parent, java.lang.Object message, java.lang.String title, java.lang.String helptopic, boolean isDestructive)
          Display a confirmation alert with the option to cancel.
static void critical(java.awt.Component parent, java.lang.Object message, java.lang.String title, java.lang.String helptopic)
          Display a critical alert.
static void error(java.awt.Component parent, java.lang.Object message, java.lang.String title, java.lang.String helpTopic)
          Display an error alert.
static void information(java.awt.Component parent, java.lang.Object message)
          Deprecated. use information( Component, Object, String, String );
static void information(java.awt.Component parent, java.lang.Object message, java.lang.String helptopic)
          Deprecated. use information( Component, Object, String, String );
static void information(java.awt.Component parent, java.lang.Object message, java.lang.String title, java.lang.String helptopic)
          Display an information alert.
static void information(java.lang.Object message)
          Deprecated. use information( Component, Object, String, String );
static void internalError(java.awt.Component parent, java.lang.Object message)
          Deprecated. use critical( Component, Object, String, String )
static void internalError(java.awt.Component parent, java.lang.Object message, java.lang.String helptopic)
          Deprecated. use critical( Component, Object, String, String )
static void internalError(java.awt.Component parent, java.lang.Object message, java.lang.String title, java.lang.String helptopic)
          Deprecated. use critical( Component, Object, String, String )
static void internalError(java.lang.Object message)
          Deprecated. use critical( Component, Object, String, String )
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

CONFIRM_CANCEL

public static final int CONFIRM_CANCEL
Return value from confirmOrCancel( Component, Object, String, String, boolean ) indicating that the user dismissed the alert using the Cancel button.

See Also:
Constant Field Values

CONFIRM_NO

public static final int CONFIRM_NO
Return value from confirmOrCancel( Component, Object, String, String, boolean ) indicating that the user dismissed the alert using the No button.

See Also:
Constant Field Values

CONFIRM_YES

public static final int CONFIRM_YES
Return value from confirmOrCancel( Component, Object, String, String, boolean ) indicating that the user dismissed the alert using the Yes button.

See Also:
Constant Field Values
Constructor Detail

MessageDialog

public MessageDialog()
Method Detail

alert

public static void alert(java.lang.Object message)
Deprecated. use error( Component, Object, String, String )

Display an alert with no help topic parented on the Ide main window

Parameters:
message - the message to display

alert

public static void alert(java.awt.Component parent,
                         java.lang.Object message)
Deprecated. use error( Component, Object, String, String )

Display an alert with the specified parent component and no help topic

Parameters:
parent - the parent component.
message - the message to display

alert

public static void alert(java.awt.Component parent,
                         java.lang.Object message,
                         java.lang.String helptopic)
Deprecated. use error( Component, Object, String, String )

Display an alert with the specified parent, message and help topic.

Parameters:
parent - the parent component
message - the message to display
helptopic - the help topic for the help button

alert

public static void alert(java.awt.Component parent,
                         java.lang.Object message,
                         java.lang.String title,
                         java.lang.String helptopic)
Deprecated. use error( Component, Object, String, String )

Display an alert with the specified parent, message and help topic.

Parameters:
parent - the parent component
message - the message to display
title - the title of the dialog, or null to use the default.
helptopic - the help topic for the help button

error

public static void error(java.awt.Component parent,
                         java.lang.Object message,
                         java.lang.String title,
                         java.lang.String helpTopic)
Display an error alert. An error alert is used to notify the user about an unanticipated condition which prevented the user's task from completing successfully. The interruption does not result in significant data loss, however the user must resolve the condition before the task can be carried out as planned. Examples of events that can raise error alerts are validation failure, disk full, or network interruption. In general, these are errors that occur within the application and are easily corrected.

Parameters:
parent - a parent component
message - the message text should contain three parts: what the error is, why the error occurred and how the error can be fixed (if known). Each part should be one to three short sentences.
title - a title for the alert. The title bar text of an error alert should be a one to three word summary of the error. Null or "" are NOT valid values.
helpTopic - the help topic ID. If you pass null, the help button will not be displayed.

ask

public static boolean ask(java.lang.Object message)
Deprecated. use confirm( Component, Object, String, String )

Ask the user a Yes / No question

Parameters:
message - the message to display
Returns:
true if the user clicked Yes, false otherwise

ask

public static boolean ask(java.awt.Component parent,
                          java.lang.Object message)
Deprecated. use confirm( Component, Object, String, String )

Ask the user a Yes / No question with a specified parent component

Parameters:
parent - the parent component
message - the message to display
Returns:
true if the user clicked Yes, false otherwise

ask

public static boolean ask(java.awt.Component parent,
                          java.lang.Object message,
                          java.lang.String helptopic)
Deprecated. use confirm( Component, Object, String, String )

Ask the user a Yes / No question with a specified parent component, help topic and message

Parameters:
parent - the parent component
message - the message to display
helptopic - the helptopic for the help button
Returns:
true if the user clicked Yes, false otherwise

ask

public static boolean ask(java.awt.Component parent,
                          java.lang.Object message,
                          java.lang.String title,
                          java.lang.String helptopic)
Deprecated. use confirm( Component, Object, String, String )

Ask the user a Yes / No question with a specified parent component, help topic and message

Parameters:
parent - the parent component
message - the message to display
title - the title of the dialog, or null to use the default.
helptopic - the helptopic for the help button
Returns:
true if the user clicked Yes, false otherwise

ask

public static boolean ask(java.awt.Component parent,
                          java.lang.Object message,
                          java.lang.String title,
                          java.lang.String helptopic,
                          boolean noIsDefault)
Deprecated. use confirm( Component, Object, String, String, boolean )

Ask the user a Yes / No question with a specified parent component, help topic and message

Parameters:
parent - the parent component
message - the message to display
title - the title of the dialog, or null to use the default.
helptopic - the helptopic for the help button
noIsDefault - whether to make cancel the default option
Returns:
true if the user clicked Yes, false otherwise

confirm

public static boolean confirm(java.awt.Component parent,
                              java.lang.Object message,
                              java.lang.String title,
                              java.lang.String helptopic)
Display a warning / confirmation alert. A confirmation alert is used to warn the user about the consequences of an action, giving the user a chance to accept the consequences, avoid them, or resolve them in some other fashion. When a task initiated by the user raises a confirmation alert, the task does not actually begin until the user responds to the alert. A confirmation alert must be used for destructive operations (like delete) which will result in significant data loss and cannot easily be undone. Examples of events that can raise confirmation alerts are dropping a database table, cancelling an installation, or deleting or overwriting a file.

Parameters:
parent - the parent component
message - the message text of the alert should explain the known consequences of the action, and conclude with a question that presents a choice to the user.
title - the title bar text should be in the form "Confirm [Action]", for example "Confirm Drop". Null or "" are NOT valid values.
helptopic - the help topic. If null, the button is not displayed.
Returns:
true if the user clicked Yes, false otherwise.

confirm

public static boolean confirm(java.awt.Component parent,
                              java.lang.Object message,
                              java.lang.String title,
                              java.lang.String helptopic,
                              boolean isDestructive)
Display a warning / confirmation alert. A confirmation alert is used to warn the user about the consequences of an action, giving the user a chance to accept the consequences, avoid them, or resolve them in some other fashion. When a task initiated by the user raises a confirmation alert, the task does not actually begin until the user responds to the alert. A confirmation alert must be used for destructive operations (like delete) which will result in significant data loss and cannot easily be undone. Examples of events that can raise confirmation alerts are dropping a database table, cancelling an installation, or deleting or overwriting a file.

Parameters:
parent - the parent component
message - the message text of the alert should explain the known consequences of the action, and conclude with a question that presents a choice to the user.
title - the title bar text should be in the form "Confirm [Action]", for example "Confirm Drop". Null or "" are NOT valid values.
helptopic - the help topic. If null, the button is not displayed.
isDestructive - if the operation the confirmation is for is destructive (e.g. file deletion), the No button will be the default
Returns:
true if the user clicked Yes, false otherwise.

confirm

public static boolean confirm(java.awt.Component parent,
                              java.lang.Object message,
                              java.lang.String title,
                              java.lang.String helptopic,
                              boolean isDestructive,
                              java.lang.String yesText,
                              java.lang.String noText)
Display a warning / confirmation alert. A confirmation alert is used to warn the user about the consequences of an action, giving the user a chance to accept the consequences, avoid them, or resolve them in some other fashion. When a task initiated by the user raises a confirmation alert, the task does not actually begin until the user responds to the alert. A confirmation alert must be used for destructive operations (like delete) which will result in significant data loss and cannot easily be undone. Examples of events that can raise confirmation alerts are dropping a database table, cancelling an installation, or deleting or overwriting a file.

Parameters:
parent - the parent component
message - the message text of the alert should explain the known consequences of the action, and conclude with a question that presents a choice to the user.
title - the title bar text should be in the form "Confirm [Action]", for example "Confirm Drop". Null or "" are NOT valid values.
helptopic - the help topic. If null, the button is not displayed.
isDestructive - if the operation the confirmation is for is destructive (e.g. file deletion), the No button will be the default
yesText - the label for the Yes button in the dialog. You can use the ampersand (&) to indicate the mnemonic.
Returns:
true if the user clicked Yes, false otherwise.

confirmOrCancel

public static int confirmOrCancel(java.awt.Component parent,
                                  java.lang.Object message,
                                  java.lang.String title)
Display a confirmation alert with the option to cancel. A confirmation alert is used to warn the user about the consequences of an action, giving the user a chance to accept the consequences, avoid them, or resolve them in some other fashion. When a task initiated by the user raises a confirmation alert, the task does not actually begin until the user responds to the alert. A confirmation alert must be used for destructive operations (like delete) which will result in significant data loss and cannot easily be undone. Examples of events that can raise confirmation alerts are dropping a database table, cancelling an installation, or deleting or overwriting a file.

Parameters:
parent - the parent component
message - the message text of the alert should explain the known consequences of the action, and conclude with a question that presents a choice to the user.
title - the title bar text should be in the form "Confirm [Action]", for example "Confirm Drop". Null or "" are NOT valid values.
Returns:
CONFIRM_YES, CONFIRM_NO or CONFIRM_CANCEL.

confirmOrCancel

public static int confirmOrCancel(java.awt.Component parent,
                                  java.lang.Object message,
                                  java.lang.String title,
                                  java.lang.String helptopic)
Display a confirmation alert with the option to cancel. A confirmation alert is used to warn the user about the consequences of an action, giving the user a chance to accept the consequences, avoid them, or resolve them in some other fashion. When a task initiated by the user raises a confirmation alert, the task does not actually begin until the user responds to the alert. A confirmation alert must be used for destructive operations (like delete) which will result in significant data loss and cannot easily be undone. Examples of events that can raise confirmation alerts are dropping a database table, cancelling an installation, or deleting or overwriting a file.

Parameters:
parent - the parent component
message - the message text of the alert should explain the known consequences of the action, and conclude with a question that presents a choice to the user.
title - the title bar text should be in the form "Confirm [Action]", for example "Confirm Drop". Null or "" are NOT valid values.
helptopic - the help topic. If null, the button is not displayed.
Returns:
CONFIRM_YES, CONFIRM_NO or CONFIRM_CANCEL.

confirmOrCancel

public static int confirmOrCancel(java.awt.Component parent,
                                  java.lang.Object message,
                                  java.lang.String title,
                                  java.lang.String helptopic,
                                  boolean isDestructive)
Display a confirmation alert with the option to cancel. A confirmation alert is used to warn the user about the consequences of an action, giving the user a chance to accept the consequences, avoid them, or resolve them in some other fashion. When a task initiated by the user raises a confirmation alert, the task does not actually begin until the user responds to the alert. A confirmation alert must be used for destructive operations (like delete) which will result in significant data loss and cannot easily be undone. Examples of events that can raise confirmation alerts are dropping a database table, cancelling an installation, or deleting or overwriting a file.

Parameters:
parent - the parent component
message - the message text of the alert should explain the known consequences of the action, and conclude with a question that presents a choice to the user.
title - the title bar text should be in the form "Confirm [Action]", for example "Confirm Drop". Null or "" are NOT valid values.
helptopic - the help topic. If null, the button is not displayed.
isDestructive - if the operation the confirmation is for is destructive (e.g. file deletion), the No button will be the default
Returns:
CONFIRM_YES, CONFIRM_NO or CONFIRM_CANCEL.

information

public static void information(java.lang.Object message)
Deprecated. use information( Component, Object, String, String );

Display an information dialog. Information dialogs are used to indicate something to the user which is not an error. The only button displayed is OK.

Parameters:
message - the message to display

information

public static void information(java.awt.Component parent,
                               java.lang.Object message)
Deprecated. use information( Component, Object, String, String );

Display an information dialog. Information dialogs are used to indicate something to the user which is not an error. The only button displayed is OK.

Parameters:
parent - the parent of the dialog
message - the message to display

information

public static void information(java.awt.Component parent,
                               java.lang.Object message,
                               java.lang.String helptopic)
Deprecated. use information( Component, Object, String, String );

Display an information dialog. Information dialogs are used to indicate something to the user which is not an error. The only button displayed is OK.

Parameters:
parent - the parent of the dialog
message - the message to display
helptopic - the help topic

information

public static void information(java.awt.Component parent,
                               java.lang.Object message,
                               java.lang.String title,
                               java.lang.String helptopic)
Display an information alert. An information alert is used to provide the user with harmless status information. The event communicated by an information alert is not an interruption of a task initiated by the user. The event also has not resulted in data loss and does not require any resolution; it merely informs the user that something has happened. Examples of events that can raise information alerts are completing a compilation, virus definitions becoming out-of-date or the arrival of new mail.

Parameters:
parent - the parent of the dialog
message - the message to display. This should contain an extended narrative of the event.
title - the title of the dialog. This should be a one to three word summary of the event. Null or "" are NOT valid values.
helptopic - the help topic. If null, no Help button will be displayed.

internalError

public static void internalError(java.lang.Object message)
Deprecated. use critical( Component, Object, String, String )

Display a message about an internal error. You should only use this dialog when a serious unexpected error occurs ( such as a runtime exception ). Better still, use the ExceptionDialog in this package to report such errors if there is an associated stack trace.

Parameters:
message - the message to display

internalError

public static void internalError(java.awt.Component parent,
                                 java.lang.Object message)
Deprecated. use critical( Component, Object, String, String )

Display a message about an internal error. You should only use this dialog when a serious unexpected error occurs ( such as a runtime exception ). Better still, use the ExceptionDialog in this package to report such errors if there is an associated stack trace.

Parameters:
parent - the parent component for the dialog
message - the message to display

internalError

public static void internalError(java.awt.Component parent,
                                 java.lang.Object message,
                                 java.lang.String helptopic)
Deprecated. use critical( Component, Object, String, String )

Display a message about an internal error. You should only use this dialog when a serious unexpected error occurs ( such as a runtime exception ). Better still, use the ExceptionDialog in this package to report such errors if there is an associated stack trace.

Parameters:
parent - the parent component for the dialog
message - the message to display
helptopic - the help topic

internalError

public static void internalError(java.awt.Component parent,
                                 java.lang.Object message,
                                 java.lang.String title,
                                 java.lang.String helptopic)
Deprecated. use critical( Component, Object, String, String )

Display a message about an internal error. You should only use this dialog when a serious unexpected error occurs ( such as a runtime exception ). Better still, use the ExceptionDialog in this package to report such errors if there is an associated stack trace.

Parameters:
parent - the parent component for the dialog
message - the message to display
title - the title of the dialog, or null to use the default.
helptopic - the help topic

critical

public static void critical(java.awt.Component parent,
                            java.lang.Object message,
                            java.lang.String title,
                            java.lang.String helptopic)
Display a critical alert. A critical alert is used to notify the user about a severe unanticipated condition which will not allow task completion. The interruption may have reseulted in significant data loss, however the is little the user can do to resolve the condition. Examples of events that can raise critical alerts are vendor OS errors, database integrity errors, or web cache corruption. In general, these are potentially harmful events that occur outside of the application and are largely beyond the user's control.

Parameters:
parent - the parent component for the dialog
message - The message text should explain what the problem is including an error number if available, and any known reasons for why the error might have occurred. It is also useful to suggest some possible solution to help the user understand what might need to be done to fix the condition (if known)
title - The title bar text should be a one to three word summary of the problem condition. Null or "" are NOT valid values.
helptopic - an optional help topic, if null no Help button is shown.
Overview  Package   Class  Use  Tree  Deprecated  Index  Help 
Extension SDK
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

 

Copyright © 1997, 2004, Oracle. All rights reserved.