java.lang.Object
   |
   +--java.awt.Component
         |
         +--java.awt.Container
               |
               +--javax.swing.JComponent
                     |
                     +--javax.swing.JOptionPane

Deklaration

Beschreibung

Hier die vier Typen:

• showConfirmDialog
  Fragt beim Benutzer nach, der Ja, Nein oder Abbruch klicken kann.
• showInputDialog
  Fragt nach einer Eingabe.
• showMessageDialog
  Gibt einen Hinweis aus.

Hier einige Beispiele für die Benutzung.

 // Zeigt eine Fehlermeldung an.
 JOptionPane.showMessageDialog(null, "Fehler", "Fehler", JOptionPane.ERROR_MESSAGE);

 // Zeigt einen JInternalFrame mit einer Information an.
 JOptionPane.showInternalMessageDialog(frame, "Information", "Information", JOptionPane.INFORMATION_MESSAGE);

 // Gibt die Auswahl zwischen Ja und Nein vor
 JOptionPane.showConfirmDialog(null, "Sicher?", "Sicher?", JOptionPane.YES_NO_OPTION);

 // Zeigt ein JInternalFrame an mit der Wahl zwischen Ja, Nein und Abbruch.
 JOptionPane.showInternalConfirmDialog(frame, "Wollen Sie das Dokument vor dem Beenden speichern?", "Speichern", JOptionPane.YES_NO_CANCEL_OPTION, JOptionPane.INFORMATION_MESSAGE);

 // Zeigt einen Warndialog mit »OK« und »CANCEL« an. »OK« ist dabei als Standard-Button gesetzt.
 Object[] options = { "OK", "CANCEL" };
 JOptionPane.showOptionDialog(null, "Warnung", "Warnung", JOptionPane.DEFAULT_OPTION, JOptionPane.WARNING_MESSAGE, null, options, options[0]);

 // Fragt den Benutzer nach einem String.
 String inputValue = JOptionPane.showInputDialog("Bitte einen Wert eingeben");

 // Bittet den Benutzer, einen String auszuwählen
 Object[] possibleValues = { "First", "Second", "Third" };
 Object selectedValue = JOptionPane.showInputDialog(null, "Bitte wählen Sie aus", "Eingabe", JOptionPane.INFORMATION_MESSAGE, null, possibleValues, possibleValues[0]);

Zusätzlich kann man auch selbst Exemplare etzeugen. Das folgende Beispiel zeigt den grundsätzlichen Aufbau:

     JOptionPane pane = new JOptionPane(...);
     pane.setXXX(...); // Konfigurieren
     JDialog dialog = pane.createDialog(parentComponent, title);
     dialog.show();
     Object selectedValue = pane.getValue();
     if(selectedValue == null)
       return CLOSED_OPTION;
     // Wenn es keine Optionen gibt
     if(options == null) {
       if(selectedValue instanceof Integer)
          return ((Integer)selectedValue).intValue();
       return CLOSED_OPTION;
     }
     // Wenn es Optionen gibt
     for(int counter = 0, maxCounter = options.length;
        counter < maxCounter; counter++) {
        if(options[counter].equals(selectedValue))
        return counter;
     }
     return CLOSED_OPTION;
 

Datenelemente im Detail

public final static Object UNINITIALIZED_VALUE

Zeigt, dass der Benutzer keinen Wert augewählt hat.

public final static int DEFAULT_OPTION

Wird für showConfirmDialog benutzt.

public final static int YES_NO_OPTION

Wird für showConfirmDialog benutzt.

public final static int YES_NO_CANCEL_OPTION

Wird für showConfirmDialog benutzt.

public final static int OK_CANCEL_OPTION

Wird für showConfirmDialog benutzt.

public final static int YES_OPTION

Wird für showConfirmDialog benutzt.

public final static int NO_OPTION

Wird für showConfirmDialog benutzt.

public final static int CANCEL_OPTION

Wird für showConfirmDialog benutzt.

public final static int OK_OPTION

Wird für showConfirmDialog benutzt.

public final static int CLOSED_OPTION

Rückgabewert, wenn der Benutzer das Fenster geschlossen hat. Das sollte wie CANCEL_OPTION oder NO_OPTION.

public final static int ERROR_MESSAGE

Eine Fehlermeldung.

public final static int INFORMATION_MESSAGE

Eine Informationsnachricht.

public final static int WARNING_MESSAGE

Eine Warnmeldung.

public final static int QUESTION_MESSAGE

Ein Fragedialog.

public final static int PLAIN_MESSAGE

Eine Nachricht ohne Grafik.

public final static String ICON_PROPERTY

Property-Name für die Grafik.

public final static String MESSAGE_PROPERTY

Property-Name für die Nachricht.

public final static String VALUE_PROPERTY

Property-Name für den Wert.

public final static String OPTIONS_PROPERTY

Property-Name für die Optionen.

public final static String INITIAL_VALUE_PROPERTY

Property-Name für den Initialwert.

public final static String MESSAGE_TYPE_PROPERTY

Property-Name für den Nachrichtentyp.

public final static String OPTION_TYPE_PROPERTY

Property-Name für den Optionstyp.

public final static String SELECTION_VALUES_PROPERTY

Property-Name für die Selektionswerte.

public final static String INITIAL_SELECTION_VALUE_PROPERTY

Property-Name für die initiale Selektion.

public final static String INPUT_VALUE_PROPERTY

Property-Name für den Eingabewert.

public final static String WANTS_INPUT_PROPERTY

Property-Name für die wantsInput.

protected Icon icon

Die Grafik.

protected Object message

Die Nachricht.

protected Object[] options

Die Optionen, aus denen der Benutzer wählen kann.

protected Object initialValue

Der Initialwert.

protected int messageType

Der Nachrichtentyp.

protected int optionType

Der Typ der Option (DEFAULT_OPTION, YES_NO_OPTION, YES_NO_CANCEL_OPTION oder OK_CANCEL_OPTION).

protected Object value

Der aktuelle Wert.

protected Object[] selectionValues

Die Selektionswerte.

protected Object inputValue

Der eingegebene Wert.

protected Object initialSelectionValue

Der initial selektierte Wert.

protected boolean wantsInput

Wenn auf true gesetzt, wird der Benutzer nach einem Wert gefragt.

Konstruktoren im Detail

public JOptionPane()

Erzeugt ein neues Exemplar.

public JOptionPane(Object message)

Erzeugt ein neues Exemplar mit der entsprechenden Nachricht.

public JOptionPane(Object message, int messageType)

Erzeugt ein neues Exemplar mit der entsprechenden Nachricht und dem entsprechenden Typ (ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE oder PLAIN_MESSAGE).

public JOptionPane(Object message, int messageType, int optionType)

Erzeugt ein neues Exemplar mit der entsprechenden Nachricht, dem entsprechenden Nachrichtentyp (ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE oder PLAIN_MESSAGE) und den entsprechenden Optionstyp (DEFAULT_OPTION, YES_NO_OPTION, YES_NO_CANCEL_OPTION oder OK_CANCEL_OPTION).

public JOptionPane(Object message, int messageType, int optionType, Icon icon)

Erzeugt ein neues Exemplar mit der entsprechenden Nachricht, dem entsprechenden Nachrichtentyp (ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE oder PLAIN_MESSAGE), den entsprechenden Optionstyp (DEFAULT_OPTION, YES_NO_OPTION, YES_NO_CANCEL_OPTION oder OK_CANCEL_OPTION) und der angegebenen Grafik.

public JOptionPane(Object message, int messageType, int optionType, Icon icon, Object[] options)

Erzeugt ein neues Exemplar mit der entsprechenden Nachricht, dem entsprechenden Nachrichtentyp (ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE oder PLAIN_MESSAGE), den entsprechenden Optionstyp (DEFAULT_OPTION, YES_NO_OPTION, YES_NO_CANCEL_OPTION oder OK_CANCEL_OPTION), der angegebenen Grafik und den angegebenen Optionen.

public JOptionPane(Object message, int messageType, int optionType, Icon icon, Object[] options, Object initialValue)

Erzeugt ein neues Exemplar mit der entsprechenden Nachricht, dem entsprechenden Nachrichtentyp (ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE oder PLAIN_MESSAGE), den entsprechenden Optionstyp (DEFAULT_OPTION, YES_NO_OPTION, YES_NO_CANCEL_OPTION oder OK_CANCEL_OPTION), der angegebenen Grafik, den angegebenen Optionen und dem angegebenen Initialwert.

Methoden im Detail

public static String showInputDialog(Object message)

Erfragt einen Eingabewert.

Exception: HeadlessException

• Wird ausgelöst, wenn GraphicsEnvironment.isHeadless() true liefert..

public static String showInputDialog(Object message, Object initialSelectionValue)

Fragt nach einem Eingabewert.

public static String showInputDialog(Component parentComponent, Object message)

Fragt den Benutzer nch einem Eingabewert.

Exception: HeadlessException

• Wird ausgelöst, wenn GraphicsEnvironment.isHeadless() true liefert..

public static String showInputDialog(Component parentComponent, Object message, Object initialSelectionValue)

Fragt nach einem Wert.

public static String showInputDialog(Component parentComponent, Object message, String title, int messageType)

Fragt nach einem Wert. Der Typ der Nachricht kann dabei ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE oder PLAIN_MESSAGE sein.

Exception: HeadlessException

• Wird ausgelöst, wenn GraphicsEnvironment.isHeadless() true liefert..

public static Object showInputDialog(Component parentComponent, Object message, String title, int messageType, Icon icon, Object[] selectionValues, Object initialSelectionValue)

Fragt nach einem Wert. Der Typ der Nachricht kann dabei ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE oder PLAIN_MESSAGE sein.

Exception: HeadlessException

• Wird ausgelöst, wenn GraphicsEnvironment.isHeadless() true liefert..

public static void showMessageDialog(Component parentComponent, Object message)

Zeigt ein Nachrichtenfenster an.

Exception: HeadlessException

• Wird ausgelöst, wenn GraphicsEnvironment.isHeadless() true liefert..

public static void showMessageDialog(Component parentComponent, Object message, String title, int messageType)

Zeigt ein Nachrichtenfenster an. Der Typ der Nachricht kann dabei ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE oder PLAIN_MESSAGE sein.

Exception: HeadlessException

• Wird ausgelöst, wenn GraphicsEnvironment.isHeadless() true liefert..

public static void showMessageDialog(Component parentComponent, Object message, String title, int messageType, Icon icon)

Zeigt ein Nachrichtenfenster an. Der Typ der Nachricht kann dabei ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE oder PLAIN_MESSAGE sein.

Exception: HeadlessException

• Wird ausgelöst, wenn GraphicsEnvironment.isHeadless() true liefert..

public static int showConfirmDialog(Component parentComponent, Object message)

Fragt den Benutzer nach einer Bestätigung.

Exception: HeadlessException

• Wird ausgelöst, wenn GraphicsEnvironment.isHeadless() true liefert..

public static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType)

Fragt den Benutzer nach einer Bestätigung. Mögliche Werte für den Typ der Optionen sind YES_NO_OPTION, oder YES_NO_CANCEL_OPTION.

Exception: HeadlessException

• Wird ausgelöst, wenn GraphicsEnvironment.isHeadless() true liefert..

public static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType)

Fragt den Benutzer nach einer Bestätigung. Mögliche Werte für den Typ der Optionen sind YES_NO_OPTION, oder YES_NO_CANCEL_OPTION. Der Typ der Nachricht kann dabei ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE oder PLAIN_MESSAGE sein.

Exception: HeadlessException

• Wird ausgelöst, wenn GraphicsEnvironment.isHeadless() true liefert. .

public static int showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon)

Wird ausgelöst, wenn GraphicsEnvironment.isHeadless() true liefert. Der Typ der Nachricht kann dabei ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE oder PLAIN_MESSAGE sein.

Exception: HeadlessException

• Wird ausgelöst, wenn GraphicsEnvironment.isHeadless() true liefert..

public static int showOptionDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon, Object[] options, Object initialValue)

Bietet dem Benutzer die Wahl zwischen verschiedenen Optionen. Der Typ der Nachricht kann dabei ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE oder PLAIN_MESSAGE sein.

Exception: HeadlessException

• Wird ausgelöst, wenn GraphicsEnvironment.isHeadless() true liefert..

public JDialog createDialog(Component parentComponent, String title)

Erzeugt ein neuen JDialog.

Exception: HeadlessException

• Wird ausgelöst, wenn GraphicsEnvironment.isHeadless() true liefert..

public static void showInternalMessageDialog(Component parentComponent, Object message)

Zeigt ein internes Nachrichtenfenster an.

public static void showInternalMessageDialog(Component parentComponent, Object message, String title, int messageType)

Zeigt ein internes Nachrichtenfenster an. Der Typ der Nachricht kann dabei ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE oder PLAIN_MESSAGE sein.

public static void showInternalMessageDialog(Component parentComponent, Object message, String title, int messageType, Icon icon)

Zeigt ein internes Nachrichtenfenster an. Der Typ der Nachricht kann dabei ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE oder PLAIN_MESSAGE sein.

public static int showInternalConfirmDialog(Component parentComponent, Object message)

Fragt den Benutzer nach einer Bestätigung.

public static int showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType)

Fragt den Benutzer nach einer Bestätigung. Mögliche Werte für den Typ der Optionen sind YES_NO_OPTION, oder YES_NO_CANCEL_OPTION.

public static int showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType)

Fragt den Benutzer nach einer Bestätigung. Mögliche Werte für den Typ der Optionen sind YES_NO_OPTION, oder YES_NO_CANCEL_OPTION. Der Typ der Nachricht kann dabei ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE oder PLAIN_MESSAGE sein.

public static int showInternalConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon)

Fragt den Benutzer nach einer Bestätigung. Mögliche Werte für den Typ der Optionen sind YES_NO_OPTION, oder YES_NO_CANCEL_OPTION. Der Typ der Nachricht kann dabei ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE oder PLAIN_MESSAGE sein.

public static int showInternalOptionDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon, Object[] options, Object initialValue)

Bietet dem Benutzer die Wahl zwischen verschiedenen Optionen. Der Typ der Nachricht kann dabei ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE oder PLAIN_MESSAGE sein.

public static String showInternalInputDialog(Component parentComponent, Object message)

Fragt den Benutzer nach einem Wert.

public static String showInternalInputDialog(Component parentComponent, Object message, String title, int messageType)

Fragt nach einem Wert. Der Typ der Nachricht kann dabei ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE oder PLAIN_MESSAGE sein.

public static Object showInternalInputDialog(Component parentComponent, Object message, String title, int messageType, Icon icon, Object[] selectionValues, Object initialSelectionValue)

Fragt nach einem Wert. Der Typ der Nachricht kann dabei ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE oder PLAIN_MESSAGE sein.

public JInternalFrame createInternalFrame(Component parentComponent, String title)

Erstellt ein JInternalFrame.

public static Frame getFrameForComponent(Component parentComponent)

Liefert den Frame zu der angegebene Komponente.

Exception: HeadlessException

• Wird ausgelöst, wenn GraphicsEnvironment.isHeadless() true liefert..

public static JDesktopPane getDesktopPaneForComponent(Component parentComponent)

Liefert das JDesktopPane zu der angegebenen Komponente.

public static void setRootFrame(Frame newRootFrame)

Setzt das Frame.

public static Frame getRootFrame()

Liefert das Frame.

Exception: HeadlessException

• Wird ausgelöst, wenn GraphicsEnvironment.isHeadless() true liefert..

public void setUI(OptionPaneUI ui)

Setzt das Look-and-Feel-Objekt, welches diese Komponente zeichnet.

public OptionPaneUI getUI()

Liefert das Look-and-Feel-Objekt, das diese Komponente zeichnet.

public void updateUI()

Setzt die UI Properties auf die Werte vom aktuelle Look-and-Feel zurück.

public String getUIClassID()

Liefert den Namen der Look-and-Feel-Klasse, die diese Komponente rendert.

public void setMessage(Object newMessage)

Setzt die Nachricht.

public Object getMessage()

Liefert die Nachricht.

public void setIcon(Icon newIcon)

Setzt die Grafik.

public Icon getIcon()

Liefert die Grafik.

public void setValue(Object newValue)

Sezt den Wert.

public Object getValue()

Liefert den Wert, den der Benutzer gewählt hat.

public void setOptions(Object[] newOptions)

Setzt die Optionen.

public Object[] getOptions()

Liefert die Optionen.

public void setInitialValue(Object newInitialValue)

Setzt den Initialwert.

public Object getInitialValue()

Liefert den Initialwert.

public void setMessageType(int newType)

Setzt den Nachrichtentyp auf ERROR_MESSAGE, INFORMATION_MESSAGE, WARNING_MESSAGE, QUESTION_MESSAGE, oder PLAIN_MESSAGE.

public int getMessageType()

Liefert den Nachrichtentyp.

public void setOptionType(int newType)

Setzt den Optionstyp auf DEFAULT_OPTION, YES_NO_OPTION, YES_NO_CANCEL_OPTION oder OK_CANCEL_OPTION.

public int getOptionType()

Liefert den Optionstyp.

public void setSelectionValues(Object[] newValues)

Setzt die Selektionswerte.

public Object[] getSelectionValues()

Liefert die selektierten Werte.

public void setInitialSelectionValue(Object newValue)

Setzt den initialen Selektionswert.

public Object getInitialSelectionValue()

Liefert den initialen Selektionswert.

public void setInputValue(Object newValue)

Setzt den Eingabewert.

public Object getInputValue()

Liefert den Eingabewert.

public int getMaxCharactersPerLineCount()

Liefert die maximale Anzahl an Zeichen, die in einer Zeile Nachrichtentext Platz haben.

public void setWantsInput(boolean newValue)

Gibt an, dass der Benutzer eine Eingabe machen soll.

public boolean getWantsInput()

Liefert true, wenn der Benutzer eine Eingabe machen sollen.

public void selectInitialValue()

Selektiert den initialen Wert.

protected String paramString()

Liefert eine String-Repräsentation dieser Komponente für Debugging-Zwecke. Unterschiedliche VMs können hierbei unterschiedliche Ergebnisse liefern.

public AccessibleContext getAccessibleContext()

Liefert das AccessibleContext-Exemplar zu dieser Komponente.