|
Préférences
Moteurs de recherche
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
JavaTM 2 Platform Std. Ed. v1.5.0
javax.swing
|
Nested Class Summary | |
---|---|
protected class |
JTextField.AccessibleJTextField
This class implements accessibility support for the JTextField class. |
Nested classes/interfaces inherited from class javax.swing.text.JTextComponent |
---|
JTextComponent.AccessibleJTextComponent, JTextComponent.KeyBinding |
Nested classes/interfaces inherited from class javax.swing.JComponent |
---|
JComponent.AccessibleJComponent |
Nested classes/interfaces inherited from class java.awt.Container |
---|
Container.AccessibleAWTContainer |
Nested classes/interfaces inherited from class java.awt.Component |
---|
Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy |
Field Summary | |
---|---|
static String |
notifyAction
Name of the action to send notification that the contents of the field have been accepted. |
Fields inherited from class javax.swing.text.JTextComponent |
---|
DEFAULT_KEYMAP, FOCUS_ACCELERATOR_KEY |
Fields inherited from class javax.swing.JComponent |
---|
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW |
Fields inherited from class java.awt.Component |
---|
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT |
Fields inherited from interface 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 |
Fields inherited from interface java.awt.image.ImageObserver |
---|
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH |
Constructor Summary | |
---|---|
JTextField()
Constructs a new TextField . |
|
JTextField(Document doc,
String text,
int columns)
Constructs a new JTextField that uses the given text
storage model and the given number of columns. |
|
JTextField(int columns)
Constructs a new empty TextField with the specified
number of columns. |
|
JTextField(String text)
Constructs a new TextField initialized with the
specified text. |
|
JTextField(String text,
int columns)
Constructs a new TextField initialized with the
specified text and columns. |
Method Summary | |
---|---|
void |
addActionListener(ActionListener l)
Adds the specified action listener to receive action events from this textfield. |
protected void |
configurePropertiesFromAction(Action a)
Factory method which sets the ActionEvent
source's properties according to values from the
Action instance. |
protected PropertyChangeListener |
createActionPropertyChangeListener(Action a)
Factory method which creates the PropertyChangeListener
used to update the ActionEvent source as
properties change on its Action instance. |
protected Document |
createDefaultModel()
Creates the default implementation of the model to be used at construction if one isn't explicitly given. |
protected void |
fireActionPerformed()
Notifies all listeners that have registered interest for notification on this event type. |
AccessibleContext |
getAccessibleContext()
Gets the AccessibleContext associated with this
JTextField . |
Action |
getAction()
Returns the currently set Action for this
ActionEvent source, or null
if no Action is set. |
ActionListener[] |
getActionListeners()
Returns an array of all the ActionListener s added
to this JTextField with addActionListener(). |
Action[] |
getActions()
Fetches the command list for the editor. |
int |
getColumns()
Returns the number of columns in this TextField . |
protected int |
getColumnWidth()
Returns the column width. |
int |
getHorizontalAlignment()
Returns the horizontal alignment of the text. |
BoundedRangeModel |
getHorizontalVisibility()
Gets the visibility of the text field. |
Dimension |
getPreferredSize()
Returns the preferred size Dimensions needed for this
TextField . |
int |
getScrollOffset()
Gets the scroll offset, in pixels. |
String |
getUIClassID()
Gets the class ID for a UI. |
boolean |
isValidateRoot()
Calls to revalidate that come from within the
textfield itself will
be handled by validating the textfield, unless the textfield
is contained within a JViewport ,
in which case this returns false. |
protected String |
paramString()
Returns a string representation of this JTextField . |
void |
postActionEvent()
Processes action events occurring on this textfield by dispatching them to any registered ActionListener objects. |
void |
removeActionListener(ActionListener l)
Removes the specified action listener so that it no longer receives action events from this textfield. |
void |
scrollRectToVisible(Rectangle r)
Scrolls the field left or right. |
void |
setAction(Action a)
Sets the Action for the ActionEvent source. |
void |
setActionCommand(String command)
Sets the command string used for action events. |
void |
setColumns(int columns)
Sets the number of columns in this TextField ,
and then invalidate the layout. |
void |
setDocument(Document doc)
Associates the editor with a text document. |
void |
setFont(Font f)
Sets the current font. |
void |
setHorizontalAlignment(int alignment)
Sets the horizontal alignment of the text. |
void |
setScrollOffset(int scrollOffset)
Sets the scroll offset, in pixels. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
public static final String notifyAction
Constructor Detail |
---|
public JTextField()
TextField
. A default model is created,
the initial string is null
,
and the number of columns is set to 0.
public JTextField(String text)
TextField
initialized with the
specified text. A default model is created and the number of
columns is 0.
text
- the text to be displayed, or null
public JTextField(int columns)
TextField
with the specified
number of columns.
A default model is created and the initial string is set to
null
.
columns
- the number of columns to use to calculate
the preferred width; if columns is set to zero, the
preferred width will be whatever naturally results from
the component implementationpublic JTextField(String text, int columns)
TextField
initialized with the
specified text and columns. A default model is created.
text
- the text to be displayed, or null
columns
- the number of columns to use to calculate
the preferred width; if columns is set to zero, the
preferred width will be whatever naturally results from
the component implementationpublic JTextField(Document doc, String text, int columns)
JTextField
that uses the given text
storage model and the given number of columns.
This is the constructor through which the other constructors feed.
If the document is null
, a default model is created.
doc
- the text storage to use; if this is null
,
a default will be provided by calling the
createDefaultModel
methodtext
- the initial string to display, or null
columns
- the number of columns to use to calculate
the preferred width >= 0; if columns
is set to zero, the preferred width will be whatever
naturally results from the component implementation
IllegalArgumentException
- if columns
< 0Method Detail |
---|
public String getUIClassID()
getUIClassID
in class JComponent
JComponent.getUIClassID()
,
UIDefaults.getUI(javax.swing.JComponent)
public void setDocument(Document doc)
setDocument
in class JTextComponent
doc
- the document to display/editJTextComponent.getDocument()
public boolean isValidateRoot()
revalidate
that come from within the
textfield itself will
be handled by validating the textfield, unless the textfield
is contained within a JViewport
,
in which case this returns false.
isValidateRoot
in class JComponent
JViewPort
return false, otherwise return trueJComponent.revalidate()
,
JComponent.isValidateRoot()
public int getHorizontalAlignment()
JTextField.LEFT
JTextField.CENTER
JTextField.RIGHT
JTextField.LEADING
JTextField.TRAILING
public void setHorizontalAlignment(int alignment)
JTextField.LEFT
JTextField.CENTER
JTextField.RIGHT
JTextField.LEADING
JTextField.TRAILING
invalidate
and repaint
are called when the
alignment is set,
and a PropertyChange
event ("horizontalAlignment") is fired.
alignment
- the alignment
IllegalArgumentException
- if alignment
is not a valid keyprotected Document createDefaultModel()
PlainDocument
is returned.
public int getColumns()
TextField
.
public void setColumns(int columns)
TextField
,
and then invalidate the layout.
columns
- the number of columns >= 0
IllegalArgumentException
- if columns
is less than 0protected int getColumnWidth()
public Dimension getPreferredSize()
Dimensions
needed for this
TextField
. If a non-zero number of columns has been
set, the width is set to the columns multiplied by
the column width.
getPreferredSize
in class JComponent
JComponent.setPreferredSize(java.awt.Dimension)
,
ComponentUI
public void setFont(Font f)
revalidate
is called after setting the font.
setFont
in class JComponent
f
- the new fontComponent.getFont()
public void addActionListener(ActionListener l)
l
- the action listener to be addedpublic void removeActionListener(ActionListener l)
l
- the action listener to be removedpublic ActionListener[] getActionListeners()
ActionListener
s added
to this JTextField with addActionListener().
ActionListener
s added or an empty
array if no listeners have been addedprotected void fireActionPerformed()
EventListenerList
public void setActionCommand(String command)
command
- the command stringpublic void setAction(Action a)
Action
for the ActionEvent
source.
The new Action
replaces
any previously set Action
but does not affect
ActionListeners
independently
added with addActionListener
.
If the Action
is already a registered
ActionListener
for the ActionEvent
source, it is not re-registered.
A side-effect of setting the Action
is that the
ActionEvent
source's properties
are immediately set from the values in the Action
(performed by the method configurePropertiesFromAction
)
and subsequently updated as the Action
's
properties change (via a PropertyChangeListener
created by the method createActionPropertyChangeListener
.
a
- the Action
for the JTextField
,
or null
Action
,
getAction()
,
configurePropertiesFromAction(javax.swing.Action)
,
createActionPropertyChangeListener(javax.swing.Action)
public Action getAction()
Action
for this
ActionEvent
source, or null
if no Action
is set.
Action
for this ActionEvent
source,
or null
Action
,
setAction(javax.swing.Action)
protected void configurePropertiesFromAction(Action a)
ActionEvent
source's properties according to values from the
Action
instance. The properties
which are set may differ for subclasses.
By default, the properties which get set are
Enabled
and ToolTipText
.
a
- the Action
from which to get the properties,
or null
Action
,
setAction(javax.swing.Action)
protected PropertyChangeListener createActionPropertyChangeListener(Action a)
PropertyChangeListener
used to update the ActionEvent
source as
properties change on its Action
instance.
Subclasses may override this in order to provide their own
PropertyChangeListener
if the set of
properties which should be kept up to date differs from the
default properties (Text, Enabled, ToolTipText).
Note that PropertyChangeListeners
should avoid holding
strong references to the ActionEvent
source,
as this may hinder garbage collection of the
ActionEvent
source and all components
in its containment hierarchy.
a
- the Action
from which to get the properties,
or null
Action
,
setAction(javax.swing.Action)
public Action[] getActions()
getActions
in class JTextComponent
public void postActionEvent()
ActionListener
objects.
This is normally called by the controller registered with
textfield.
public BoundedRangeModel getHorizontalVisibility()
The fields look-and-feel implementation manages
the values of the minimum, maximum, and extent
properties on the BoundedRangeModel
.
BoundedRangeModel
public int getScrollOffset()
public void setScrollOffset(int scrollOffset)
scrollOffset
- the offset >= 0public void scrollRectToVisible(Rectangle r)
scrollRectToVisible
in class JComponent
r
- the region to scrollJViewport
protected String paramString()
JTextField
.
This method is intended to be used only for debugging purposes,
and the content and format of the returned string may vary between
implementations. The returned string may be empty but may not
be null
.
paramString
in class JTextComponent
JTextField
public AccessibleContext getAccessibleContext()
AccessibleContext
associated with this
JTextField
. For JTextFields
,
the AccessibleContext
takes the form of an
AccessibleJTextField
.
A new AccessibleJTextField
instance is created
if necessary.
getAccessibleContext
in interface Accessible
getAccessibleContext
in class JTextComponent
AccessibleJTextField
that serves as the
AccessibleContext
of this JTextField