com.Ostermiller.util
Class PasswordDialog

java.lang.Object
  extended by java.awt.Component
      extended by java.awt.Container
          extended by java.awt.Window
              extended by java.awt.Dialog
                  extended by javax.swing.JDialog
                      extended by com.Ostermiller.util.PasswordDialog
All Implemented Interfaces:
java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible, javax.swing.RootPaneContainer, javax.swing.WindowConstants

public class PasswordDialog
extends javax.swing.JDialog

A modal dialog that asks the user for a user name and password. More information about this class is available from ostermiller.org.

 PasswordDialog p = new PasswordDialog(null, "Test");
 if(p.showDialog()){
     System.out.println("Name: " + p.getName());
     System.out.println("Pass: " + p.getPass());
 } else {
     System.out.println("User selected cancel");
 }
 

Since:
ostermillerutils 1.00.00
See Also:
Serialized Form

Nested Class Summary
 
Nested classes/interfaces inherited from class javax.swing.JDialog
javax.swing.JDialog.AccessibleJDialog
 
Nested classes/interfaces inherited from class java.awt.Dialog
java.awt.Dialog.AccessibleAWTDialog, java.awt.Dialog.ModalExclusionType, java.awt.Dialog.ModalityType
 
Nested classes/interfaces inherited from class java.awt.Window
java.awt.Window.AccessibleAWTWindow
 
Nested classes/interfaces inherited from class java.awt.Container
java.awt.Container.AccessibleAWTContainer
 
Nested classes/interfaces inherited from class java.awt.Component
java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy
 
Field Summary
protected  javax.swing.JButton cancelButton
          The cancel button.
protected  java.util.ResourceBundle labels
          Locale specific strings displayed to the user.
protected  javax.swing.JTextField name
          Where the name is typed.
protected  javax.swing.JLabel nameLabel
          The label for the field in which the name is typed.
protected  javax.swing.JButton okButton
          The OK button.
protected  javax.swing.JPasswordField pass
          Where the password is typed.
protected  javax.swing.JLabel passLabel
          The label for the field in which the password is typed.
 
Fields inherited from class javax.swing.JDialog
accessibleContext, rootPane, rootPaneCheckingEnabled
 
Fields inherited from class java.awt.Dialog
DEFAULT_MODALITY_TYPE
 
Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
Fields inherited from interface javax.swing.WindowConstants
DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE
 
Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
Constructor Summary
PasswordDialog()
          Create this dialog with the default title.
PasswordDialog(java.awt.Frame parent)
          Create this dialog with the given parent and the default title.
PasswordDialog(java.awt.Frame parent, java.lang.String title)
          Create this dialog with the given parent and title.
 
Method Summary
protected  void dialogInit()
          Called by constructors to initialize the dialog.
 java.lang.String getName()
          Get the name that was entered into the dialog before the dialog was closed.
 java.lang.String getPass()
          Get the password that was entered into the dialog before the dialog was closed.
 boolean okPressed()
          Finds out if user used the OK button or an equivalent action to close the dialog.
 void setCancelText(java.lang.String cancel)
          Set the label on the cancel button.
 void setLocale(java.util.Locale locale)
          Set the locale used for getting localized strings.
 void setName(java.lang.String name)
          Set the name that appears as the default An empty string will be used if this in not specified before the dialog is displayed.
 void setNameLabel(java.lang.String name)
          Set the label for the field in which the name is entered.
 void setOKText(java.lang.String ok)
          Set the label on the OK button.
 void setPass(java.lang.String pass)
          Set the password that appears as the default An empty string will be used if this in not specified before the dialog is displayed.
 void setPassLabel(java.lang.String pass)
          Set the label for the field in which the password is entered.
 boolean showDialog()
          Shows the dialog and returns true if the user pressed ok.
 
Methods inherited from class javax.swing.JDialog
addImpl, createRootPane, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getGraphics, getJMenuBar, getLayeredPane, getRootPane, getTransferHandler, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, repaint, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, setTransferHandler, update
 
Methods inherited from class java.awt.Dialog
addNotify, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setModal, setModalityType, setResizable, setTitle, setUndecorated, setVisible, show, toBack
 
Methods inherited from class java.awt.Window
addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOwnedWindows, getOwner, getOwnerlessWindows, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isShowing, pack, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, toFront
 
Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusDownCycle, validate, validateTree
 
Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, setBackground, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocation, setLocation, setMaximumSize, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

labels

protected java.util.ResourceBundle labels
Locale specific strings displayed to the user.

Since:
ostermillerutils 1.00.00

name

protected javax.swing.JTextField name
Where the name is typed.

Since:
ostermillerutils 1.00.00

pass

protected javax.swing.JPasswordField pass
Where the password is typed.

Since:
ostermillerutils 1.00.00

okButton

protected javax.swing.JButton okButton
The OK button.

Since:
ostermillerutils 1.00.00

cancelButton

protected javax.swing.JButton cancelButton
The cancel button.

Since:
ostermillerutils 1.00.00

nameLabel

protected javax.swing.JLabel nameLabel
The label for the field in which the name is typed.

Since:
ostermillerutils 1.00.00

passLabel

protected javax.swing.JLabel passLabel
The label for the field in which the password is typed.

Since:
ostermillerutils 1.00.00
Constructor Detail

PasswordDialog

public PasswordDialog(java.awt.Frame parent,
                      java.lang.String title)
Create this dialog with the given parent and title.

Parameters:
parent - window from which this dialog is launched
title - the title for the dialog box window
Since:
ostermillerutils 1.00.00

PasswordDialog

public PasswordDialog(java.awt.Frame parent)
Create this dialog with the given parent and the default title.

Parameters:
parent - window from which this dialog is launched
Since:
ostermillerutils 1.00.00

PasswordDialog

public PasswordDialog()
Create this dialog with the default title.

Since:
ostermillerutils 1.00.00
Method Detail

setLocale

public void setLocale(java.util.Locale locale)
Set the locale used for getting localized strings.

Overrides:
setLocale in class java.awt.Component
Parameters:
locale - Locale used to for i18n.
Since:
ostermillerutils 1.00.00

setName

public void setName(java.lang.String name)
Set the name that appears as the default An empty string will be used if this in not specified before the dialog is displayed.

Overrides:
setName in class java.awt.Component
Parameters:
name - default name to be displayed.
Since:
ostermillerutils 1.00.00

setPass

public void setPass(java.lang.String pass)
Set the password that appears as the default An empty string will be used if this in not specified before the dialog is displayed.

Parameters:
pass - default password to be displayed.
Since:
ostermillerutils 1.00.00

setOKText

public void setOKText(java.lang.String ok)
Set the label on the OK button. The default is a localized string.

Parameters:
ok - label for the ok button.
Since:
ostermillerutils 1.00.00

setCancelText

public void setCancelText(java.lang.String cancel)
Set the label on the cancel button. The default is a localized string.

Parameters:
cancel - label for the cancel button.
Since:
ostermillerutils 1.00.00

setNameLabel

public void setNameLabel(java.lang.String name)
Set the label for the field in which the name is entered. The default is a localized string.

Parameters:
name - label for the name field.
Since:
ostermillerutils 1.00.00

setPassLabel

public void setPassLabel(java.lang.String pass)
Set the label for the field in which the password is entered. The default is a localized string.

Parameters:
pass - label for the password field.
Since:
ostermillerutils 1.00.00

getName

public java.lang.String getName()
Get the name that was entered into the dialog before the dialog was closed.

Overrides:
getName in class java.awt.Component
Returns:
the name from the name field.
Since:
ostermillerutils 1.00.00

getPass

public java.lang.String getPass()
Get the password that was entered into the dialog before the dialog was closed.

Returns:
the password from the password field.
Since:
ostermillerutils 1.00.00

okPressed

public boolean okPressed()
Finds out if user used the OK button or an equivalent action to close the dialog. Pressing enter in the password field may be the same as 'OK' but closing the dialog and pressing the cancel button are not.

Returns:
true if the the user hit OK, false if the user canceled.
Since:
ostermillerutils 1.00.00

dialogInit

protected void dialogInit()
Called by constructors to initialize the dialog.

Overrides:
dialogInit in class javax.swing.JDialog
Since:
ostermillerutils 1.00.00

showDialog

public boolean showDialog()
Shows the dialog and returns true if the user pressed ok.

Returns:
true if the the user hit OK, false if the user canceled.
Since:
ostermillerutils 1.00.00