字段详细信息

• notifyAction

  public static final String notifyAction

  要发送通知的字段内容已被接受的操作的名称。 通常，这必然是回车。

  另请参见：

  常数字段值

构造方法详细信息

• JTextField

  public JTextField()

  构造一个新的TextField 。 创建默认模型，初始字符串为null ，列数设置为0。

• JTextField

  public JTextField​(String text)

  构造一个使用指定文本初始化的新TextField 。 将创建默认模型，列数为0。

  参数

  text - 要显示的文本，或 null

• JTextField

  public JTextField​(int columns)

  构造具有指定列数的新空TextField 。 将创建默认模型，并将初始字符串设置为null 。

  参数

  columns - 用于计算首选宽度的列数; 如果列设置为零，则首选宽度将是组件实现自然产生的任何宽度

• JTextField

  public JTextField​(String text,
                    int columns)

  构造一个使用指定文本和列初始化的新TextField 。 创建默认模型。

  参数

  text - 要显示的文本，或 null

  columns - 用于计算首选宽度的列数; 如果列设置为零，则首选宽度将是组件实现自然产生的任何宽度

• JTextField

  public JTextField​(Document doc,
                    String text,
                    int columns)

  构造一个新的JTextField ，它使用给定的文本存储模型和给定的列数。 这是其他构造函数通过其提供的构造函数。 如果文档是null ，则创建默认模型。

  参数

  doc - 要使用的文本存储; 如果这是null ，则通过调用createDefaultModel方法提供默认值

  text - 要显示的初始字符串，或 null

  columns - 用于计算首选宽度的列数> = 0; 如果columns设置为零，则首选宽度将是组件实现自然产生的任何宽度

  异常

  IllegalArgumentException - 如果 columns <0

方法详细信息

• getUIClassID

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

  获取UI的类ID。

  重写：

  getUIClassID在类 JComponent

  结果

  字符串“TextFieldUI”

  另请参见：

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

• setDocument

  @BeanProperty(expert=true,
                description="the text document model")
  public void setDocument​(Document doc)

  将编辑器与文本文档关联。 当前注册的工厂用于构建文档的视图，在重新验证后由编辑器显示。 PropertyChange事件（“document”）传播到每个侦听器。

  重写：

  setDocument在类 JTextComponent

  参数

  doc - 要显示/编辑的文档

  另请参见：

  JTextComponent.getDocument()

• isValidateRoot

  public boolean isValidateRoot()

  来自文本字段内的 revalidate调用将通过验证文本字段来处理，除非文本字段包含在 JViewport ，在这种情况下，它返回false。

  重写：

  isValidateRoot在类 JComponent

  结果

  如果此textfield的父级是 JViewPort返回false，否则返回true

  另请参见：

  JComponent.revalidate() ， JComponent.isValidateRoot() ， Container.isValidateRoot()

• getHorizontalAlignment

  public int getHorizontalAlignment()

  返回文本的水平对齐方式。 有效密钥是：

  • JTextField.LEFT
  • JTextField.CENTER
  • JTextField.RIGHT
  • JTextField.LEADING
  • JTextField.TRAILING

  结果

  水平对齐

• setHorizontalAlignment

  @BeanProperty(preferred=true,
                enumerationValues={"JTextField.LEFT","JTextField.CENTER","JTextField.RIGHT","JTextField.LEADING","JTextField.TRAILING"},
                description="Set the field alignment to LEFT, CENTER, RIGHT, LEADING (the default) or TRAILING")
  public void setHorizontalAlignment​(int alignment)

  设置文本的水平对齐方式。 有效密钥是：

  • JTextField.LEFT
  • JTextField.CENTER
  • JTextField.RIGHT
  • JTextField.LEADING
  • JTextField.TRAILING

  设置对齐时将调用invalidate和repaint ，并PropertyChange事件（“horizontalAlignment”）。

  参数

  alignment - 对齐方式

  异常

  IllegalArgumentException - 如果 alignment不是有效密钥

• createDefaultModel

  protected Document createDefaultModel()

  如果没有明确给出，则创建要在构造中使用的模型的默认实现。 返回PlainDocument的实例。

  结果

  默认的模型实现

• getColumns

  public int getColumns()

  返回此 TextField的列数。

  结果

  列数> = 0

• setColumns

  @BeanProperty(bound=false,
                description="the number of columns preferred for display")
  public void setColumns​(int columns)

  设置此 TextField的列数，然后使布局无效。

  参数

  columns - 列数> = 0

  异常

  IllegalArgumentException - 如果 columns小于0

• getColumnWidth

  protected int getColumnWidth()

  返回列宽。 对于某些字体，列的含义可以被认为是相当弱的概念。 此方法用于定义列的宽度。 默认情况下，它被定义为所用字体的字符m的宽度。 可以将此方法重新定义为某个替代数量

  结果

  列宽> = 1

• getPreferredSize

  public Dimension getPreferredSize()

  返回此Dimensions所需的首选大小TextField 。 如果已设置非零数量的列，则将宽度设置为列乘以列宽。

  重写：

  getPreferredSize在类 JComponent

  结果

  这个文本域的维度

  另请参见：

  JComponent.setPreferredSize(java.awt.Dimension) ， ComponentUI

• setFont

  public void setFont​(Font f)

  设置当前字体。 这将删除缓存的行高和列宽，以便反映新字体。 设置字体后调用revalidate 。

  重写：

  setFont在类 JComponent

  参数

  f - 新字体

  另请参见：

  Component.getFont()

• addActionListener

  public void addActionListener​(ActionListener l)

  添加指定的操作侦听器以从此文本字段接收操作事件。

  参数

  l - 要添加的动作侦听器

• removeActionListener

  public void removeActionListener​(ActionListener l)

  删除指定的操作侦听器，以便它不再从此文本字段接收操作事件。

  参数

  l - 要删除的动作侦听器

• getActionListeners

  @BeanProperty(bound=false)
  public ActionListener[] getActionListeners()

  返回使用addActionListener（）添加到此JTextField的所有 ActionListener的数组。

  结果

  添加了所有 ActionListener或如果没有添加侦听器则为空数组

  从以下版本开始：

  1.4

• fireActionPerformed

  protected void fireActionPerformed()

  通知所有已注册对此事件类型的通知感兴趣的听众。 事件实例是懒惰创建的。 侦听器列表按最后一个顺序处理。

  另请参见：

  EventListenerList

• setActionCommand

  public void setActionCommand​(String command)

  设置用于操作事件的命令字符串。

  参数

  command - 命令字符串

• setAction

  @BeanProperty(visualUpdate=true,
                description="the Action instance connected with this ActionEvent source")
  public void setAction​(Action a)

  设置Action为ActionEvent源。 新的Action取代之前设置的任何Action但不影响ActionListeners独立添加addActionListener 。 如果Action已经是ActionEvent源的注册ActionListener ，则不会重新注册。

  设置Action结果立即改变中描述的所有属性Swing Components Supporting Action 。 随后，当Action的属性发生变化时，文本字段的属性会自动更新。

  此方法使用其他三种方法来设置和帮助跟踪Action的属性值。 它使用configurePropertiesFromAction方法立即更改文本字段的属性。 要跟踪Action属性值中的更改，此方法将注册PropertyChangeListener返回的createActionPropertyChangeListener 。 默认PropertyChangeListener调用actionPropertyChanged方法时的属性Action变化。

  参数

  a - Action的 JTextField或 null

  从以下版本开始：

  1.3

  另请参见：

  Action ， getAction() ， configurePropertiesFromAction(javax.swing.Action) ， createActionPropertyChangeListener(javax.swing.Action) ， actionPropertyChanged(javax.swing.Action, java.lang.String)

• getAction

  public Action getAction()

  返回当前设置的 Action这个 ActionEvent来源，或 null如果没有 Action设置。

  结果

  Action用于此 ActionEvent源，或 null

  从以下版本开始：

  1.3

  另请参见：

  Action ， setAction(javax.swing.Action)

• configurePropertiesFromAction

  protected void configurePropertiesFromAction​(Action a)

  设置此文本字段上的属性以匹配指定的Action中的Action 。 有关此设置的属性的详细信息，请参阅Swing Components Supporting Action 。

  参数

  a - 从 Action获取房产，或 null

  从以下版本开始：

  1.3

  另请参见：

  Action ， setAction(javax.swing.Action)

• actionPropertyChanged

  protected void actionPropertyChanged​(Action action,
                                       String propertyName)

  更新文本字段的状态以响应关联操作中的属性更改。 从PropertyChangeListener返回的createActionPropertyChangeListener调用此方法。 子类通常不需要调用它。 支持其他Action属性的子类应覆盖此和configurePropertiesFromAction 。

  有关此方法设置的属性列表，请参阅表Swing Components Supporting Action 。

  参数

  action - 与 Action本 Action关联的 Action

  propertyName - 已更改的属性的名称

  从以下版本开始：

  1.6

  另请参见：

  Action ， configurePropertiesFromAction(javax.swing.Action)

• createActionPropertyChangeListener

  protected PropertyChangeListener createActionPropertyChangeListener​(Action a)

  创建并返回一个PropertyChangeListener ，负责监听指定的Action更改并更新相应的属性。

  警告：如果你是子类，则不要创建匿名内部类。 如果你这样做，文本字段的生命周期将与Action的生命周期相关Action 。

  参数

  a - 文本字段的操作

  结果

  PropertyChangeListener ，负责监听指定的 Action更改并更新相应的属性

  从以下版本开始：

  1.3

  另请参见：

  Action ， setAction(javax.swing.Action)

• getActions

  @BeanProperty(bound=false)
  public Action[] getActions()

  获取编辑器的命令列表。 这是插件UI支持的命令列表，由编辑器本身支持的命令集合增强。 这些对于绑定事件很有用，例如在键映射中。

  重写：

  getActions在类 JTextComponent

  结果

  命令列表

• postActionEvent

  public void postActionEvent()

  处理在此文本字段上发生的操作事件，方法是将它们分派给任何已注册的ActionListener对象。 这通常由注册了textfield的控制器调用。

• getHorizontalVisibility

  @BeanProperty(bound=false)
  public BoundedRangeModel getHorizontalVisibility()

  获取文本字段的可见性。 如果字段的大小大于分配给字段的区域，则可以调整此值以更改可见区域的位置。

  字段外观实现管理BoundedRangeModel上的最小值，最大值和范围属性的BoundedRangeModel 。

  结果

  能见度

  另请参见：

  BoundedRangeModel

• getScrollOffset

  public int getScrollOffset()

  获取滚动偏移量（以像素为单位）。

  结果

  偏移> = 0

• setScrollOffset

  public void setScrollOffset​(int scrollOffset)

  设置滚动偏移（以像素为单位）。

  参数

  scrollOffset - 偏移量> = 0

• scrollRectToVisible

  public void scrollRectToVisible​(Rectangle r)

  向左或向右滚动字段。

  重写：

  scrollRectToVisible在类 JComponent

  参数

  r - 要滚动的区域

  另请参见：

  JViewport

• paramString

  protected String paramString()

  返回此JTextField的字符串表示JTextField 。 此方法仅用于调试目的，返回字符串的内容和格式可能因实现而异。 返回的字符串可能为空，但可能不是null 。

  重写：

  paramString在类 JTextComponent

  结果

  此 JTextField的字符串表示 JTextField

• getAccessibleContext

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

  获取AccessibleContext与此相关JTextField 。 为JTextFields ，所述AccessibleContext需要一个的形式AccessibleJTextField 。 如有必要，将创建一个新的AccessibleJTextField实例。

  Specified by:

  getAccessibleContext ，界面 Accessible

  重写：

  getAccessibleContext在类 JTextComponent

  结果

  an AccessibleJTextField that serves as the AccessibleContext of this JTextField