BasicTextUI (Java Platform SE 8 )

java.lang.Object
- javax.swing.plaf.ComponentUI
- - javax.swing.plaf.TextUI
  - - javax.swing.plaf.basic.BasicTextUI

All Implemented Interfaces:

ViewFactory

已知直接子类：

BasicEditorPaneUI， BasicTextAreaUI， BasicTextFieldUI， DefaultTextUI
```
public abstract class BasicTextUI
extends TextUI
implements ViewFactory
```
基础的文本组件的外观和感觉。这提供了基本的编辑视图和控制器的服务可能是有用的当创建一个外观和感觉的JTextComponent延伸。

大多数州举行相关的JTextComponent作为绑定的属性，和UI设置默认值的各种属性。此默认将为所有的属性安装一些东西。通常，一个LAF实施将做更多的但是。至少，一卷一般会安装密钥绑定。

这个类还提供了一些并发支持如果与jtextcomponent相关的Document是AbstractDocument子类。访问视图（或视图）序列化任何线程突变模型和Swing事件线程之间（这是预期的渲染，做模型/视图坐标转换，等）。任何访问根视图应该首先在finally块中获得读锁，锁abstractdocument和释放。

定义的一个重要方法是getPropertyPrefix()方法作为用来取个默认密钥的基础。字符串应反映当类型（如文本、文本，等等）没有名字的一部分（如金属，特别是LAF的母题，等）。

要建立一个视图的模型，可以采用以下策略之一。
1. 一个策略是简单地定义在UI界面的视图工厂。默认情况下，此用户界面本身作为视图实现的工厂。这是有用的简单的工厂。要做到这一create(javax.swing.text.Element)执行方法。
2. 用于创建更复杂的文件类型的一个常见的策略是有editorkit实现回到厂。由于editorkit联系所有必要维持一个类型的文件碎片，工厂通常是重要组成部分，应该由editorkit实施生产。
警告：序列化该类的对象与以后的Swing版本不兼容。当前的序列化支持适用于短期贮藏或RMI运行相同Swing版本的应用程序之间。为1.4，为所有JavaBeans™长期存储的支持已被添加到java.beans包。请看XMLEncoder。

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`BasicTextUI.BasicCaret`
`static class`	`BasicTextUI.BasicHighlighter`

构造方法摘要

构造方法
Constructor and Description
`BasicTextUI()` 创建一个新的用户界面。

方法摘要

所有方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`View`	`create(Element elem)` 为元素创建一个视图。
`View`	`create(Element elem, int p0, int p1)` 为元素创建一个视图。
`protected Caret`	`createCaret()` 创建使用插入对象。
`protected Highlighter`	`createHighlighter()` 创建用于添加亮点的对象。
`protected Keymap`	`createKeymap()` 创造你所使用的文本组件，并安装任何所需的绑定到它。
`void`	`damageRange(JTextComponent tc, int p0, int p1)` 导致负责模型给出的部分重新绘制视图的部分。
`void`	`damageRange(JTextComponent t, int p0, int p1, Position.Bias p0Bias, Position.Bias p1Bias)` 导致负责模型给出的部分重新绘制视图的部分。
`protected JTextComponent`	`getComponent()` 与此相关的文本组件用户界面的实现。
`EditorKit`	`getEditorKit(JTextComponent tc)` 获取用于UI的editorkit。
`protected String`	`getKeymapName()` 取你所要安装这个UI默认使用的名称。
`Dimension`	`getMaximumSize(JComponent c)` 获取编辑器组件的最大大小。
`Dimension`	`getMinimumSize(JComponent c)` 获取编辑器组件的最小大小。
`int`	`getNextVisualPositionFrom(JTextComponent t, int pos, Position.Bias b, int direction, Position.Bias[] biasRet)` 提供了一种方法来确定下一步的直观模型，一个可能的地方插入位置。
`Dimension`	`getPreferredSize(JComponent c)` 获取编辑器组件的首选大小。
`protected abstract String`	`getPropertyPrefix()` 获取用于查找性能的一个关键的名字”。
`View`	`getRootView(JTextComponent tc)` 获取与关联文本组件配置视图（即
`String`	`getToolTipText(JTextComponent t, Point pt)` 返回可在通过定位工具提示字符串。
`protected Rectangle`	`getVisibleEditorRect()` 获取分配给根视图。
`protected void`	`installDefaults()` 初始化组件的属性，如字体、前景、背景、符号的颜色，选择颜色，选择文字颜色，禁用的文本颜色，和边框颜色。
`protected void`	`installKeyboardActions()`
`protected void`	`installListeners()` 为用户界面安装侦听器。
`void`	`installUI(JComponent c)` 安装组件的用户界面。
`protected void`	`modelChanged()` 标志模型变化。
`Rectangle`	`modelToView(JTextComponent tc, int pos)` 将模型中给定的位置转换为视图坐标系中的位置。
`Rectangle`	`modelToView(JTextComponent tc, int pos, Position.Bias bias)` 将模型中给定的位置转换为视图坐标系中的位置。
`void`	`paint(Graphics g, JComponent c)` 绘制界面。
`protected void`	`paintBackground(Graphics g)` 画一个视图的背景。
`protected void`	`paintSafely(Graphics g)` 安全地绘制界面，保证模型不会从这个线程的视图改变。
`protected void`	`propertyChange(PropertyChangeEvent evt)` 该方法被调用时，绑定属性是相关的jtextcomponent改变。
`protected void`	`setView(View v)` 设置视图层次结构的根和电话invalidate()电流。
`protected void`	`uninstallDefaults()` 设置组件的属性尚未明确， `null`。
`protected void`	`uninstallKeyboardActions()`
`protected void`	`uninstallListeners()` 卸载的听众的UI。
`void`	`uninstallUI(JComponent c)` deinstalls为组件的用户界面。
`void`	`update(Graphics g, JComponent c)` 父类涂料背景在不受控制的方式（即
`int`	`viewToModel(JTextComponent tc, Point pt)` 将视图坐标系中的给定位置转换为模型中的最近的有代表性的位置。
`int`	`viewToModel(JTextComponent tc, Point pt, Position.Bias[] biasReturn)` 将视图坐标系中的给定位置转换为模型中的最近的有代表性的位置。

Methods inherited from class javax.swing.plaf.ComponentUI
contains, createUI, getAccessibleChild, getAccessibleChildrenCount, getBaseline, getBaselineResizeBehavior

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - BasicTextUI
```
public BasicTextUI()
```
    创建一个新的用户界面。
- 方法详细信息
  - createCaret
```
protected Caret createCaret()
```
    创建使用插入对象。默认情况basiccaret创建实例。这种方法可以被重新定义为别的，实现inputposition接口或jcaret子类。
    
    结果
    
    插入对象
  - createHighlighter
```
protected Highlighter createHighlighter()
```
    创建用于添加亮点的对象。默认情况下，BasicHighlighter的一个实例被创建。这种方法可以被重新定义为别的，实现荧光笔接口或defaulthighlighter子类。
    
    结果
    
    亮点
  - getKeymapName
```
protected String getKeymapName()
```
    取你所要安装这个UI默认使用的名称。这是实现创建一个基于类的名字。该名称是删除的包前缀的类的名称。
    
    结果
    
    名称
  - createKeymap
```
protected Keymap createKeymap()
```
    创造你所使用的文本组件，并安装任何所需的绑定到它。默认情况下，你所是的这种类型的文本界面的所有实例之间共享。你所拥有的getkeymapname方法定义的名称。如果你所没有找到，然后default_keymap从jtextcomponent使用。
    用来创建你所绑定的设置是牵强使用密钥相结合的方法，getPropertyPrefix()字符串.keyBindings由UIManager。类型预计将JTextComponent.KeyBinding[]。
    
    结果
    
    你所
    
    另请参见：
    
    getKeymapName()， JTextComponent
  - propertyChange
```
protected void propertyChange(PropertyChangeEvent evt)
```
    该方法被调用时，绑定属性是相关的jtextcomponent改变。这是一个钩，UI实现可能改变以反映用户界面如何显示jtextcomponent类绑定的属性。这是实现做什么（即性能jtextcomponent本身是在调用此方法之前处理的响应）。这个实现更新文本组件的背景如果编辑和/或功能状态的变化。
    
    参数
    
    evt -属性更改事件
  - getPropertyPrefix
```
protected abstract String getPropertyPrefix()
```
    获取用于查找性能的一个关键的名字”。这是作为一个前缀，所有标准的文本属性。
    
    结果
    
    名称
  - installDefaults
```
protected void installDefaults()
```
    初始化组件的属性，如字体、前景、背景、符号的颜色，选择颜色，选择文字颜色，禁用的文本颜色，和边框颜色。字体，前景，和背景属性仅设置如果当前值是null或uiresource，其他属性被设置，如果当前值为空。
    
    另请参见：
    
    uninstallDefaults()， installUI(javax.swing.JComponent)
  - uninstallDefaults
```
protected void uninstallDefaults()
```
    设置组件的属性没有显式重写到 null。物业是考虑重写如果其当前值不是一个 UIResource。
    
    另请参见：
    
    installDefaults()， uninstallUI(javax.swing.JComponent)
  - installListeners
```
protected void installListeners()
```
    为用户界面安装侦听器。
  - uninstallListeners
```
protected void uninstallListeners()
```
    卸载的听众的UI。
  - installKeyboardActions
```
protected void installKeyboardActions()
```
  - uninstallKeyboardActions
```
protected void uninstallKeyboardActions()
```
  - paintBackground
```
protected void paintBackground(Graphics g)
```
    画一个视图的背景。这只会在相关的组件isopaque()是真的叫。默认是绘制组件的背景颜色。
    
    参数
    
    g -图形上下文
  - getComponent
```
protected final JTextComponent getComponent()
```
    与此相关的文本组件用户界面的实现。这将是空的，直到用户界面已被安装。
    
    结果
    
    编辑组件
  - modelChanged
```
protected void modelChanged()
```
    标志模型变化。当模型发生了变化时，就被调用。它实现了重建视图层次结构来表示关联模型的默认根元素。
  - setView
```
protected final void setView(View v)
```
    设置视图层次结构的根和电话invalidate()电流。如果有任何子组件，他们将被删除（即有假定有来自组件嵌入在视图中）。
    
    参数
    
    v -根视图
  - paintSafely
```
protected void paintSafely(Graphics g)
```
    安全地绘制界面，保证模型不会从这个线程的视图改变。这做了以下的事情，从背面渲染。
    1. 如果该组件被标记为不透明，则该背景画在该组件的当前背景颜色中。
    2. 亮点（如果有的话）是画。
    3. 视图层次结构。
    4. 插入符号是画。
    参数
    
    g -图形上下文
  - installUI
```
public void installUI(JComponent c)
```
    安装组件的用户界面。这做了以下的事情。
    1. 如果客户端程序尚未设置不透明属性，则将关联的组件设置为不透明的。这将导致组件的背景颜色被画。
    2. 安装默认的符号和记号的相关部件。这些属性仅设置如果当前值是null或UIResource实例。
    3. 附加到编辑器和模型。如果没有模型，就创建一个默认模型。
    4. 创建视图工厂和用于表示模型的视图层次结构。
    重写：
    
    installUI 方法重写，继承类 ComponentUI
    
    参数
    
    c -编辑组件
    
    另请参见：
    
    ComponentUI.installUI(javax.swing.JComponent)
  - uninstallUI
```
public void uninstallUI(JComponent c)
```
    deinstalls为组件的用户界面。这消除了听众，卸载的荧光笔，删除视图的映射，和空。
    
    重写：
    
    uninstallUI 方法重写，继承类 ComponentUI
    
    参数
    
    c -编辑组件
    
    另请参见：
    
    ComponentUI.uninstallUI(javax.swing.JComponent)
  - update
```
public void update(Graphics g,
                   JComponent c)
```
    父类涂料背景在不受控制的方式（即一个希望一个图像平铺的背景）。为了防止这种情况发生两次，这种方法是重新实现简单的油漆。
    注意：注意：Superclass也不是线程安全的背景渲染，虽然这不是一个默认的渲染问题。
    
    重写：
    
    update 方法重写，继承类 ComponentUI
    
    参数
    
    g - Graphics背景的画
    
    c -正在绘制的构件；这种说法常常被忽视，但可能如果UI对象是无状态的，共享由多个组件
    
    另请参见：
    
    ComponentUI.paint(java.awt.Graphics, javax.swing.JComponent)， JComponent.paintComponent(java.awt.Graphics)
  - paint
```
public final void paint(Graphics g,
                        JComponent c)
```
    绘制界面。这是送给paintsafely方法保证模式不会改变该线程视图，它的渲染下（如果相关的模型是从abstractdocument）。这使该模型能够异步更新。
    
    重写：
    
    paint 方法重写，继承类 ComponentUI
    
    参数
    
    g -图形上下文
    
    c -编辑组件
    
    另请参见：
    
    ComponentUI.update(java.awt.Graphics, javax.swing.JComponent)
  - getPreferredSize
```
public Dimension getPreferredSize(JComponent c)
```
    获取编辑器组件的首选大小。如果在接收此请求之前已给定了该组件的大小，它将设置视图层次结构的大小，以在请求视图层次结构的首选大小之前，来反映组件的大小。在回答请求之前，可以将格式化的视图格式化为当前组件大小的格式。其他视图不关心当前格式化的大小，并给出相同的答案无论哪种方式。
    
    重写：
    
    getPreferredSize 方法重写，继承类 ComponentUI
    
    参数
    
    c -编辑组件
    
    结果
    
    的大小
    
    另请参见：
    
    JComponent.getPreferredSize()， LayoutManager.preferredLayoutSize(java.awt.Container)
  - getMinimumSize
```
public Dimension getMinimumSize(JComponent c)
```
    获取编辑器组件的最小大小。
    
    重写：
    
    getMinimumSize 方法重写，继承类 ComponentUI
    
    参数
    
    c -编辑组件
    
    结果
    
    的大小
    
    另请参见：
    
    JComponent.getMinimumSize()， LayoutManager.minimumLayoutSize(java.awt.Container)， ComponentUI.getPreferredSize(javax.swing.JComponent)
  - getMaximumSize
```
public Dimension getMaximumSize(JComponent c)
```
    获取编辑器组件的最大大小。
    
    重写：
    
    getMaximumSize 方法重写，继承类 ComponentUI
    
    参数
    
    c -编辑组件
    
    结果
    
    的大小
    
    另请参见：
    
    JComponent.getMaximumSize()， LayoutManager2.maximumLayoutSize(java.awt.Container)
  - getVisibleEditorRect
```
protected Rectangle getVisibleEditorRect()
```
    获取分配给根视图。由于一个不幸的历史事件，这种方法是不恰当的命名。返回的矩形与可见性无关。该组件必须有一个非零的正大小，此翻译要计算。
    
    结果
    
    根视图的包围盒
  - modelToView
```
public Rectangle modelToView(JTextComponent tc,
                             int pos)
                      throws BadLocationException
```
    将模型中给定的位置转换为视图坐标系中的位置。该组件必须有一个非零的正大小，此翻译要计算。
    
    Specified by:
    
    modelToView 方法重写，继承类 TextUI
    
    参数
    
    tc -文本组件，这个插件安装
    
    pos在模型的局部位置翻译> = 0
    
    结果
    
    作为一个矩形的坐标，如果模型没有画的话
    
    异常
    
    BadLocationException -如果给定的位置不在相关文件表示一个有效的位置
    
    另请参见：
    
    TextUI.modelToView(javax.swing.text.JTextComponent, int)
  - modelToView
```
public Rectangle modelToView(JTextComponent tc,
                             int pos,
                             Position.Bias bias)
                      throws BadLocationException
```
    将模型中给定的位置转换为视图坐标系中的位置。该组件必须有一个非零的正大小，此翻译要计算。
    
    Specified by:
    
    modelToView 方法重写，继承类 TextUI
    
    参数
    
    tc -文本组件，这个插件安装
    
    pos在模型的局部位置翻译> = 0
    
    结果
    
    作为一个矩形的坐标，如果模型没有画的话
    
    异常
    
    BadLocationException -如果给定的位置不在相关文件表示一个有效的位置
    
    另请参见：
    
    TextUI.modelToView(javax.swing.text.JTextComponent, int)
  - viewToModel
```
public int viewToModel(JTextComponent tc,
                       Point pt)
```
    将视图坐标系中的给定位置转换为模型中的最近的有代表性的位置。该组件必须有一个非零的正大小，此翻译要计算。
    
    Specified by:
    
    viewToModel 方法重写，继承类 TextUI
    
    参数
    
    tc -文本组件，这个插件安装
    
    pt -视图中的位置翻译。这应该是在同一个坐标系统中的鼠标事件。
    
    结果
    
    从文档的开始偏移量= 0，- 1如果不画
    
    另请参见：
    
    TextUI.viewToModel(javax.swing.text.JTextComponent, java.awt.Point)
  - viewToModel
```
public int viewToModel(JTextComponent tc,
                       Point pt,
                       Position.Bias[] biasReturn)
```
    将视图坐标系中的给定位置转换为模型中的最近的有代表性的位置。该组件必须有一个非零的正大小，此翻译要计算。
    
    Specified by:
    
    viewToModel 方法重写，继承类 TextUI
    
    参数
    
    tc -文本组件，这个插件安装
    
    pt -视图中的位置翻译。这应该是在同一个坐标系统中的鼠标事件。
    
    biasReturn填充在用此方法指示点是在给定的模型更接近前一个或下一个字符
    
    结果
    
    从文档开始的偏移量= 0，- 1如果组件还没有一个积极的大小。
    
    另请参见：
    
    TextUI.viewToModel(javax.swing.text.JTextComponent, java.awt.Point)
  - getNextVisualPositionFrom
```
public int getNextVisualPositionFrom(JTextComponent t,
                                     int pos,
                                     Position.Bias b,
                                     int direction,
                                     Position.Bias[] biasRet)
                              throws BadLocationException
```
    提供了一种方法来确定下一步的直观模型，一个可能的地方插入位置。一些视图可能是不可见的，它们可能不在模型中的相同的顺序中，或者它们只是可能不允许访问模型中的一些位置。
    
    Specified by:
    
    getNextVisualPositionFrom 方法重写，继承类 TextUI
    
    参数
    
    t -文本组件，这个插件安装
    
    pos -位置转换> = 0
    
    b -位置的偏差
    
    direction -这可以被认为是箭头键通常发现键盘上的当前位置的方向。这可能是swingconstants.west，swingconstants.east，SwingConstants.NORTH，或swingconstants.south
    
    biasRet -数组包含返回的位置偏差
    
    结果
    
    最能代表下一个位置视觉位置的模型中的位置
    
    异常
    
    BadLocationException
  - damageRange
```
public void damageRange(JTextComponent tc,
                        int p0,
                        int p1)
```
    导致负责模型给出的部分重新绘制视图的部分。如果视图当前没有被绘制，则什么都不做。
    
    Specified by:
    
    damageRange 方法重写，继承类 TextUI
    
    参数
    
    tc -文本组件，这个插件安装
    
    p0 -范围> = 0的开始
    
    p1 -结束的范围> = P0
    
    另请参见：
    
    TextUI.damageRange(javax.swing.text.JTextComponent, int, int)
  - damageRange
```
public void damageRange(JTextComponent t,
                        int p0,
                        int p1,
                        Position.Bias p0Bias,
                        Position.Bias p1Bias)
```
    导致负责模型给出的部分重新绘制视图的部分。
    
    Specified by:
    
    damageRange 方法重写，继承类 TextUI
    
    参数
    
    p0 -范围> = 0的开始
    
    p1 -结束的范围> = P0
  - getEditorKit
```
public EditorKit getEditorKit(JTextComponent tc)
```
    获取用于UI的editorkit。
    
    Specified by:
    
    getEditorKit 方法重写，继承类 TextUI
    
    参数
    
    tc -文本组件，这个插件安装
    
    结果
    
    编辑能力
    
    另请参见：
    
    TextUI.getEditorKit(javax.swing.text.JTextComponent)
  - getRootView
```
public View getRootView(JTextComponent tc)
```
    获取与关联文本组件配置视图（即该层次结构的根）可以遍历确定模型代表着空间。
    注：the视图层次可以遍历从根视图，和其他的东西可以做的很好。事情这样不能做保护喜欢简单的方法调用通过当。因此，在并发的存在下，正确的操作必须由调用该方法的任何逻辑来设置！
    
    Specified by:
    
    getRootView 方法重写，继承类 TextUI
    
    参数
    
    tc -文本组件，这个插件安装
    
    结果
    
    观
    
    另请参见：
    
    TextUI.getRootView(javax.swing.text.JTextComponent)
  - getToolTipText
```
public String getToolTipText(JTextComponent t,
                             Point pt)
```
    返回可在通过定位工具提示字符串。将该方法转发到根视图上。
    
    重写：
    
    getToolTipText 方法重写，继承类 TextUI
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    JTextComponent.getToolTipText(java.awt.event.MouseEvent)， View.getToolTipText(float, float, java.awt.Shape)
  - create
```
public View create(Element elem)
```
    为元素创建一个视图。如果一个类希望直接实现工厂化生产的观点（S），它应该重新实现该方法。默认情况下，它只返回表示它无法表示元素的空值。
    
    Specified by:
    
    create 接口 ViewFactory
    
    参数
    
    elem -元素
    
    结果
    
    观
    
    另请参见：
    
    View
  - create
```
public View create(Element elem,
                   int p0,
                   int p1)
```
    为元素创建一个视图。如果一个类希望直接实现工厂化生产的观点（S），它应该重新实现该方法。默认情况下，它只返回一空，表示它无法代表元素的一部分。
    
    参数
    
    elem -元素
    
    p0 -起始偏移> = 0
    
    p1 -结束偏移> = P0
    
    结果
    
    观

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class BasicTextUI

Nested Class Summary

构造方法摘要

方法摘要

Methods inherited from class javax.swing.plaf.ComponentUI

Methods inherited from class java.lang.Object

Constructor Detail

BasicTextUI

方法详细信息

createCaret

createHighlighter

getKeymapName

createKeymap

propertyChange

getPropertyPrefix

installDefaults

uninstallDefaults

installListeners

uninstallListeners

installKeyboardActions

uninstallKeyboardActions

paintBackground

getComponent

modelChanged

setView

paintSafely

installUI

uninstallUI

update

paint

getPreferredSize

getMinimumSize

getMaximumSize

getVisibleEditorRect

modelToView

modelToView

viewToModel

viewToModel

getNextVisualPositionFrom

damageRange

damageRange

getEditorKit

getRootView

getToolTipText

create

create