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
- すべての実装インタフェース:
- Accessible, ImageObserver, MenuContainer, Scrollable, Serializable, SwingConstants
- public class JPasswordField
- extends JTextField
JPasswordField は、1 行のテキストの編集を可能にする、軽量コンポーネントです。ただし、ビューは入力があったことを示しますが、どの文字が入力されたかは表示しません。詳細や使用例については、「The Java Tutorial」の「How to Use Text Fields」を参照してください。
JPasswordField は、echoChar のセットとともに使われる java.awt.TextField とのソース互換のために用意されています。個別に提供されているのは、パスワードの入力に影響を与えることなしに、JTextField の UI を安全に、および簡単に変更できるようにするためです。
標準の Look & Feel (L&F) 表現でこのコンポーネントが使用するキーボードのキーについては、JPasswordField のキーの割り当てを参照してください。
警告:
このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。
- 関連項目:
- 直列化された形式
インタフェース javax.swing.SwingConstants から継承したフィールド |
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NORTH, NORTH_EAST, NORTH_WEST, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST |
メソッドの概要 |
void |
copy()
関連したテキストモデル内の現在選択されている領域をシステムクリップボードに転送して、テキストモデルからコンテンツをそのまま残します。 |
void |
cut()
関連したテキストモデル内の現在選択されている領域をシステムクリップボードに転送して、モデルからコンテンツを削除します。 |
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 にエコー文字を設定します。 |
クラス javax.swing.JTextField から継承したメソッド |
addActionListener, configurePropertiesFromAction, createActionPropertyChangeListener, createDefaultModel, fireActionPerformed, getAction, getActions, getColumns, getColumnWidth, getHorizontalAlignment, getHorizontalVisibility, getPreferredSize, getScrollOffset, isValidateRoot, postActionEvent, removeActionListener, scrollRectToVisible, setAction, setActionCommand, setColumns, setFont, setHorizontalAlignment, setScrollOffset |
クラス javax.swing.text.JTextComponent から継承したメソッド |
addCaretListener, addInputMethodListener, addKeymap, fireCaretUpdate, getCaret, getCaretColor, getCaretPosition, getDisabledTextColor, getDocument, getFocusAccelerator, getHighlighter, getInputMethodRequests, getKeymap, getKeymap, getMargin, getPreferredScrollableViewportSize, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getScrollableUnitIncrement, getSelectedText, getSelectedTextColor, getSelectionColor, getSelectionEnd, getSelectionStart, getUI, isEditable, isFocusTraversable, loadKeymap, modelToView, moveCaretPosition, paste, processInputMethodEvent, read, removeCaretListener, removeKeymap, removeNotify, replaceSelection, select, selectAll, setCaret, setCaretColor, setCaretPosition, setDisabledTextColor, setDocument, setEditable, setFocusAccelerator, setHighlighter, setKeymap, setMargin, setSelectedTextColor, setSelectionColor, setSelectionEnd, setSelectionStart, setText, setUI, updateUI, viewToModel, write |
クラス javax.swing.JComponent から継承したメソッド |
addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getVerifyInputWhenFocusTarget, getVisibleRect, getWidth, getX, getY, grabFocus, hasFocus, hide, isDoubleBuffered, isFocusCycleRoot, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processFocusEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, resetKeyboardActions, reshape, revalidate, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDoubleBuffered, setEnabled, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setUI, setVerifyInputWhenFocusTarget, 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, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setLayout, validate, validateTree |
クラス java.awt.Component から継承したメソッド |
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addKeyListener, addMouseListener, addMouseMotionListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getInputContext, getLocale, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, 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, processComponentEvent, processHierarchyBoundsEvent, processHierarchyEvent, processMouseEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus |
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
- 表示されるテキスト。ない場合は nullcolumns
- 列数 >= 0
JPasswordField
public JPasswordField(Document doc,
String txt,
int columns)
- 指定されたテキストストレージモデルと列数を使って新規の JPasswordField を構築します。これは、ほかのコンストラクタが入力するコンストラクタです。エコー文字は「*」に設定されます。ドキュメントが null の場合はデフォルトモデルが作成されます。
- パラメータ:
doc
- 使用するテキストストレージtxt
- 表示されるテキスト。ない場合は nullcolumns
- 望ましい幅を計算するのに使う列数 >= 0。列数をゼロに設定すると、コンポーネント実装から自然に得られる結果を問わず望ましい幅になる
getUIClassID
public String getUIClassID()
- このコンポーネントを描画する L&F クラスの名前を返します。
- オーバーライド:
- クラス
JTextField
内の getUIClassID
- 戻り値:
- PasswordFieldUI
- 関連項目:
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()
- 推奨されていません。 Java 2 プラットフォーム v1.2 以降、
getPassword()
に置き換えられました。
- この TextComponent に格納されたテキストを返します。基本となるドキュメントが null の場合は、NullPointerException を返します。
セキュリティ上の理由から、このメソッドは推奨されません。代わりに getPassword メソッドを使用してください。
- オーバーライド:
- クラス
JTextComponent
内の getText
- 戻り値:
- テキスト
getText
public String getText(int offs,
int len)
throws BadLocationException
- 推奨されていません。 Java 2 プラットフォーム v1.2 以降、
getPassword()
に置き換えられました。
- コンポーネントが表すテキストの一部を取り出します。長さが 0 の場合は、空の文字列を返します。
セキュリティ上の理由から、このメソッドは推奨されません。代わりに getPassword メソッドを使用してください。
- オーバーライド:
- クラス
JTextComponent
内の getText
- パラメータ:
offs
- オフセット >= 0len
- 長さ >= 0- 戻り値:
- テキスト
- 例外:
BadLocationException
- オフセットまたは長さが無効な場合
getPassword
public char[] getPassword()
- TextComponent 内に格納されているテキストを返します。基本となるドキュメントが null の場合は、NullPointerException を返します。セキュリティ強化のために、返された文字の配列を使用したあとは、各文字をゼロに設定してクリアすることをお勧めします。
- 戻り値:
- テキスト
paramString
protected String paramString()
- この JPasswordField の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、
null
にはなりません。
- オーバーライド:
- クラス
JTextField
内の paramString
- 戻り値:
- この JPasswordField の文字列表現
getAccessibleContext
public AccessibleContext getAccessibleContext()
- この JPasswordField に関連した AccessibleContext を返します。パスワードフィールドの場合、AccessibleContext は AccessibleJPasswordField の形式を取ります。新規の AccessibleJPasswordField インスタンスが必要に応じて作成されます。
- オーバーライド:
- クラス
JTextField
内の getAccessibleContext
- 戻り値:
- この JPasswordField の AccessibleContext として機能する AccessibleJPasswordField
バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。 Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.