BasicDialogI (MyTISM API Documentation)

All Superinterfaces:

java.io.Serializable

All Known Subinterfaces:

de.ipcon.db.core.BasicClientContextI, ClientContextI, FormattedChoiceDialogI

All Known Implementing Classes:

BasicClient
```
public interface BasicDialogI
extends java.io.Serializable
```
Interface defining the base contract for showing various blocking dialogs, including errors, confirmations, and standard input dialogs within the application.

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`CANCELED` Return value for a canceled action.
`static int`	`CONFIRMED` Return value for a confirmed/yes action.
`static int`	`DENIED` Return value for a denied/no action.
`static java.lang.String`	`TYPE_ERROR` Error message type.
`static java.lang.String`	`TYPE_INFO` Informational message type.
`static java.lang.String`	`TYPE_PLAIN` Plain message type, typically for logs or simple text display.
`static java.lang.String`	`TYPE_QUESTION` Question/confirmation message type.
`static java.lang.String`	`TYPE_WARNING` Warning message type.

Method Summary

All Methods Instance Methods Abstract Methods Default Methods Deprecated Methods
Modifier and Type	Method and Description
`default java.math.BigDecimal`	`showBigDecimalInputDialog(java.lang.String s)`
`default java.math.BigDecimal`	`showBigDecimalInputDialog(java.lang.String s, java.lang.String title)`
`default java.math.BigDecimal`	`showBigDecimalInputDialog(java.lang.String s, java.lang.String title, java.math.BigDecimal oldValue)`
`java.math.BigDecimal`	`showBigDecimalInputDialog(java.lang.String s, java.lang.String title, java.math.BigDecimal oldValue, boolean nullAllowed)` Shows a modal dialog for `BigDecimal` input.
`default int`	`showConfirmDialog(java.lang.String message)`
`default int`	`showConfirmDialog(java.lang.String message, java.lang.String title)`
`default int`	`showConfirmDialog(java.lang.String message, java.lang.String title, boolean forceAffirmation)`
`default int`	`showConfirmDialog(java.lang.String message, java.lang.String title, boolean forceAffirmation, java.lang.String affirmationText)`
`int`	`showConfirmDialog(java.lang.String message, java.lang.String title, boolean forceAffirmation, java.lang.String affirmationText, java.lang.String affirmationString)` Displays a confirmation dialog offering YES, NO, and CANCEL options, with optional affirmation text required for confirmation.
`default java.util.Date`	`showDateInputDialog(java.lang.String s)`
`default java.util.Date`	`showDateInputDialog(java.lang.String s, java.lang.String title)`
`default java.util.Date`	`showDateInputDialog(java.lang.String s, java.lang.String title, java.util.Date oldValue)`
`default java.util.Date`	`showDateInputDialog(java.lang.String s, java.lang.String title, java.util.Date oldValue, boolean nullAllowed)`
`java.util.Date`	`showDateInputDialog(java.lang.String s, java.lang.String title, java.util.Date oldValue, boolean nullAllowed, java.lang.String format)` Shows a modal dialog for `Date` input.
`default java.lang.Object`	`showError(java.lang.String message)`
`default java.lang.Object`	`showError(java.lang.String message, java.lang.Throwable exception)`
`default java.lang.Object`	`showError(java.lang.String message, java.lang.Throwable exception, boolean suppressPrintCausedBy)`
`default java.lang.Object`	`showError(java.lang.String message, java.lang.Throwable exception, boolean suppressPrintCausedBy, java.lang.String title)`
`java.lang.Object`	`showError(java.lang.String message, java.lang.Throwable exception, boolean suppressPrintCausedBy, java.lang.String title, java.lang.Object[] customButtons)` Shows an error message, controlling whether the "Caused by" trace is printed in the details.
`default java.lang.Object`	`showError(java.lang.String message, java.lang.Throwable exception, java.lang.String title)`
`default java.lang.Object`	`showError(java.lang.String message, java.lang.Throwable exception, java.lang.String title, boolean deprecatedForceSynchronous)`
`java.lang.Object`	`showError(java.lang.String message, java.lang.Throwable exception, java.lang.String title, boolean deprecatedForceSynchronous, java.lang.Object[] customButtons)` Shows an error message in a modal dialog with an optional exception stack trace.
`default java.lang.Object`	`showException(java.lang.Throwable ex)`
`default java.lang.Object`	`showException(java.lang.Throwable ex, boolean deprecatedForceSynchronous)`
`java.lang.Object`	`showException(java.lang.Throwable ex, boolean deprecatedForceSynchronous, java.lang.Object[] customButtons)` Shows an exception stack trace in a dialog without a custom error message.
`default java.io.File`	`showFileChooser(java.lang.String title, java.lang.String approveText)` Deprecated. Use explicit native intent methods instead.
`default java.io.File`	`showFileChooser(java.lang.String title, java.lang.String approveText, java.lang.String globalVarName)` Deprecated. Use explicit native intent methods instead.
`default java.io.File`	`showFileChooser(java.lang.String title, java.lang.String approveText, java.lang.String globalVarName, int selectionMode)` Deprecated. Use explicit native intent methods instead.
`default java.io.File`	`showFileChooser(java.lang.String title, java.lang.String approveText, java.lang.String globalVarName, int selectionMode, boolean quiet)` Deprecated. Use explicit native intent methods instead.
`default java.io.File`	`showFileChooser(java.lang.String title, java.lang.String approveText, java.lang.String globalVarName, int selectionMode, boolean quiet, javax.swing.filechooser.FileFilter filter)` Deprecated. Use explicit native intent methods instead.
`default java.io.File`	`showFileChooser(java.lang.String title, java.lang.String approveText, java.lang.String globalVarName, int selectionMode, boolean quiet, javax.swing.filechooser.FileFilter filter, javax.swing.JComponent accessoryComponent)` Deprecated. Use explicit native intent methods instead.
`default java.io.File`	`showFileChooser(java.lang.String title, java.lang.String approveText, java.lang.String globalVarName, int selectionMode, boolean quiet, javax.swing.filechooser.FileFilter filter, javax.swing.JComponent accessoryComponent, java.io.File preselectedFile)` Deprecated. Use explicit native intent methods instead.
`default java.io.File`	`showFileChooser(java.lang.String title, java.lang.String approveText, java.lang.String globalVarName, int selectionMode, boolean quiet, javax.swing.filechooser.FileFilter filter, javax.swing.JComponent accessoryComponent, java.io.File preselectedFile, java.io.File fallbackStartdir)` Deprecated. Use `showOpenFileChooser(java.lang.String, java.lang.String, boolean, javax.swing.filechooser.FileFilter)`, `showSaveFileChooser(java.lang.String, java.lang.String, javax.swing.filechooser.FileFilter, boolean, java.io.File)`, or `showFolderChooser(java.lang.String, java.lang.String, boolean, java.io.File)` to guarantee native OS dialog compliance (preventing invalid FlatLaf fallback combinations).
`java.io.File`	`showFileChooser(java.lang.String title, java.lang.String approveText, java.lang.String globalVarName, int selectionMode, boolean quiet, javax.swing.filechooser.FileFilter filter, javax.swing.JComponent accessoryComponent, java.io.File preselectedFile, java.io.File fallbackStartdir, int dialogType)` Internal and Legacy routing method for single file / directory selections.
`default java.io.File[]`	`showFilesChooser(java.lang.String title, java.lang.String approveText)` Deprecated. Use `showOpenFilesChooser(java.lang.String, java.lang.String, javax.swing.filechooser.FileFilter, java.io.File)`.
`default java.io.File[]`	`showFilesChooser(java.lang.String title, java.lang.String approveText, java.lang.String globalVarName)` Deprecated. Use `showOpenFilesChooser(java.lang.String, java.lang.String, javax.swing.filechooser.FileFilter, java.io.File)`.
`default java.io.File[]`	`showFilesChooser(java.lang.String title, java.lang.String approveText, java.lang.String globalVarName, int selectionMode)` Deprecated. Use `showOpenFilesChooser(java.lang.String, java.lang.String, javax.swing.filechooser.FileFilter, java.io.File)`.
`default java.io.File[]`	`showFilesChooser(java.lang.String title, java.lang.String approveText, java.lang.String globalVarName, int selectionMode, javax.swing.filechooser.FileFilter filter)` Deprecated. Use `showOpenFilesChooser(java.lang.String, java.lang.String, javax.swing.filechooser.FileFilter, java.io.File)`.
`default java.io.File[]`	`showFilesChooser(java.lang.String title, java.lang.String approveText, java.lang.String globalVarName, int selectionMode, javax.swing.filechooser.FileFilter filter, javax.swing.JComponent accessoryComponent)` Deprecated. Use `showOpenFilesChooser(java.lang.String, java.lang.String, javax.swing.filechooser.FileFilter, java.io.File)` for native OS compliance.
`java.io.File[]`	`showFilesChooser(java.lang.String title, java.lang.String approveText, java.lang.String globalVarName, int selectionMode, javax.swing.filechooser.FileFilter filter, javax.swing.JComponent accessoryComponent, java.io.File fallbackStartdir)` Legacy multiple file routing method.
`default java.io.File`	`showFolderChooser(java.lang.String title)`
`default java.io.File`	`showFolderChooser(java.lang.String title, java.lang.String globalVarName)`
`default java.io.File`	`showFolderChooser(java.lang.String title, java.lang.String globalVarName, boolean quiet)`
`java.io.File`	`showFolderChooser(java.lang.String title, java.lang.String globalVarName, boolean quiet, java.io.File preselectedFile)` Opens a native dialog strictly tailored to select a FOLDER / DIRECTORY.
`default java.lang.Integer`	`showIntegerInputDialog(java.lang.String s)`
`default java.lang.Integer`	`showIntegerInputDialog(java.lang.String s, java.lang.String title)`
`default java.lang.Integer`	`showIntegerInputDialog(java.lang.String s, java.lang.String title, java.lang.Integer oldValue)`
`java.lang.Integer`	`showIntegerInputDialog(java.lang.String s, java.lang.String title, java.lang.Integer oldValue, boolean nullAllowed)` Shows a modal dialog for `Integer` input.
`default java.lang.Object`	`showListChoiceDialog(java.lang.String title, java.lang.Object[] options)`
`java.lang.Object`	`showListChoiceDialog(java.lang.String title, java.lang.Object[] options, int defaultIndex)` Shows a simple list choice dialog with a default choice index.
`java.lang.Object`	`showListChoiceDialog(java.lang.String title, java.lang.Object[] options, java.lang.Object defaultChoice)` Shows a simple list choice dialog with a default choice object.
`default java.lang.Long`	`showLongInputDialog(java.lang.String s)`
`default java.lang.Long`	`showLongInputDialog(java.lang.String s, java.lang.String title)`
`default java.lang.Long`	`showLongInputDialog(java.lang.String s, java.lang.String title, java.lang.Long oldValue)`
`java.lang.Long`	`showLongInputDialog(java.lang.String s, java.lang.String title, java.lang.Long oldValue, boolean nullAllowed)` Shows a modal dialog for `Long` input.
`default void`	`showMessageDialog(java.lang.String s)`
`default void`	`showMessageDialog(java.lang.String s, java.lang.String type)`
`void`	`showMessageDialog(java.lang.String s, java.lang.String type, java.lang.String title)` Shows a modal message dialog that blocks execution until the user dismisses it.
`default void`	`showMessageDialogNonModal(java.lang.String s)`
`default void`	`showMessageDialogNonModal(java.lang.String s, java.lang.String type)`
`void`	`showMessageDialogNonModal(java.lang.String s, java.lang.String type, java.lang.String title)` Shows a non-modal message dialog that does not block background execution.
`default java.lang.Object`	`showMultipleChoiceDialog(java.lang.String s, java.lang.String title, java.lang.Object[] options)`
`java.lang.Object`	`showMultipleChoiceDialog(java.lang.String s, java.lang.String title, java.lang.Object[] options, int defaultIndex)` Shows a multiple choice dialog (checkbox style) with a default index.
`default java.io.File`	`showOpenFileChooser(java.lang.String title)`
`default java.io.File`	`showOpenFileChooser(java.lang.String title, java.lang.String globalVarName)`
`default java.io.File`	`showOpenFileChooser(java.lang.String title, java.lang.String globalVarName, boolean quiet)`
`java.io.File`	`showOpenFileChooser(java.lang.String title, java.lang.String globalVarName, boolean quiet, javax.swing.filechooser.FileFilter filter)` Opens a native OPEN dialog strictly tailored to select a SINGLE EXISTING FILE.
`default java.io.File`	`showOpenFileChooser(java.lang.String title, java.lang.String globalVarName, javax.swing.filechooser.FileFilter filter)`
`default java.io.File[]`	`showOpenFilesChooser(java.lang.String title)`
`default java.io.File[]`	`showOpenFilesChooser(java.lang.String title, java.lang.String globalVarName)`
`default java.io.File[]`	`showOpenFilesChooser(java.lang.String title, java.lang.String globalVarName, javax.swing.filechooser.FileFilter filter)`
`java.io.File[]`	`showOpenFilesChooser(java.lang.String title, java.lang.String globalVarName, javax.swing.filechooser.FileFilter filter, java.io.File preselectedFile)` Opens a native OPEN dialog configured to select MULTIPLE EXISTING FILES.
`default java.lang.String`	`showPasswordInputDialog(java.lang.String s)`
`default java.lang.String`	`showPasswordInputDialog(java.lang.String s, java.lang.String title)` Shows a modal dialog for secure password input.
`default java.io.File`	`showSaveFileChooser(java.lang.String title)`
`default java.io.File`	`showSaveFileChooser(java.lang.String title, java.lang.String globalVarName)`
`default java.io.File`	`showSaveFileChooser(java.lang.String title, java.lang.String globalVarName, javax.swing.filechooser.FileFilter filter)`
`default java.io.File`	`showSaveFileChooser(java.lang.String title, java.lang.String globalVarName, javax.swing.filechooser.FileFilter filter, boolean quiet)`
`java.io.File`	`showSaveFileChooser(java.lang.String title, java.lang.String globalVarName, javax.swing.filechooser.FileFilter filter, boolean quiet, java.io.File preselectedFile)` Opens a native SAVE dialog with an input field for defining a file name.
`default java.io.File`	`showSaveFileChooser(java.lang.String title, java.lang.String globalVarName, javax.swing.filechooser.FileFilter filter, java.io.File preselectedFile)`
`default java.lang.String`	`showStringInputDialog(java.lang.String s)`
`default java.lang.String`	`showStringInputDialog(java.lang.String s, java.lang.String title)`
`default java.lang.String`	`showStringInputDialog(java.lang.String s, java.lang.String title, java.lang.String oldValue)`
`default java.lang.String`	`showStringInputDialog(java.lang.String s, java.lang.String title, java.lang.String oldValue, boolean multilineInput)`
`java.lang.String`	`showStringInputDialog(java.lang.String s, java.lang.String title, java.lang.String oldValue, boolean multilineInput, boolean passwordInput)` Shows a modal dialog for string input.
`default java.util.Date[]`	`showTimespanInputDialog(java.lang.String s)`
`default java.util.Date[]`	`showTimespanInputDialog(java.lang.String s, java.lang.String title)`
`default java.util.Date[]`	`showTimespanInputDialog(java.lang.String s, java.lang.String title, java.util.Date oldValueStart)`
`default java.util.Date[]`	`showTimespanInputDialog(java.lang.String s, java.lang.String title, java.util.Date oldValueStart, java.util.Date oldValueEnd)`
`default java.util.Date[]`	`showTimespanInputDialog(java.lang.String s, java.lang.String title, java.util.Date oldValueStart, java.util.Date oldValueEnd, boolean startNullAllowed)`
`default java.util.Date[]`	`showTimespanInputDialog(java.lang.String s, java.lang.String title, java.util.Date oldValueStart, java.util.Date oldValueEnd, boolean startNullAllowed, boolean endNullAllowed)`
`java.util.Date[]`	`showTimespanInputDialog(java.lang.String s, java.lang.String title, java.util.Date oldValueStart, java.util.Date oldValueEnd, boolean startNullAllowed, boolean endNullAllowed, java.lang.String format)` Shows a modal dialog for inputting a start and end date timespan.
`default java.lang.String[]`	`showUserLoginDialog(java.lang.String message, java.lang.String title)`
`java.lang.String[]`	`showUserLoginDialog(java.lang.String message, java.lang.String title, java.lang.String user)` Shows a dialog prompting for username and password, with an optionally pre-filled username.
`boolean`	`showYesNoDialog(java.lang.String message)` Shows a simple modal dialog asking a Yes/No question.

Field Detail
- TYPE_INFO
```
static final java.lang.String TYPE_INFO
```
  Informational message type.
  
  See Also:
  
  Constant Field Values
- TYPE_ERROR
```
static final java.lang.String TYPE_ERROR
```
  Error message type.
  
  See Also:
  
  Constant Field Values
- TYPE_WARNING
```
static final java.lang.String TYPE_WARNING
```
  Warning message type.
  
  See Also:
  
  Constant Field Values
- TYPE_QUESTION
```
static final java.lang.String TYPE_QUESTION
```
  Question/confirmation message type.
  
  See Also:
  
  Constant Field Values
- TYPE_PLAIN
```
static final java.lang.String TYPE_PLAIN
```
  Plain message type, typically for logs or simple text display.
  
  See Also:
  
  Constant Field Values
- CONFIRMED
```
static final int CONFIRMED
```
  Return value for a confirmed/yes action.
  
  See Also:
  
  Constant Field Values
- DENIED
```
static final int DENIED
```
  Return value for a denied/no action.
  
  See Also:
  
  Constant Field Values
- CANCELED
```
static final int CANCELED
```
  Return value for a canceled action.
  
  See Also:
  
  Constant Field Values

Method Detail

showError
```
java.lang.Object showError(java.lang.String message,
                           java.lang.Throwable exception,
                           java.lang.String title,
                           boolean deprecatedForceSynchronous,
                           java.lang.Object[] customButtons)
```
Shows an error message in a modal dialog with an optional exception stack trace.

Parameters:

message - The error message to display.

exception - The exception that caused the error (may be null).

title - The title of the dialog window.

deprecatedForceSynchronous - Ignored for modern execution. Retained only for backward compatibility.

customButtons - An array of custom buttons to display, or null for default buttons.

Returns:

The object corresponding to the button the user clicked.

showError

default java.lang.Object showError(java.lang.String message,
                                   java.lang.Throwable exception,
                                   java.lang.String title,
                                   boolean deprecatedForceSynchronous)

See Also:: showError(String, Throwable, String, boolean, Object[])

showError

default java.lang.Object showError(java.lang.String message,
                                   java.lang.Throwable exception,
                                   java.lang.String title)

See Also:: showError(String, Throwable, String, boolean, Object[])

showError

default java.lang.Object showError(java.lang.String message,
                                   java.lang.Throwable exception)

See Also:: showError(String, Throwable, String, boolean, Object[])

showError
```
default java.lang.Object showError(java.lang.String message)
```
See Also:

showError(String, Throwable, String, boolean, Object[])

showError
```
java.lang.Object showError(java.lang.String message,
                           java.lang.Throwable exception,
                           boolean suppressPrintCausedBy,
                           java.lang.String title,
                           java.lang.Object[] customButtons)
```
Shows an error message, controlling whether the "Caused by" trace is printed in the details.

Parameters:

message - The error message to display.

exception - The exception that caused the error (may be null).

suppressPrintCausedBy - If true, suppresses the printing of the "Caused by" chain.

title - The title of the dialog window.

customButtons - An array of custom buttons to display.

Returns:

The object corresponding to the button the user clicked.

showError

default java.lang.Object showError(java.lang.String message,
                                   java.lang.Throwable exception,
                                   boolean suppressPrintCausedBy,
                                   java.lang.String title)

See Also:: showError(String, Throwable, boolean, String, Object[])

showError

default java.lang.Object showError(java.lang.String message,
                                   java.lang.Throwable exception,
                                   boolean suppressPrintCausedBy)

See Also:: showError(String, Throwable, boolean, String, Object[])

showException
```
java.lang.Object showException(java.lang.Throwable ex,
                               boolean deprecatedForceSynchronous,
                               java.lang.Object[] customButtons)
```
Shows an exception stack trace in a dialog without a custom error message.

Parameters:

ex - The exception to display.

deprecatedForceSynchronous - Ignored for modern execution. Retained only for backward compatibility.

customButtons - An array of custom buttons to display.

Returns:

The object corresponding to the button the user clicked.

showException

default java.lang.Object showException(java.lang.Throwable ex,
                                       boolean deprecatedForceSynchronous)

See Also:: showException(Throwable, boolean, Object[])

showException

default java.lang.Object showException(java.lang.Throwable ex)

See Also:: showException(Throwable, boolean, Object[])

showYesNoDialog
```
boolean showYesNoDialog(java.lang.String message)
```
Shows a simple modal dialog asking a Yes/No question.

Parameters:

message - The question/message to display.

Returns:

true if the user selects Yes, false if No or canceled.

showConfirmDialog
```
int showConfirmDialog(java.lang.String message,
                      java.lang.String title,
                      boolean forceAffirmation,
                      java.lang.String affirmationText,
                      java.lang.String affirmationString)
```
Displays a confirmation dialog offering YES, NO, and CANCEL options, with optional affirmation text required for confirmation.
Important Note on Return Value and Scripting Languages:

This method returns an int result code from JOptionPane. If this result is used in a language that implicitly converts integers to booleans (like NetRexx or Groovy):
- JOptionPane.YES_OPTION (which is 0) evaluates to false.
- JOptionPane.NO_OPTION (which is 1) and JOptionPane.CANCEL_OPTION (which is 2) evaluate to true.
This inversion can lead to significant logical errors if not handled explicitly.
Parameters:

message - The primary text or question to display.

title - The title of the dialog.

forceAffirmation - If true, the user must type the affirmationString to enable the confirm button.

affirmationText - The instructional text displayed above the input field.

affirmationString - The specific string the user must enter to affirm the action.

Returns:

An int indicating the user action (e.g. JOptionPane.YES_OPTION). Note: Closing the dialog (e.g. via the close window button) will be interpreted as a cancel action.

showConfirmDialog

default int showConfirmDialog(java.lang.String message,
                              java.lang.String title,
                              boolean forceAffirmation,
                              java.lang.String affirmationText)

See Also:: showConfirmDialog(String, String, boolean, String, String)

showConfirmDialog

default int showConfirmDialog(java.lang.String message,
                              java.lang.String title,
                              boolean forceAffirmation)

See Also:: showConfirmDialog(String, String, boolean, String, String)

showConfirmDialog

default int showConfirmDialog(java.lang.String message,
                              java.lang.String title)

See Also:: showConfirmDialog(String, String, boolean, String, String)

showConfirmDialog
```
default int showConfirmDialog(java.lang.String message)
```
See Also:

showConfirmDialog(String, String, boolean, String, String)

showStringInputDialog
```
java.lang.String showStringInputDialog(java.lang.String s,
                                       java.lang.String title,
                                       java.lang.String oldValue,
                                       boolean multilineInput,
                                       boolean passwordInput)
```
Shows a modal dialog for string input.

Parameters:

s - The prompt message.

title - The title of the dialog.

oldValue - The initial value shown in the input field.

multilineInput - If true, allows multiple lines of text input.

passwordInput - If true, hides the input text (e.g. for password entry).

Returns:

The string entered by the user, or null if canceled.

showStringInputDialog

default java.lang.String showStringInputDialog(java.lang.String s,
                                               java.lang.String title,
                                               java.lang.String oldValue,
                                               boolean multilineInput)

See Also:: showStringInputDialog(String, String, String, boolean, boolean)

showStringInputDialog

default java.lang.String showStringInputDialog(java.lang.String s,
                                               java.lang.String title,
                                               java.lang.String oldValue)

See Also:: showStringInputDialog(String, String, String, boolean, boolean)

showStringInputDialog

default java.lang.String showStringInputDialog(java.lang.String s,
                                               java.lang.String title)

See Also:: showStringInputDialog(String, String, String, boolean, boolean)

showStringInputDialog
```
default java.lang.String showStringInputDialog(java.lang.String s)
```
See Also:

showStringInputDialog(String, String, String, boolean, boolean)

showPasswordInputDialog
```
default java.lang.String showPasswordInputDialog(java.lang.String s,
                                                 java.lang.String title)
```
Shows a modal dialog for secure password input.

Parameters:

s - The prompt message.

title - The title of the dialog.

Returns:

The password string entered by the user, or null if canceled.

showPasswordInputDialog

default java.lang.String showPasswordInputDialog(java.lang.String s)

See Also:: showPasswordInputDialog(String, String)

showBigDecimalInputDialog
```
java.math.BigDecimal showBigDecimalInputDialog(java.lang.String s,
                                               java.lang.String title,
                                               java.math.BigDecimal oldValue,
                                               boolean nullAllowed)
```
Shows a modal dialog for BigDecimal input.

Parameters:

s - The prompt message.

title - The title of the dialog.

oldValue - The initial value shown in the input field.

nullAllowed - If true, allows the user to leave the field empty (returns null).

Returns:

The BigDecimal entered by the user, or null if canceled/empty.

showBigDecimalInputDialog

default java.math.BigDecimal showBigDecimalInputDialog(java.lang.String s,
                                                       java.lang.String title,
                                                       java.math.BigDecimal oldValue)

See Also:: showBigDecimalInputDialog(String, String, BigDecimal, boolean)

showBigDecimalInputDialog

default java.math.BigDecimal showBigDecimalInputDialog(java.lang.String s,
                                                       java.lang.String title)

See Also:: showBigDecimalInputDialog(String, String, BigDecimal, boolean)

showBigDecimalInputDialog
```
default java.math.BigDecimal showBigDecimalInputDialog(java.lang.String s)
```
See Also:

showBigDecimalInputDialog(String, String, BigDecimal, boolean)

showIntegerInputDialog
```
java.lang.Integer showIntegerInputDialog(java.lang.String s,
                                         java.lang.String title,
                                         java.lang.Integer oldValue,
                                         boolean nullAllowed)
```
Shows a modal dialog for Integer input.

Parameters:

s - The prompt message.

title - The title of the dialog.

oldValue - The initial value shown in the input field.

nullAllowed - If true, allows the user to leave the field empty (returns null).

Returns:

The Integer entered by the user, or null if canceled/empty.

showIntegerInputDialog

default java.lang.Integer showIntegerInputDialog(java.lang.String s,
                                                 java.lang.String title,
                                                 java.lang.Integer oldValue)

See Also:: showIntegerInputDialog(String, String, Integer, boolean)

showIntegerInputDialog

default java.lang.Integer showIntegerInputDialog(java.lang.String s,
                                                 java.lang.String title)

See Also:: showIntegerInputDialog(String, String, Integer, boolean)

showIntegerInputDialog
```
default java.lang.Integer showIntegerInputDialog(java.lang.String s)
```
See Also:

showIntegerInputDialog(String, String, Integer, boolean)

showLongInputDialog
```
java.lang.Long showLongInputDialog(java.lang.String s,
                                   java.lang.String title,
                                   java.lang.Long oldValue,
                                   boolean nullAllowed)
```
Shows a modal dialog for Long input.

Parameters:

s - The prompt message.

title - The title of the dialog.

oldValue - The initial value shown in the input field.

nullAllowed - If true, allows the user to leave the field empty (returns null).

Returns:

The Long entered by the user, or null if canceled/empty.

showLongInputDialog

default java.lang.Long showLongInputDialog(java.lang.String s,
                                           java.lang.String title,
                                           java.lang.Long oldValue)

See Also:: showLongInputDialog(String, String, Long, boolean)

showLongInputDialog

default java.lang.Long showLongInputDialog(java.lang.String s,
                                           java.lang.String title)

See Also:: showLongInputDialog(String, String, Long, boolean)

showLongInputDialog
```
default java.lang.Long showLongInputDialog(java.lang.String s)
```
See Also:

showLongInputDialog(String, String, Long, boolean)

showDateInputDialog
```
java.util.Date showDateInputDialog(java.lang.String s,
                                   java.lang.String title,
                                   java.util.Date oldValue,
                                   boolean nullAllowed,
                                   java.lang.String format)
```
Shows a modal dialog for Date input.

Parameters:

s - The prompt message.

title - The title of the dialog.

oldValue - The initial value shown in the input field.

nullAllowed - If true, allows the user to leave the field empty (returns null).

format - The date format pattern (e.g. "yyyy-MM-dd").

Returns:

The Date entered by the user, or null if canceled/empty.

showDateInputDialog

default java.util.Date showDateInputDialog(java.lang.String s,
                                           java.lang.String title,
                                           java.util.Date oldValue,
                                           boolean nullAllowed)

See Also:: showDateInputDialog(String, String, Date, boolean, String)

showDateInputDialog

default java.util.Date showDateInputDialog(java.lang.String s,
                                           java.lang.String title,
                                           java.util.Date oldValue)

See Also:: showDateInputDialog(String, String, Date, boolean, String)

showDateInputDialog

default java.util.Date showDateInputDialog(java.lang.String s,
                                           java.lang.String title)

See Also:: showDateInputDialog(String, String, Date, boolean, String)

showDateInputDialog
```
default java.util.Date showDateInputDialog(java.lang.String s)
```
See Also:

showDateInputDialog(String, String, Date, boolean, String)

showTimespanInputDialog
```
java.util.Date[] showTimespanInputDialog(java.lang.String s,
                                         java.lang.String title,
                                         java.util.Date oldValueStart,
                                         java.util.Date oldValueEnd,
                                         boolean startNullAllowed,
                                         boolean endNullAllowed,
                                         java.lang.String format)
```
Shows a modal dialog for inputting a start and end date timespan.

Parameters:

s - The prompt message.

title - The title of the dialog.

oldValueStart - The initial value for the start date.

oldValueEnd - The initial value for the end date.

startNullAllowed - If true, allows the start date field to be empty.

endNullAllowed - If true, allows the end date field to be empty.

format - The date format pattern (e.g. "yyyy-MM-dd").

Returns:

A two-element array of Date objects: [startDate, endDate], or null if canceled.

showTimespanInputDialog

default java.util.Date[] showTimespanInputDialog(java.lang.String s,
                                                 java.lang.String title,
                                                 java.util.Date oldValueStart,
                                                 java.util.Date oldValueEnd,
                                                 boolean startNullAllowed,
                                                 boolean endNullAllowed)

See Also:: showTimespanInputDialog(String, String, Date, Date, boolean, boolean, String)

showTimespanInputDialog

default java.util.Date[] showTimespanInputDialog(java.lang.String s,
                                                 java.lang.String title,
                                                 java.util.Date oldValueStart,
                                                 java.util.Date oldValueEnd,
                                                 boolean startNullAllowed)

See Also:: showTimespanInputDialog(String, String, Date, Date, boolean, boolean, String)

showTimespanInputDialog

default java.util.Date[] showTimespanInputDialog(java.lang.String s,
                                                 java.lang.String title,
                                                 java.util.Date oldValueStart,
                                                 java.util.Date oldValueEnd)

See Also:: showTimespanInputDialog(String, String, Date, Date, boolean, boolean, String)

showTimespanInputDialog

default java.util.Date[] showTimespanInputDialog(java.lang.String s,
                                                 java.lang.String title,
                                                 java.util.Date oldValueStart)

See Also:: showTimespanInputDialog(String, String, Date, Date, boolean, boolean, String)

showTimespanInputDialog

default java.util.Date[] showTimespanInputDialog(java.lang.String s,
                                                 java.lang.String title)

See Also:: showTimespanInputDialog(String, String, Date, Date, boolean, boolean, String)

showTimespanInputDialog
```
default java.util.Date[] showTimespanInputDialog(java.lang.String s)
```
See Also:

showTimespanInputDialog(String, String, Date, Date, boolean, boolean, String)

showMessageDialogNonModal
```
void showMessageDialogNonModal(java.lang.String s,
                               java.lang.String type,
                               java.lang.String title)
```
Shows a non-modal message dialog that does not block background execution.

Parameters:

s - The message content.

type - The type of message (e.g. TYPE_INFO, TYPE_ERROR).

title - The title of the dialog.

showMessageDialogNonModal

default void showMessageDialogNonModal(java.lang.String s,
                                       java.lang.String type)

See Also:: showMessageDialogNonModal(String, String, String)

showMessageDialogNonModal
```
default void showMessageDialogNonModal(java.lang.String s)
```
See Also:

showMessageDialogNonModal(String, String, String)

showMessageDialog
```
void showMessageDialog(java.lang.String s,
                       java.lang.String type,
                       java.lang.String title)
```
Shows a modal message dialog that blocks execution until the user dismisses it.

Parameters:

s - The message content.

type - The type of message (e.g. TYPE_INFO, TYPE_ERROR).

title - The title of the dialog.

showMessageDialog

default void showMessageDialog(java.lang.String s,
                               java.lang.String type)

See Also:: showMessageDialog(String, String, String)

showMessageDialog
```
default void showMessageDialog(java.lang.String s)
```
See Also:

showMessageDialog(String, String, String)

showSaveFileChooser
```
java.io.File showSaveFileChooser(java.lang.String title,
                                 java.lang.String globalVarName,
                                 javax.swing.filechooser.FileFilter filter,
                                 boolean quiet,
                                 java.io.File preselectedFile)
```
Opens a native SAVE dialog with an input field for defining a file name.
Note: Native OS save dialogs inherently support single-file selection only.

Parameters:

title - The title of the dialog.

globalVarName - A global variable name for this selection context (LRU dir tracking).

filter - The file filter to apply natively.

quiet - If true, suppresses the UI if the start directory is already set.

preselectedFile - The file to be initially selected (pre-fills the save input field).

Returns:

The selected File to save to, or null if canceled.

showSaveFileChooser

default java.io.File showSaveFileChooser(java.lang.String title,
                                         java.lang.String globalVarName,
                                         javax.swing.filechooser.FileFilter filter,
                                         boolean quiet)

See Also:: showSaveFileChooser(String, String, FileFilter, boolean, File)

showSaveFileChooser

default java.io.File showSaveFileChooser(java.lang.String title,
                                         java.lang.String globalVarName,
                                         javax.swing.filechooser.FileFilter filter,
                                         java.io.File preselectedFile)

See Also:: showSaveFileChooser(String, String, FileFilter, boolean, File)

showSaveFileChooser

default java.io.File showSaveFileChooser(java.lang.String title,
                                         java.lang.String globalVarName,
                                         javax.swing.filechooser.FileFilter filter)

See Also:: showSaveFileChooser(String, String, FileFilter, boolean, File)

showSaveFileChooser

default java.io.File showSaveFileChooser(java.lang.String title,
                                         java.lang.String globalVarName)

See Also:: showSaveFileChooser(String, String, FileFilter, boolean, File)

showSaveFileChooser
```
default java.io.File showSaveFileChooser(java.lang.String title)
```
See Also:

showSaveFileChooser(String, String, FileFilter, boolean, File)

showOpenFileChooser
```
java.io.File showOpenFileChooser(java.lang.String title,
                                 java.lang.String globalVarName,
                                 boolean quiet,
                                 javax.swing.filechooser.FileFilter filter)
```
Opens a native OPEN dialog strictly tailored to select a SINGLE EXISTING FILE.

Parameters:

title - The title of the dialog.

globalVarName - A global variable name for this selection context (LRU dir).

quiet - If true, suppresses the UI if the start directory is already set.

filter - The file filter to apply.

Returns:

The selected existing File, or null if canceled.

showOpenFileChooser

default java.io.File showOpenFileChooser(java.lang.String title,
                                         java.lang.String globalVarName,
                                         boolean quiet)

See Also:: showOpenFileChooser(String, String, boolean, FileFilter)

showOpenFileChooser

default java.io.File showOpenFileChooser(java.lang.String title,
                                         java.lang.String globalVarName,
                                         javax.swing.filechooser.FileFilter filter)

See Also:: showOpenFileChooser(String, String, boolean, FileFilter)

showOpenFileChooser

default java.io.File showOpenFileChooser(java.lang.String title,
                                         java.lang.String globalVarName)

See Also:: showOpenFileChooser(String, String, boolean, FileFilter)

showOpenFileChooser
```
default java.io.File showOpenFileChooser(java.lang.String title)
```
See Also:

showOpenFileChooser(String, String, boolean, FileFilter)

showFolderChooser
```
java.io.File showFolderChooser(java.lang.String title,
                               java.lang.String globalVarName,
                               boolean quiet,
                               java.io.File preselectedFile)
```
Opens a native dialog strictly tailored to select a FOLDER / DIRECTORY.
Note: Native operating systems enforce directory selection via their "Open" dialog interface, even when the application intends to use the selected folder as a save/export destination.

Parameters:

title - The title of the dialog (e.g. "Select Export Folder").

globalVarName - A global variable name for this selection context (LRU dir).

quiet - If true, suppresses the UI if the start directory is already set.

preselectedFile - An optional directory to navigate into initially. If the directory does not exist, the OS typically falls back to the nearest existing parent.

Returns:

The selected directory as a File, or null if canceled.

showFolderChooser

default java.io.File showFolderChooser(java.lang.String title,
                                       java.lang.String globalVarName,
                                       boolean quiet)

See Also:: showFolderChooser(String, String, boolean, File)

showFolderChooser

default java.io.File showFolderChooser(java.lang.String title,
                                       java.lang.String globalVarName)

See Also:: showFolderChooser(String, String, boolean, File)

showFolderChooser
```
default java.io.File showFolderChooser(java.lang.String title)
```
See Also:

showFolderChooser(String, String, boolean, File)

showOpenFilesChooser
```
java.io.File[] showOpenFilesChooser(java.lang.String title,
                                    java.lang.String globalVarName,
                                    javax.swing.filechooser.FileFilter filter,
                                    java.io.File preselectedFile)
```
Opens a native OPEN dialog configured to select MULTIPLE EXISTING FILES.

Parameters:

title - The title of the dialog.

globalVarName - A global variable name for this selection context (LRU dir).

filter - The file filter to apply.

preselectedFile - A file to pre-select, positioning the user contextually.

Returns:

An array of selected File objects, or null if canceled.

showOpenFilesChooser

default java.io.File[] showOpenFilesChooser(java.lang.String title,
                                            java.lang.String globalVarName,
                                            javax.swing.filechooser.FileFilter filter)

See Also:: showOpenFilesChooser(String, String, FileFilter, File)

showOpenFilesChooser

default java.io.File[] showOpenFilesChooser(java.lang.String title,
                                            java.lang.String globalVarName)

See Also:: showOpenFilesChooser(String, String, FileFilter, File)

showOpenFilesChooser
```
default java.io.File[] showOpenFilesChooser(java.lang.String title)
```
See Also:

showOpenFilesChooser(String, String, FileFilter, File)

showFileChooser
```
java.io.File showFileChooser(java.lang.String title,
                             java.lang.String approveText,
                             java.lang.String globalVarName,
                             int selectionMode,
                             boolean quiet,
                             javax.swing.filechooser.FileFilter filter,
                             javax.swing.JComponent accessoryComponent,
                             java.io.File preselectedFile,
                             java.io.File fallbackStartdir,
                             int dialogType)
```
Internal and Legacy routing method for single file / directory selections.

Parameters:

title - The dialog title.

approveText - The text on the approval button.

globalVarName - The LRU tracking variable name.

selectionMode - The Swing selection mode constant.

quiet - If true, skips the dialog if LRU is known.

filter - The file filter to apply.

accessoryComponent - A custom Swing component (forces Swing fallback natively).

preselectedFile - The initially selected file.

fallbackStartdir - The directory to start in if no LRU exists.

dialogType - The Swing dialog type (Open, Save, Custom).

Returns:

The selected File, or null if canceled.

showFileChooser

@Deprecated
default java.io.File showFileChooser(java.lang.String title,
                                                 java.lang.String approveText,
                                                 java.lang.String globalVarName,
                                                 int selectionMode,
                                                 boolean quiet,
                                                 javax.swing.filechooser.FileFilter filter,
                                                 javax.swing.JComponent accessoryComponent,
                                                 java.io.File preselectedFile,
                                                 java.io.File fallbackStartdir)

Deprecated. Use showOpenFileChooser(java.lang.String, java.lang.String, boolean, javax.swing.filechooser.FileFilter), showSaveFileChooser(java.lang.String, java.lang.String, javax.swing.filechooser.FileFilter, boolean, java.io.File), or showFolderChooser(java.lang.String, java.lang.String, boolean, java.io.File) to guarantee native OS dialog compliance (preventing invalid FlatLaf fallback combinations).

Shows a dialog to select a single file or directory.