Class Dialogs

java.lang.Object
org.svetovid.dialogs.Dialogs

public final class Dialogs extends Object
This is helper class which contains static methods for showing various types of dialog boxes containing messages, information, questions, etc.
Version:
1.5
Author:
Ivan Pribela
  • Constructor Details

    • Dialogs

      public Dialogs()
  • Method Details

    • setLocale

      public static void setLocale(Locale newValue)
      Sets locale which will be used to display messages.
      Parameters:
      newValue - locale which will be used to display messages.
    • setClipboard

      public static void setClipboard(Clipboard newValue)
      Sets clipboard which will be used by displayed messages.
      Parameters:
      newValue - clipboard which will be used by displayed messages.
    • setNewStackTraceStyle

      public void setNewStackTraceStyle(boolean newValue)
      Sets the stack trace style which will be used by displayed messages.
      Parameters:
      newValue - stack trace style which will be used by displayed messages.
    • setTimeout

      public static void setTimeout(int newValue)
      Sets default time before automatically closing dialogs.
      Parameters:
      newValue - the auto close timeout; zero means don't auto close dialogs.
    • showMessage

      public static void showMessage(Component component, String text)
      Displays message box containing desired message.
      Parameters:
      component - determines the frame in which the dialog is displayed; if the parentComponent has no Frame, a default Frame is used.
      text - text which will be displayed in the message box.
    • showInformation

      public static void showInformation(Component component, String text)
      Displays informational message box containing desired message.
      Parameters:
      component - determines the frame in which the dialog is displayed; if the parentComponent has no Frame, a default Frame is used.
      text - text which will be displayed in the message box.
    • showWarning

      public static void showWarning(Component component, String text)
      Displays warning message box containing desired message.
      Parameters:
      component - determines the frame in which the dialog is displayed; if the parentComponent has no Frame, a default Frame is used.
      text - text which will be displayed in the message box.
    • showError

      public static void showError(Component component, String text)
      Displays error message box containing desired message.
      Parameters:
      component - determines the frame in which the dialog is displayed; if the parentComponent has no Frame, a default Frame is used.
      text - text which will be displayed in the message box.
    • showError

      public static void showError(Component component, String text, Throwable th)
      Displays error message box containing desired message and optionally stack-trace of the supplied exception.
      Parameters:
      component - determines the frame in which the dialog is displayed; if the parentComponent has no Frame, a default Frame is used.
      text - text which will be displayed in the message box.
      th - exception which is used to build up the stack-trace information.
    • showException

      public static void showException(Component component, Throwable th)
      Displays error message box containing stack-trace of the supplied exception.
      Parameters:
      component - determines the frame in which the dialog is displayed; if the parentComponent has no Frame, a default Frame is used.
      th - exception which is used to build up the stack-trace information.
    • askConfirmation

      public static boolean askConfirmation(Component component, String text)
      Displays confirmation message box containing desired message, and asking from the user to answer {code Yes} or No.
      Parameters:
      component - determines the frame in which the dialog is displayed; if the parentComponent has no Frame, a default Frame is used.
      text - text which will be displayed in the message box.
      Returns:
      true if user answered yes; false otherwise.
    • askConfirmationWithCancel

      public static Boolean askConfirmationWithCancel(Component component, String text)
      Displays confirmation message box containing desired message, and asking from the user to answer Yes, No or Cancel.
      Parameters:
      component - determines the frame in which the dialog is displayed; if the parentComponent has no Frame, a default Frame is used.
      text - text which will be displayed in the message box.
      Returns:
      True if user answered yes; False if user answered no; and null otherwise.
    • askQuestion

      public static String askQuestion(Component component, String text)
      Displays question message box containing desired question, and asking the user to enter the answer.
      Parameters:
      component - determines the frame in which the dialog is displayed; if the parentComponent has no Frame, a default Frame is used.
      text - text which will be displayed in the message box.
      Returns:
      String object containing text that user entered; null if user has chosen not to answer.
    • askQuestion

      public static String askQuestion(Component component, String text, String answer)
      Displays question message box containing desired question, and asking the user to enter the answer.
      Parameters:
      component - determines the frame in which the dialog is displayed; if the parentComponent has no Frame, a default Frame is used.
      text - text which will be displayed in the message box.
      answer - the initial answer for user to modify.
      Returns:
      String object containing text that user entered; null if user has chosen not to answer.
    • askQuestion

      public static Object askQuestion(Component component, String text, Object[] options, Object defaultOption)
      Displays question message box containing desired question, and asking the user to choose one of the provided options.
      Parameters:
      component - determines the frame in which the dialog is displayed; if the parentComponent has no Frame, a default Frame is used.
      text - text which will be displayed in the message box.
      options - list of available options for the user to choose from.
      defaultOption - initial option that is to be selected.
      Returns:
      one of the options provided or null if user has chosen not to answer.
    • askPassword

      public static char[] askPassword(Component component, String text)
      Displays password dialog box containing desired message, and asking from the user to enter password.
      Parameters:
      component - determines the frame in which the dialog is displayed; if the parentComponent has no Frame, a default Frame is used.
      text - text which will be displayed in the dialog box.
      Returns:
      password entered by the user as an array of char; null if user has chosen not to enter the password.
    • askLogin

      public static LoginData askLogin(Component component, String text)
      Displays login dialog box containing desired message, and asking for user name and password.
      Parameters:
      component - determines the frame in which the dialog is displayed; if the parentComponent has no Frame, a default Frame is used.
      text - text which will be displayed in the dialog box.
      Returns:
      user data (user name and password) stored in LoginData object; null if user has chosen not to enter login data.
    • askLogin

      public static LoginData askLogin(Component component, String text, String username)
      Displays login dialog box containing desired message, and asking for user name and password.
      Parameters:
      component - determines the frame in which the dialog is displayed; if the parentComponent has no Frame, a default Frame is used.
      text - text which will be displayed in the dialog box.
      username - default user name.
      Returns:
      user data (user name and password) stored in LoginData object; null if user has chosen not to enter login information.
    • showDialog

      public static boolean showDialog(Component component, Component content, String title, Icon icon)
      Displays a dialog with the given icon and title containing the supplied component.
      Parameters:
      component - determines the frame in which the dialog is displayed; if the parentComponent has no Frame, a default Frame is used.
      content - the component to display on the dialog
      title - title of the dialog
      icon - icon to display on the dialog
      Returns:
      true if user answered ok; false otherwise.
    • showDialog

      public static <T> T showDialog(Component component, DialogContent<T> content, String title, Icon icon)
      Displays a dialog with the given icon and title containing the supplied content.
      Type Parameters:
      T - type of dialog content
      Parameters:
      component - determines the frame in which the dialog is displayed; if the parentComponent has no Frame, a default Frame is used.
      content - the component to display on the dialog
      title - title of the dialog
      icon - icon to display on the dialog
      Returns:
      The object retrieved from the content component if user answered ok; null otherwise.
    • getFactory

      public static AutoCloseDialogFactory getFactory(Locale locale)
    • getFactory

      public static AutoCloseDialogFactory getFactory(Locale locale, Clipboard clipboard)
    • getFactory

      public static AutoCloseDialogFactory getFactory(Locale locale, Clipboard clipboard, int timeout)