javax.swing
クラス JPasswordField

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--javax.swing.JComponent
                    |
                    +--javax.swing.text.JTextComponent
                          |
                          +--javax.swing.JTextField
                                |
                                +--javax.swing.JPasswordField

public class JPasswordField

extends JTextField

JPasswordField は、1 行のテキストの編集を可能にする、軽量コンポーネントです。ただし、ビューは入力があったことを表示しますが、どの文字が入力されたかは表示しません。これは、echoChar のセットとともに使われる java.awt.TextField とのソース互換のために用意されています。別個に提供されているのは、パスワードの入力に影響を与えることなしに、JTextField の UI を安全に、および簡単に変更できるようにするためです。

標準の Look & Feel (L&F) 表現でこのコンポーネントが使用するキーボードのキーについては、JPasswordField のキーの割り当てを参照してください。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。

関連項目:

直列化された形式

内部クラスの概要

protected class

JPasswordField.AccessibleJPasswordField オブジェクトのユーザ補助機能を取得するために使用されるクラスです。

クラス javax.swing.JTextField から継承した内部クラス

JTextField.AccessibleJTextField

クラス javax.swing.text.JTextComponent から継承した内部クラス

JTextComponent.AccessibleJTextComponent, JTextComponent.KeyBinding

クラス javax.swing.JComponent から継承した内部クラス

JComponent.AccessibleJComponent

クラス javax.swing.JTextField から継承したフィールド

notifyAction

クラス javax.swing.text.JTextComponent から継承したフィールド

DEFAULT_KEYMAP, FOCUS_ACCELERATOR_KEY

クラス javax.swing.JComponent から継承したフィールド

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

クラス java.awt.Component から継承したフィールド

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

コンストラクタの概要

JPasswordField()
新しい JPasswordField を構築します。

JPasswordField(Document doc, String txt, int columns)
指定されたテキスト記憶モデル、および指定された数のカラムを使用する新しい JPasswordField を構築します。

JPasswordField(int columns)
指定された数のカラムを持つ、新しい空の JPasswordField を構築します。

JPasswordField(String text)
指定したテキストで初期化された、新しい JPasswordField を構築します。

JPasswordField(String text, int columns)
指定されたテキストおよびカラムで初期化された、新しい JPasswordField を構築します。

メソッドの概要

void	copy() 通常は、関連付けられたテキストモデルの現在の選択範囲をシステムのクリップボードに転送し、モデルのコンテンツを残しておきます。
void	cut() 通常は、関連付けられたテキストモデルの現在の選択範囲をシステムのクリップボードに転送したあとで、モデルのコンテンツを削除します。
boolean	echoCharIsSet() エコー表示に使用する文字セットが JPasswordField に用意されている場合に true を返します。
AccessibleContext	getAccessibleContext() JPasswordField に関連付けられた AccessibleContext を取得します。
char	getEchoChar() エコーに使う文字を返します。
char[]	getPassword() TextComponent に含まれるテキストを返します。
String	getText() 推奨されません。 JDK 1.2 で、getPassword() に置き換えられました。
String	getText(int offs, int len) 推奨されません。 JDK 1.2 で、getPassword() に置き換えられました。
String	getUIClassID() コンポーネントを描画する、L&F クラスの名前を返します。
protected String	paramString() この JPasswordField の文字列表現を返します。
void	setEchoChar(char c) JPasswordField のエコー文字を設定します。

クラス javax.swing.JTextField から継承したメソッド

addActionListener, createDefaultModel, fireActionPerformed, getActions, getColumns, getColumnWidth, getHorizontalAlignment, getHorizontalVisibility, getPreferredSize, getScrollOffset, isValidateRoot, postActionEvent, removeActionListener, scrollRectToVisible, setActionCommand, setColumns, setFont, setHorizontalAlignment, setScrollOffset

クラス javax.swing.text.JTextComponent から継承したメソッド

addCaretListener, addKeymap, fireCaretUpdate, getCaret, getCaretColor, getCaretPosition, getDisabledTextColor, getDocument, getFocusAccelerator, getHighlighter, getKeymap, getKeymap, getMargin, getPreferredScrollableViewportSize, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getScrollableUnitIncrement, getSelectedText, getSelectedTextColor, getSelectionColor, getSelectionEnd, getSelectionStart, getUI, isEditable, isFocusTraversable, isOpaque, loadKeymap, modelToView, moveCaretPosition, paste, processComponentKeyEvent, read, removeCaretListener, removeKeymap, removeNotify, replaceSelection, select, selectAll, setCaret, setCaretColor, setCaretPosition, setDisabledTextColor, setDocument, setEditable, setEnabled, setFocusAccelerator, setHighlighter, setKeymap, setMargin, setOpaque, setSelectedTextColor, setSelectionColor, setSelectionEnd, setSelectionStart, setText, setUI, updateUI, viewToModel, write

クラス javax.swing.JComponent から継承したメソッド

addAncestorListener, addNotify, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getAlignmentX, getAlignmentY, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getGraphics, getHeight, getInsets, getInsets, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getVisibleRect, getWidth, getX, getY, grabFocus, hasFocus, isDoubleBuffered, isFocusCycleRoot, isLightweightComponent, isManagingFocus, isOptimizedDrawingEnabled, isPaintingTile, isRequestFocusEnabled, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, processFocusEvent, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, resetKeyboardActions, reshape, revalidate, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDoubleBuffered, setForeground, setMaximumSize, setMinimumSize, setNextFocusableComponent, setPreferredSize, setRequestFocusEnabled, setToolTipText, setUI, setVisible, unregisterKeyboardAction, update

クラス java.awt.Container から継承したメソッド

add, add, add, add, add, addContainerListener, addImpl, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getLayout, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setLayout, validate, validateTree

クラス java.awt.Component から継承したメソッド

action, add, addComponentListener, addFocusListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addPropertyChangeListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getInputContext, getInputMethodRequests, getLocale, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hide, imageUpdate, inside, isDisplayable, isEnabled, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, processComponentEvent, processInputMethodEvent, processMouseEvent, remove, removeComponentListener, removeFocusListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

JPasswordField

public JPasswordField()

新しい JPasswordField を構築します。デフォルトのドキュメントを使用し、テキスト文字列は null で開始します。カラムの幅は 0 です。

JPasswordField

public JPasswordField(String text)

指定したテキストで初期化された、新しい JPasswordField を構築します。ドキュメントモデルはデフォルトに設定され、カラムの数は 0 に設定されます。

パラメータ:

text - 表示されるテキスト。ない場合は null

JPasswordField

public JPasswordField(int columns)

指定された数のカラムを持つ、新しい空の JPasswordField を構築します。デフォルトのモデルが作成され、初期文字列は null に設定されます。

パラメータ:

columns - カラムの数 >= 0

JPasswordField

public JPasswordField(String text,
                      int columns)

指定されたテキストおよびカラムで初期化された、新しい JPasswordField を構築します。ドキュメントモデルはデフォルトに設定されます。

パラメータ:

text - 表示するテキスト。ない場合は null

columns - カラムの数 >= 0

JPasswordField

public JPasswordField(Document doc,
                      String txt,
                      int columns)

指定されたテキスト記憶モデル、および指定された数のカラムを使用する新しい JPasswordField を構築します。このコンストラクタを通じて、他のコンストラクタがフィードを行います。エコー文字は「*」に設定されます。ドキュメントモデルが null である場合は、デフォルトのドキュメントモデルが作成されます。

パラメータ:

doc - 使用するテキスト記憶

txt - 表示するテキスト。ない場合は null

columns - 望ましい幅の計算に使う、カラムの数 >= 0。カラムがゼロに設定されている場合、望ましい幅はコンポーネントの実装に合わせたもの

メソッドの詳細

getUIClassID

public String getUIClassID()

コンポーネントを描画する、L&F クラスの名前を返します。

戻り値:

PasswordFieldUI

オーバーライド:

クラス JTextField 内の getUIClassID

関連項目:

JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

getEchoChar

public char getEchoChar()

エコーに使う文字を返します。デフォルトは「*」です。

戻り値:

エコー文字。設定がない場合は 0 (を返す)

関連項目:

setEchoChar(char), echoCharIsSet()

setEchoChar

public void setEchoChar(char c)

JPasswordField のエコー文字を設定します。このエコー文字は、表示のみに過ぎないという点に注意してください。インストールされるビューは、任意のグラフィックな方法を使ってフィールドを表示できます。値を 0 に設定すると、エコー文字の設定を解除できます。

パラメータ:

c - 表示するエコー文字

関連項目:

echoCharIsSet(), getEchoChar()

echoCharIsSet

public boolean echoCharIsSet()

エコー表示に使用する文字セットが JPasswordField に用意されている場合に true を返します。戻り値が 0 でない場合は、エコー文字が設定されていると解釈されます。

戻り値:

エコー表示に使用する文字が設定されている場合は true

関連項目:

setEchoChar(char), getEchoChar()

cut

public void cut()

通常は、関連付けられたテキストモデルの現在の選択範囲をシステムのクリップボードに転送したあとで、モデルのコンテンツを削除します。パスワードの入力フィールドには不適切な動作なので、実装をやり直してビープ音だけになっています。

オーバーライド:

クラス JTextComponent 内の cut

copy

public void copy()

通常は、関連付けられたテキストモデルの現在の選択範囲をシステムのクリップボードに転送し、モデルのコンテンツを残しておきます。パスワードの入力フィールドには不適切な動作なので、実装をやり直してビープ音だけになっています。

オーバーライド:

クラス JTextComponent 内の copy

getText

public String getText()

推奨されません。 JDK 1.2 で、getPassword() に置き換えられました。

TextComponent に含まれているテキストを返します。目的のドキュメントが null の場合は、NullPointerException をスローします。

セキュリティ上の理由から、このメソッドは推奨されません。代わりに getPassword メソッドを使ってください。

戻り値:

テキスト

オーバーライド:

クラス JTextComponent 内の getText

getText

public String getText(int offs,
                      int len)
               throws BadLocationException

推奨されません。 JDK 1.2 で、getPassword() に置き換えられました。

コンポーネントが表示しているテキストの一部を取得します。長さが 0 の場合は、空の文字列を返します。

セキュリティ上の理由から、このメソッドは推奨されません。代わりに getPassword メソッドを使ってください。

パラメータ:

offs - オフセット >= 0

len - 長さ >= 0

戻り値:

テキスト

例外:

BadLocationException - オフセットあるいは長さが無効な場合

オーバーライド:

クラス JTextComponent 内の getText

getPassword

public char[] getPassword()

TextComponent に含まれるテキストを返します。ドキュメントが null の場合は、NullPointerException を返します。セキュリティ強化のために、返された文字の配列を使用したあとは、各文字をゼロに設定してクリアすることを推奨します。

戻り値:

テキスト

paramString

protected String paramString()

この JPasswordField の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。

JFC コンポーネントの新しい側面についての情報を返すには、paramString() をオーバーライドします。

戻り値:

この JPasswordField の文字列表現

オーバーライド:

クラス JTextField 内の paramString

getAccessibleContext

public AccessibleContext getAccessibleContext()

JPasswordField に関連付けられた AccessibleContext を取得します。必要に応じて、新しいコンテキストが作成されます。

戻り値:

JPasswordField の AccessibleContext

オーバーライド:

クラス JTextField 内の getAccessibleContext