Class JaxoDialogs


  • public final class JaxoDialogs
    extends java.lang.Object
    A convenience class for user input dialogs. The common 'parent' Component argument is the Component whose Window to use as owner for the dialog. It may be 'null' (history, it was), but this should be avoided in future.
    Since:
    2.0
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      static java.lang.String getDescription​(java.awt.Component parent, java.lang.String old)
      Opens a dialog to choose a new description for a graph.
      static java.lang.String getNewTabName​(java.awt.Component parent, java.lang.String oldName)
      Pops up a JOptionPane to allow the user to enter some text.
      static java.lang.String getText​(java.awt.Component parent)
      Opens a dialog to enter a text.
      static javax.swing.JDialog newDialog​(java.awt.Component aparent, java.lang.String title, boolean modal)
      A new JDialog with the first Dialog/Frame ancestor as owner and the given arguments.
      static javax.swing.JPanel newLineBoxLayoutPanel()
      A new JPanel with LINE_AXIS BoxLayout.
      static javax.swing.JPanel newPageBoxLayoutPanel()
      A new JPanel with PAGE_AXIS BoxLayout.
      static javax.swing.JPanel newTitledBorderLayoutPanel​(java.lang.String key)
      A new JPanel with BorderLayout and a titled (translated) border.
      static javax.swing.JPanel newTitledFlowLayoutPanel​(java.lang.String key)
      A new JPanel with FlowLayout and a titled (translated) border.
      static javax.swing.JPanel newTitledLayoutPanel​(java.lang.String key, java.awt.LayoutManager l)
      A new JPanel with the given layout and a titled (translated) border.
      static javax.swing.JPanel newTitledLineBoxLayoutPanel​(java.lang.String key)
      A new JPanel with LINE_AXIS BoxLayout and a titled (translated) border.
      static javax.swing.JPanel newTitledPageBoxLayoutPanel​(java.lang.String key)
      A new JPanel with PAGE_AXIS BoxLayout and a titled (translated) border.
      static void showErrorDialog​(java.awt.Component parent, java.lang.String message)
      Shows a simple MessageDialog to display an error message.
      static void showErrorDialog​(java.awt.Component parent, java.lang.String message, java.lang.String title)
      Shows a simple MessageDialog to display an error message.
      static void showI18NErrorDialog​(java.awt.Component parent, java.lang.String messageKey)
      Shows a simple MessageDialog to display an error message.
      static void showInfoDialog​(java.awt.Component parent, java.lang.String message, java.lang.String title)
      Shows a simple MessageDialog to display an info message.
      static void showMiniDialog​(java.awt.Component parent, java.lang.String title, java.lang.Object contents, java.awt.event.ActionListener l)
      Show 'contents' in a new modal dialog with title 'title' and owner determined by 'parent'; adding "OK" and "Cancel" buttons.
      static java.lang.String translatedWindowTitle​(java.lang.String text)
      Format a text that is already translated as a window title (usually, adding prefix).
      static java.lang.String windowTitle​(java.lang.String key)
      Like JaxoLanguage.translate(String), but format as a window title (usually, adding prefix).
      static java.lang.String windowTitle​(java.lang.String key, java.lang.Object[] arguments)
      Like JaxoLanguage.message(String,Object[]), but format as a window title (usually, adding prefix).
      static java.lang.String windowTitle​(JaxoDictionary d, java.lang.String key)
      Like JaxoDictionary.value(String), but format as a window title (usually, adding prefix).
      java.lang.String windowTitle​(JaxoDictionary d, java.lang.String key, java.lang.Object[] arguments)
      Like JaxoDictionary.message(String,Object[]), but format as a window title (usually, adding prefix).
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Method Detail

      • translatedWindowTitle

        public static java.lang.String translatedWindowTitle​(java.lang.String text)
        Format a text that is already translated as a window title (usually, adding prefix).
        Parameters:
        text - The title text.
        Returns:
        The formatted title.
      • windowTitle

        public static java.lang.String windowTitle​(java.lang.String key)
        Like JaxoLanguage.translate(String), but format as a window title (usually, adding prefix).
        Parameters:
        key - The key of the title text.
        Returns:
        The formatted title.
      • windowTitle

        public static java.lang.String windowTitle​(java.lang.String key,
                                                   java.lang.Object[] arguments)
        Like JaxoLanguage.message(String,Object[]), but format as a window title (usually, adding prefix).
        Parameters:
        key - The key of the title text.
        arguments - An array of arguments.
        Returns:
        The formatted title.
      • windowTitle

        public static java.lang.String windowTitle​(JaxoDictionary d,
                                                   java.lang.String key)
        Like JaxoDictionary.value(String), but format as a window title (usually, adding prefix).
        Parameters:
        d - The dictionary for the title text.
        key - The key of the title text.
        Returns:
        The formatted title.
      • windowTitle

        public java.lang.String windowTitle​(JaxoDictionary d,
                                            java.lang.String key,
                                            java.lang.Object[] arguments)
        Like JaxoDictionary.message(String,Object[]), but format as a window title (usually, adding prefix).
        Parameters:
        key - The key of the title text.
        d - The dictionary for the title text.
        arguments - An array of arguments.
        Returns:
        The formatted title.
      • newDialog

        public static javax.swing.JDialog newDialog​(java.awt.Component aparent,
                                                    java.lang.String title,
                                                    boolean modal)
        A new JDialog with the first Dialog/Frame ancestor as owner and the given arguments.
        Parameters:
        aparent - The parent component.
        title - The dialog title.
        modal - True to make the dialog modal.
        Returns:
        The dialog.
      • showMiniDialog

        public static void showMiniDialog​(java.awt.Component parent,
                                          java.lang.String title,
                                          java.lang.Object contents,
                                          java.awt.event.ActionListener l)
        Show 'contents' in a new modal dialog with title 'title' and owner determined by 'parent'; adding "OK" and "Cancel" buttons. If the user chooses "OK", the ActionListener argument is notified.
        Parameters:
        parent - The parent component.
        title - The title.
        contents - The dialog contents.
        l - The actionlistener to notify if the dialog is approved. If l is null, this method returns without bringing up the dialog.
      • showErrorDialog

        public static void showErrorDialog​(java.awt.Component parent,
                                           java.lang.String message,
                                           java.lang.String title)
        Shows a simple MessageDialog to display an error message.
        Parameters:
        parent - The parent component.
        message - The message to display.
        title - The window title.
      • showErrorDialog

        public static void showErrorDialog​(java.awt.Component parent,
                                           java.lang.String message)
        Shows a simple MessageDialog to display an error message.
        Parameters:
        parent - The parent component.
        message - The message to display.
      • showInfoDialog

        public static void showInfoDialog​(java.awt.Component parent,
                                          java.lang.String message,
                                          java.lang.String title)
        Shows a simple MessageDialog to display an info message.
        Parameters:
        parent - The parent component.
        message - The message to display.
        title - The window title.
      • showI18NErrorDialog

        public static void showI18NErrorDialog​(java.awt.Component parent,
                                               java.lang.String messageKey)
        Shows a simple MessageDialog to display an error message. The actual message is looked up in one of the resource bundles defined by JaxoDraw via the given messageKey.
        Parameters:
        parent - The parent component.
        messageKey - The ResourceBundle key to look up the message.
      • getNewTabName

        public static java.lang.String getNewTabName​(java.awt.Component parent,
                                                     java.lang.String oldName)
        Pops up a JOptionPane to allow the user to enter some text.
        Parameters:
        parent - The parent component.
        oldName - The old tab name.
        Returns:
        The entered text string.
      • getDescription

        public static java.lang.String getDescription​(java.awt.Component parent,
                                                      java.lang.String old)
        Opens a dialog to choose a new description for a graph.
        Parameters:
        parent - The parent component.
        old - The old description.
        Returns:
        The entered text string, or null if the dialog was canceled.
      • getText

        public static java.lang.String getText​(java.awt.Component parent)
        Opens a dialog to enter a text.
        Parameters:
        parent - The parent component.
        Returns:
        The entered text string.
      • newLineBoxLayoutPanel

        public static javax.swing.JPanel newLineBoxLayoutPanel()
        A new JPanel with LINE_AXIS BoxLayout.
        Returns:
        A new JPanel.
      • newPageBoxLayoutPanel

        public static javax.swing.JPanel newPageBoxLayoutPanel()
        A new JPanel with PAGE_AXIS BoxLayout.
        Returns:
        A new JPanel.
      • newTitledLineBoxLayoutPanel

        public static javax.swing.JPanel newTitledLineBoxLayoutPanel​(java.lang.String key)
        A new JPanel with LINE_AXIS BoxLayout and a titled (translated) border.
        Parameters:
        key - The key of the title.
        Returns:
        A new JPanel.
      • newTitledPageBoxLayoutPanel

        public static javax.swing.JPanel newTitledPageBoxLayoutPanel​(java.lang.String key)
        A new JPanel with PAGE_AXIS BoxLayout and a titled (translated) border.
        Parameters:
        key - The key of the title.
        Returns:
        A new JPanel.
      • newTitledFlowLayoutPanel

        public static javax.swing.JPanel newTitledFlowLayoutPanel​(java.lang.String key)
        A new JPanel with FlowLayout and a titled (translated) border.
        Parameters:
        key - The key of the title.
        Returns:
        A new JPanel.
      • newTitledBorderLayoutPanel

        public static javax.swing.JPanel newTitledBorderLayoutPanel​(java.lang.String key)
        A new JPanel with BorderLayout and a titled (translated) border.
        Parameters:
        key - The key of the title.
        Returns:
        A new JPanel.
      • newTitledLayoutPanel

        public static javax.swing.JPanel newTitledLayoutPanel​(java.lang.String key,
                                                              java.awt.LayoutManager l)
        A new JPanel with the given layout and a titled (translated) border.
        Parameters:
        key - The key of the title.
        l - The LayoutManager to use.
        Returns:
        A new JPanel.