Class BasicOptionPaneUI

public static final int MinimumHeight

The minimum height for JOptionPanes.

Field Value:

90

public static final int MinimumWidth

The minimum width for JOptionPanes.

Field Value:

262

protected boolean hasCustomComponents

Whether the JOptionPane contains custom components.

protected Component initialFocusComponent

The button that will receive focus based on initialValue when no input component is present. If an input component is present, then the input component will receive focus instead.

protected JComponent inputComponent

The component that receives input when the JOptionPane needs it.

protected Dimension minimumSize

The minimum dimensions of the JOptionPane.

protected JOptionPane optionPane

The JOptionPane this UI delegate is used for.

protected PropertyChangeListener propertyChangeListener

The propertyChangeListener for the JOptionPane.

public BasicOptionPaneUI()

Creates a new BasicOptionPaneUI object.

protected void addButtonComponents(Container container,
                                   Object[] buttons,
                                   int initialIndex)

This method is messaged to add the buttons to the given container.

Parameters:

container - The container to add components to.

buttons - The buttons to add. (If it is an instance of component, the Object is added directly. If it is an instance of Icon, it is packed into a label and added. For all other cases, the string representation of the Object is retreived and packed into a label.)

initialIndex - The index of the component that is the initialValue.

protected void addIcon(Container top)

This method adds the appropriate icon the given container.

Parameters:

top - The container to add an icon to.

protected void addMessageComponents(Container container,
                                    GridBagConstraints cons,
                                    Object msg,
                                    int maxll,
                                    boolean internallyCreated)

This method creates the proper object (if necessary) to represent msg. (If msg is an instance of Component, it will add it directly. If it is an icon, then it will pack it in a label and add it. Otherwise, it gets treated as a string. If the string is longer than maxll, a box is created and the burstStringInto is called with the box as the container. The box is then added to the given container. Otherwise, the string is packed in a label and placed in the given container.) This method is also used for adding the inputComponent to the container.

Parameters:

container - The container to add to.

cons - The constraints when adding.

msg - The message to add.

maxll - The max line length.

internallyCreated - Whether the msg is internally created.

protected void burstStringInto(Container c,
                               String d,
                               int maxll)

This method creates instances of d (recursively if necessary based on maxll) and adds to c.

Parameters:

c - The container to add to.

d - The string to burst.

maxll - The max line length.

public boolean containsCustomComponents(JOptionPane op)

This method returns true if the given JOptionPane contains custom components.

Overrides:

containsCustomComponents in interface OptionPaneUI

Parameters:

op - The JOptionPane to check.

Returns:

True if the JOptionPane contains custom components.

protected ActionListener createButtonActionListener(int buttonIndex)

This method creates a button action listener for the given button index.

Parameters:

buttonIndex - The index of the button in components.

Returns:

A new ButtonActionListener.

protected Container createButtonArea()

This method creates the button area.

Returns:

A new Button Area.

protected LayoutManager createLayoutManager()

This method creates a new LayoutManager for the button area.

Returns:

A new LayoutManager for the button area.

protected Container createMessageArea()

This method creates the message area.

Returns:

A new message area.

protected PropertyChangeListener createPropertyChangeListener()

This method creates a new PropertyChangeListener for listening to the JOptionPane.

Returns:

A new PropertyChangeListener.

protected Container createSeparator()

This method creates a Container that will separate the message and button areas.

Returns:

A Container that will separate the message and button areas.

public static ComponentUI createUI(JComponent x)

This method creates a new BasicOptionPaneUI for the given component.

Overrides:

createUI in interface ComponentUI

Parameters:

x - The component to create a UI for.

Returns:

A new BasicOptionPaneUI.

protected Object[] getButtons()

This method returns the buttons for the JOptionPane. If no options are set, a set of options will be created based upon the optionType.

Returns:

The buttons that will be added.

protected Icon getIcon()

This method will return the icon the user has set or the icon that will be used based on message type.

Returns:

The icon to use in the JOptionPane.

protected Icon getIconForType(int messageType)

This method returns the icon for the given messageType.

Parameters:

messageType - The type of message.

Returns:

The icon for the given messageType.

protected int getInitialValueIndex()

This method returns the index of the initialValue in the options array.

Returns:

The index of the initalValue.

protected int getMaxCharactersPerLineCount()

This method returns the maximum number of characters that should be placed on a line.

Returns:

The maximum number of characteres that should be placed on a line.

public Dimension getMaximumSize(JComponent c)

This method returns the maximum size.

Overrides:

getMaximumSize in interface ComponentUI

Parameters:

c - The JComponent to measure.

Returns:

The maximum size.

protected Object getMessage()

This method returns the message of the JOptionPane.

Returns:

The message.

public Dimension getMinimumOptionPaneSize()

This method returns the minimum size of the JOptionPane.

Returns:

The minimum size.

public Dimension getMinimumSize(JComponent c)

This method returns the minimum size.

Overrides:

getMinimumSize in interface ComponentUI

Parameters:

c - The JComponent to measure.

Returns:

The minimum size.

public Dimension getPreferredSize(JComponent c)

This method returns the preferred size of the JOptionPane. The preferred size is the maximum of the size desired by the layout and the minimum size.

Overrides:

getPreferredSize in interface ComponentUI

Parameters:

c - The JComponent to measure.

Returns:

The preferred size.

protected boolean getSizeButtonsToSameWidth()

This method returns whether all buttons should have the same width.

Returns:

Whether all buttons should have the same width.

protected void installComponents()

This method installs components for the JOptionPane.

protected void installDefaults()

This method installs defaults for the JOptionPane.

protected void installKeyboardActions()

This method installs keyboard actions for the JOptionpane.

protected void installListeners()

This method installs listeners for the JOptionPane.

public void installUI(JComponent c)

This method installs the UI for the JOptionPane.

Overrides:

installUI in interface ComponentUI

Parameters:

c - The JComponent to install the UI for.

protected void resetInputValue()

Changes the inputValue property in the JOptionPane based on the current value of the inputComponent.

public void selectInitialValue(JOptionPane op)

This method requests focus to the inputComponent (if one is present) and the initialFocusComponent otherwise.

Overrides:

selectInitialValue in interface OptionPaneUI

Parameters:

op - The JOptionPane.

protected void uninstallComponents()

This method uninstalls all the components in the JOptionPane.

protected void uninstallDefaults()

This method uninstalls the defaults for the JOptionPane.

protected void uninstallKeyboardActions()

This method uninstalls keyboard actions for the JOptionPane.

protected void uninstallListeners()

This method uninstalls listeners for the JOptionPane.

public void uninstallUI(JComponent c)

This method uninstalls the UI for the given JComponent.

Overrides:

uninstallUI in interface ComponentUI

Parameters:

c - The JComponent to uninstall for.