public class ConditionalOptionPaneUtil
extends java.lang.Object
JOptionPane
. Within JOSM you should use these
methods rather than the bare methods from JOptionPane
because the methods provided
by ConditionalOptionPaneUtil ensure that a dialog window is always on top and isn't hidden by one of the
JOSM windows for detached dialogs, relation editors, history browser and the like.Modifier and Type | Field and Description |
---|---|
static int |
DIALOG_DISABLED_OPTION |
Modifier and Type | Method and Description |
---|---|
static java.lang.Integer |
getDialogReturnValue(java.lang.String prefKey)
Returns the preference value for the preference key "message." +
prefKey + ".value". |
static boolean |
getDialogShowingEnabled(java.lang.String prefKey)
Replies the preference value for the preference key "message." +
prefKey . |
static void |
setDialogReturnValue(java.lang.String prefKey,
java.lang.Integer value)
sets the value for the preference key "message." +
prefKey + ".value". |
static void |
setDialogShowingEnabled(java.lang.String prefKey,
boolean enabled)
sets the value for the preference key "message." +
prefKey . |
static boolean |
showConfirmationDialog(java.lang.String preferenceKey,
java.awt.Component parent,
java.lang.Object message,
java.lang.String title,
int optionType,
int messageType,
int trueOption)
Displays a confirmation dialog with some option buttons given by
optionType . |
static void |
showMessageDialog(java.lang.String preferenceKey,
java.awt.Component parent,
java.lang.Object message,
java.lang.String title,
int messageType)
Displays an message in modal dialog with an OK button.
|
static int |
showOptionDialog(java.lang.String preferenceKey,
java.awt.Component parent,
java.lang.Object message,
java.lang.String title,
int optionType,
int messageType,
java.lang.Object[] options,
java.lang.Object defaultOption)
Displays an confirmation dialog with some option buttons given by
optionType . |
public static final int DIALOG_DISABLED_OPTION
public static boolean getDialogShowingEnabled(java.lang.String prefKey)
prefKey
.
The default value if the preference key is missing is true.the
- preference keyprefKey
public static void setDialogShowingEnabled(java.lang.String prefKey, boolean enabled)
prefKey
.prefKey
- the keyenabled
- the valuepublic static java.lang.Integer getDialogReturnValue(java.lang.String prefKey)
prefKey
+ ".value".
The default value if the preference key is missing is -1.the
- preference keyprefKey
+ ".value"public static void setDialogReturnValue(java.lang.String prefKey, java.lang.Integer value)
prefKey
+ ".value".prefKey
- the keyvalue
- the valuepublic static int showOptionDialog(java.lang.String preferenceKey, java.awt.Component parent, java.lang.Object message, java.lang.String title, int optionType, int messageType, java.lang.Object[] options, java.lang.Object defaultOption) throws java.awt.HeadlessException
optionType
.
It is always on top even if there are other open windows like detached dialogs,
relation editors, history browsers and the like.
Set optionType
to JOptionPane.YES_NO_OPTION
for a dialog with a YES and
a NO button.
Set optionType
to JOptionPane.YES_NO_CANCEL_OPTION
for a dialog with a YES,
a NO and a CANCEL button
Returns one of the constants JOptionPane.YES_OPTION, JOptionPane.NO_OPTION,
JOptionPane.CANCEL_OPTION or JOptionPane.CLOSED_OPTION depending on the action chosen by
the user.preferenceKey
- the preference keyparent
- the parent componentmessage
- the messagetitle
- the titleoptionType
- the option typemessageType
- the message typeoptions
- a list of optionsdefaultOption
- the default optionJOptionPane.CLOSED_OPTION
if the dialog was closed.java.awt.HeadlessException
public static boolean showConfirmationDialog(java.lang.String preferenceKey, java.awt.Component parent, java.lang.Object message, java.lang.String title, int optionType, int messageType, int trueOption) throws java.awt.HeadlessException
optionType
.
It is always on top even if there are other open windows like detached dialogs,
relation editors, history browsers and the like.
Set optionType
to JOptionPane.YES_NO_OPTION
for a dialog with a YES and
a NO button.
Set optionType
to JOptionPane.YES_NO_CANCEL_OPTION
for a dialog with a YES,
a NO and a CANCEL button
Replies true, if the selected option is equal to trueOption
, otherwise false.
Replies true, if the dialog is not displayed because the respective preference option
preferenceKey
is set to false and the user has previously chosen
trueOption
.preferenceKey
- the preference keyparent
- the parent componentmessage
- the messagetitle
- the titleoptionType
- the option typemessageType
- the message typetrueOption
- if this option is selected the method replies truetrueOption
, otherwise false.java.awt.HeadlessException
JOptionPane.INFORMATION_MESSAGE
,
JOptionPane.WARNING_MESSAGE
,
JOptionPane.ERROR_MESSAGE
public static void showMessageDialog(java.lang.String preferenceKey, java.awt.Component parent, java.lang.Object message, java.lang.String title, int messageType)
preferenceKey
and value false
the dialog is not show.preferenceKey
- the preference keyparent
- the parent componentmessage
- the messagetitle
- the titlemessageType
- the message typeJOptionPane.INFORMATION_MESSAGE
,
JOptionPane.WARNING_MESSAGE
,
JOptionPane.ERROR_MESSAGE