モジュール java.desktop

パッケージ 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

すべての実装されたインタフェース:

ImageObserver, MenuContainer, Serializable, Accessible, Scrollable, SwingConstants

@JavaBean(description="Allows the editing of a line of text but doesn\'t show the characters.") public class JPasswordField extends JTextField

JPasswordFieldは、1行のテキストの編集を可能にする軽量コンポーネントです。何かが入力されたことはビューに示されますが、元の文字は表示されません。 詳細や使用例は、「The Java Tutorial」の「How to Use Text Fields」を参照してください。

JPasswordFieldは、echoCharのセットとともに使用されるjava.awt.TextFieldとのソース互換のために用意されています。 個別に提供されているのは、パスワードの入力に影響を与えることなしに、JTextFieldのUIを安全に、および簡単に変更できるようにするためです。

ノート: デフォルトでは、JPasswordFieldはインプット・メソッドを無効にします。そうでない場合、入力文字はインプット・メソッドを使用して構成されている間に可視だった可能性があります。 アプリケーションでインプット・メソッドのサポートが必要な場合は、継承されたenableInputMethods(true)メソッドを使用してください。

警告: JPasswordFieldは、入力された元の文字ではなく、代替テキストまたはグラフィックを表示しません。 ただし、システム・メモリーにパスワードが表示されないわけではありません。 パスワード・テキストなどの機密情報の処理については、「安全なコーディング・ガイドライン」の関連セクションを参照してください。

警告: Swingはスレッドに対して安全ではありません。 詳細は、「Swing's Threading Policy」を参照してください。

警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースと互換ではなくなる予定です。 現在の直列化のサポートは、短期間の格納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。 1.4では、すべてのJavaBeansの長期ストレージのサポートがjava.beansパッケージに追加されました。 XMLEncoderを参照してください。

導入されたバージョン:

1.2

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラス	説明
protected class	JPasswordField.AccessibleJPasswordField	このクラスはJPasswordFieldクラスのアクセシビリティ・サポートを実装しています。

クラスjavax.swing.JTextFieldで宣言されたネストされたクラス/インタフェース

JTextField.AccessibleJTextField

クラスjavax.swing.text.JTextComponentで宣言されたネストされたクラス/インタフェース

JTextComponent.AccessibleJTextComponent, JTextComponent.DropLocation, JTextComponent.KeyBinding

クラスjavax.swing.JComponentで宣言されたネストされたクラス/インタフェース

JComponent.AccessibleJComponent

クラスjava.awt.Containerで宣言されたネストされたクラス/インタフェース

Container.AccessibleAWTContainer

クラスjava.awt.Componentで宣言されたネストされたクラス/インタフェース

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

フィールドのサマリー

クラスjavax.swing.JTextFieldで宣言されたフィールド

notifyAction

クラスjavax.swing.text.JTextComponentで宣言されたフィールド

DEFAULT_KEYMAP, FOCUS_ACCELERATOR_KEY

クラスjavax.swing.JComponentで宣言されたフィールド

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

クラスjava.awt.Componentで宣言されたフィールド

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

インタフェースjava.awt.image.ImageObserverで宣言されているフィールド

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

インタフェースjavax.swing.SwingConstantsで宣言されているフィールド

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
JPasswordField()	新しいJPasswordFieldを構築します。デフォルトのドキュメントを使用し、テキスト文字列はnullで開始します。列の幅は0です。
JPasswordField(int columns)	指定された列数で新規の空のJPasswordFieldを構築します。
JPasswordField(String text)	指定されたテキストで初期化された新しいJPasswordFieldを構築します。
JPasswordField(String text, int columns)	指定されたテキストおよび列で初期化される新規JPasswordFieldを構築します。
JPasswordField(Document doc, String txt, int columns)	指定されたテキスト・ストレージ・モデルと列数を使用する新規のJPasswordFieldを構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
void	copy()	現在のルック・アンド・フィールでprovideErrorFeedbackを呼び出します。通常これは、エラー・ビープ音を起動します。
void	cut()	現在のルック・アンド・フィールでprovideErrorFeedbackを呼び出します。通常これは、エラー・ビープ音を起動します。
boolean	echoCharIsSet()	JPasswordFieldにエコー表示に使用する文字セットが用意されている場合にtrueを返します。
AccessibleContext	getAccessibleContext()	このJPasswordFieldに関連付けられたAccessibleContextを返します。
char	getEchoChar()	エコーに使用する文字を返します。
char[]	getPassword()	このTextComponentに格納されたテキストを返します。
String	getText()	非推奨。 Java 2プラットフォームv1.2以降は、getPasswordに置き換えられています。
String	getText(int offs, int len)	非推奨。 Java 2プラットフォームv1.2以降は、getPasswordに置き換えられています。
String	getUIClassID()	このコンポーネントをレンダリングするL&Fクラスの名前を返します。
protected String	paramString()	このJPasswordFieldの文字列表現を返します。
void	setEchoChar(char c)	JPasswordFieldのエコー文字を設定します。
void	setText(String t)	このTextComponentのテキストに、指定されたテキストを設定します。
void	updateUI()	プラグイン可能なUIを再ロードします。

クラスjavax.swing.JTextFieldで宣言されたメソッド

actionPropertyChanged, addActionListener, configurePropertiesFromAction, createActionPropertyChangeListener, createDefaultModel, fireActionPerformed, getAction, getActionListeners, getActions, getColumns, getColumnWidth, getHorizontalAlignment, getHorizontalVisibility, getPreferredSize, getScrollOffset, isValidateRoot, postActionEvent, removeActionListener, scrollRectToVisible, setAction, setActionCommand, setColumns, setDocument, setFont, setHorizontalAlignment, setScrollOffset

クラスjavax.swing.text.JTextComponentで宣言されたメソッド

addCaretListener, addKeymap, fireCaretUpdate, getCaret, getCaretColor, getCaretListeners, getCaretPosition, getDisabledTextColor, getDocument, getDragEnabled, getDropLocation, getDropMode, getFocusAccelerator, getHighlighter, getInputMethodRequests, getKeymap, getKeymap, getMargin, getNavigationFilter, getPreferredScrollableViewportSize, getPrintable, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getScrollableUnitIncrement, getSelectedText, getSelectedTextColor, getSelectionColor, getSelectionEnd, getSelectionStart, getToolTipText, getUI, isEditable, loadKeymap, modelToView, modelToView2D, moveCaretPosition, paste, print, print, print, read, removeCaretListener, removeKeymap, replaceSelection, restoreComposedText, saveComposedText, select, selectAll, setCaret, setCaretColor, setCaretPosition, setDisabledTextColor, setDragEnabled, setDropMode, setEditable, setFocusAccelerator, setHighlighter, setKeymap, setMargin, setNavigationFilter, setSelectedTextColor, setSelectionColor, setSelectionEnd, setSelectionStart, setUI, viewToModel, viewToModel2D, write

クラスjavax.swing.JComponentで宣言されたメソッド

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

クラスjava.awt.Containerで宣言されたメソッド

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

クラスjava.awt.Componentで宣言されたメソッド

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

クラス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以上。列数を0に設定すると、適切な幅はコンポーネントの実装から自然に得られる値になる

メソッドの詳細

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()

このコンポーネントをレンダリングするL&Fクラスの名前を返します。

オーバーライド:

getUIClassID、クラスJTextField

戻り値:

文字列「PasswordFieldUI」

関連項目:

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

updateUI

public void updateUI()

プラグイン可能なUIを再ロードします。 新しいインタフェースを取得するのに使うキーはgetUIClassID()です。 UIのタイプはTextUIです。invalidateは、UIの設定後に呼び出されます。

オーバーライド:

updateUI、クラスJTextComponent

導入されたバージョン:

1.6

関連項目:

• JComponent.setUI(javax.swing.plaf.ComponentUI)
• UIManager.getLookAndFeel()
• UIManager.getUI(javax.swing.JComponent)

getEchoChar

public char getEchoChar()

エコーに使用する文字を返します。 デフォルトは「*」です。 デフォルトは現在実行中のルック・アンド・フィールによって異なる可能性があります。 たとえば、Metal/Oceanのデフォルトは箇条書きシンボルです。

戻り値:

エコー文字。設定がない場合は0

関連項目:

• setEchoChar(char)
• echoCharIsSet()

setEchoChar

@BeanProperty(bound=false, visualUpdate=true, description="character to display in place of the real characters") public void setEchoChar(char c)

JPasswordFieldのエコー文字を設定します。 インストールされるビューは任意のグラフィック手法を使用してフィールドを表示できるため、これは提案にすぎません。 値0に設定すると、標準のJTextFieldの動作と同様に、テキストが入力したとおりに表示されます。

パラメータ:

c - 表示するエコー文字

関連項目:

• echoCharIsSet()
• getEchoChar()

echoCharIsSet

public boolean echoCharIsSet()

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

戻り値:

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

関連項目:

• setEchoChar(char)
• getEchoChar()

cut

public void cut()

現在のルック・アンド・フィールでprovideErrorFeedbackを呼び出します。通常これは、エラー・ビープ音を起動します。 パスワード・フィールドでは、関連したテキスト・モデル内の現在選択されている範囲をシステム・クリップボードに転送して、モデルからコンテンツを削除するという通常の動作は、受け入れられません。

オーバーライド:

cut、クラスJTextComponent

関連項目:

• Toolkit.getSystemClipboard()
• Clipboard

copy

public void copy()

現在のルック・アンド・フィールでprovideErrorFeedbackを呼び出します。通常これは、エラー・ビープ音を起動します。 パスワード・フィールドでは、関連したテキスト・モデル内の現在選択されている範囲をシステム・クリップボードに転送して、モデルにコンテンツを残すという通常の動作は、受け入れられません。

オーバーライド:

copy、クラスJTextComponent

関連項目:

• Toolkit.getSystemClipboard()
• Clipboard

getText

@Deprecated public String getText()

非推奨。

Java 2プラットフォームv1.2以降は、getPasswordに置き換えられています。

このTextComponentに格納されたテキストを返します。 ベースとなるドキュメントがnullの場合は、NullPointerExceptionを返します。

セキュリティ上の理由から、このメソッドは非推奨です。 代わりに* getPasswordメソッドを使用してください。

オーバーライド:

getText、クラスJTextComponent

戻り値:

テキスト

関連項目:

• JTextComponent.setText(java.lang.String)

getText

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

非推奨。

Java 2プラットフォームv1.2以降は、getPasswordに置き換えられています。

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

セキュリティ上の理由から、このメソッドは非推奨です。 代わりにgetPasswordメソッドを使用してください。

オーバーライド:

getText、クラスJTextComponent

パラメータ:

offs - オフセット>= 0

len - 長さ>= 0

戻り値:

テキスト

例外:

BadLocationException - オフセットまたは長さが無効な場合

setText

@BeanProperty(bound=false, description="the text of this component") public void setText(String t)

クラス: JTextComponentからコピーされた説明

このTextComponentのテキストに、指定されたテキストを設定します。 テキストがnullまたは空の場合は、古いテキストを単に削除する効果があります。 テキストが挿入されたときに結果として得られるキャレット位置は、キャレット・クラスの実装によって決定されます。

テキストはバウンド・プロパティではないため、それが変更されてもPropertyChangeEvent はトリガーされません。 テキストの変更を待機するには、DocumentListenerを使用してください。

オーバーライド:

setText、クラスJTextComponent

パラメータ:

t - 設定する新しいテキスト

関連項目:

• JTextComponent.getText(int, int)
• DefaultCaret

getPassword

@BeanProperty(bound=false) public char[] getPassword()

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

戻り値:

テキスト

paramString

protected String paramString()

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

オーバーライド:

paramString、クラスJTextField

戻り値:

このJPasswordFieldの文字列表現

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()

このJPasswordFieldに関連付けられたAccessibleContextを返します。 パスワード・フィールドの場合、AccessibleContextはAccessibleJPasswordFieldの形式を取ります。 必要に応じて、新しいAccessibleJPasswordFieldインスタンスが作成されます。

定義:

getAccessibleContext、インタフェースAccessible

オーバーライド:

getAccessibleContext、クラスJTextField

戻り値:

このJPasswordFieldのAccessibleContextとして機能するAccessibleJPasswordField