GlyphView (Java Platform SE 8 )

java.lang.Object
- javax.swing.text.View
- - javax.swing.text.GlyphView

All Implemented Interfaces:

Cloneable， SwingConstants， TabableView

已知直接子类：

LabelView
```
public class GlyphView
extends View
implements TabableView, Cloneable
```
一个在此是一个风格的文本块代表一个视图映射在文本模式的元素。这种观点通常是负责使用某种角色等级属性显示文字符号。glyphpainter类的实现是用来做实际的绘制和模型/视图转换。将渲染从与模型的布局和管理中分离出来。
视图支持以格式化为目的。通过打破共享产生的片段的观点，有主要责任的元素（即它们是嵌套的类，并只携带少量的自己的状态），所以他们可以分享它的资源。

因为这种观点代表文本可能嵌入在它的标签，它实现了TabableView接口。标签只会被扩展，如果这个视图被嵌入在一个容器中，标签扩展。内是一个容器，标签扩展的一个例子。

从以下版本开始：

一点三

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`GlyphView.GlyphPainter` 一个类来执行的符号绘制。

Field Summary
- Fields inherited from class javax.swing.text.View
  BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS
- 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

构造方法摘要

构造方法
Constructor and Description
`GlyphView(Element elem)` 构造一个包在元素上的新视图。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`View`	`breakView(int axis, int p0, float pos, float len)` 将此视图在给定长度上打破这个视图。
`void`	`changedUpdate(DocumentEvent e, Shape a, ViewFactory f)` 从该视图负责的位置上更改属性的文档的通知。
`protected void`	`checkPainter()` 查看是否存在一个字形的画家。
`protected Object`	`clone()` 创建一个浅副本。
`View`	`createFragment(int p0, int p1)` 创建表示元素的一部分的视图。
`float`	`getAlignment(int axis)` 沿着一个轴确定此视图所需的对齐方式。
`Color`	`getBackground()` 把背景颜色来呈现的符号。
`int`	`getBreakWeight(int axis, float pos, float len)` 确定如何有吸引力的突破机会，在这种观点是。
`int`	`getEndOffset()` 提取的模型，这是负责的部分。
`Font`	`getFont()` 取字体，字形应根据。
`Color`	`getForeground()` 把前景颜色来呈现的符号。
`GlyphView.GlyphPainter`	`getGlyphPainter()` 获取当前安装的字形画家。
`float`	`getMinimumSpan(int axis)` 沿着一个轴确定该视图的最小间距。
`int`	`getNextVisualPositionFrom(int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet)` 提供了一种方法来确定下一步的直观模型，一个可能的地方插入位置。
`float`	`getPartialSpan(int p0, int p1)` 确定视图的一部分的同一个轴上的跨度作为标签展开的范围。
`float`	`getPreferredSpan(int axis)` 沿着一个轴确定该视图的首选跨度。
`int`	`getStartOffset()` 提取的模型，这是负责的部分。
`float`	`getTabbedSpan(float x, TabExpander e)` 确定使用给定的标签扩展实现时所需的跨度。
`TabExpander`	`getTabExpander()` 取tabexpander使用如果标签视图中呈现。
`Segment`	`getText(int p0, int p1)` 获取占用给定范围的文本的引用。
`void`	`insertUpdate(DocumentEvent e, Shape a, ViewFactory f)` 给出了一个在该视图负责的位置上插入到文档中的通知。
`boolean`	`isStrikeThrough()` 确定符号应该有删除线。
`boolean`	`isSubscript()` 确定符号应呈现为上标。
`boolean`	`isSuperscript()` 确定是否应作为下标符号。
`boolean`	`isUnderline()` 确定是否应强调符号。
`Shape`	`modelToView(int pos, Shape a, Position.Bias b)` 提供从文档模型坐标空间到映射到它的视图的坐标空间的映射。
`void`	`paint(Graphics g, Shape a)` 渲染一个文本样式运行的一部分。
`void`	`removeUpdate(DocumentEvent e, Shape a, ViewFactory f)` 给予通知，该视图是由该视图负责的位置中的某个文件被删除的。
`void`	`setGlyphPainter(GlyphView.GlyphPainter p)` 设置用于绘制符号的画家。
`int`	`viewToModel(float x, float y, Shape a, Position.Bias[] biasReturn)` 从视图坐标空间提供一个映射到模型的逻辑坐标空间。

Methods inherited from class javax.swing.text.View
append, forwardUpdate, forwardUpdateToView, getAttributes, getChildAllocation, getContainer, getDocument, getElement, getGraphics, getMaximumSpan, getParent, getResizeWeight, getToolTipText, getView, getViewCount, getViewFactory, getViewIndex, getViewIndex, insert, isVisible, modelToView, modelToView, preferenceChanged, remove, removeAll, replace, setParent, setSize, updateChildren, updateLayout, viewToModel

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

- Constructor Detail
  - GlyphView
```
public GlyphView(Element elem)
```
    构造一个包在元素上的新视图。
    
    参数
    
    elem -元素
- 方法详细信息
  - clone
```
protected final Object clone()
```
    创建一个浅副本。这是由createfragment和breakview方法。
    
    重写：
    
    clone 方法重写，继承类 Object
    
    结果
    
    复制
    
    另请参见：
    
    Cloneable
  - getGlyphPainter
```
public GlyphView.GlyphPainter getGlyphPainter()
```
    获取当前安装的字形画家。如果一个画家还没有安装，并没有需要一个默认值，则返回空值。
  - setGlyphPainter
```
public void setGlyphPainter(GlyphView.GlyphPainter p)
```
    设置用于绘制符号的画家。
  - getText
```
public Segment getText(int p0,
                       int p1)
```
    获取占用给定范围的文本的引用。这通常是由glyphpainter用来确定它应该呈现什么特征符号。
    
    参数
    
    p0 -启动文件偏移> = 0
    
    p1 -结尾的文件偏移> = P0
    
    结果
    
    包含文本的 Segment
  - getBackground
```
public Color getBackground()
```
    把背景颜色来呈现的符号。如果没有背景色，则返回空值。这是实施，如果相关的文件是一个风格 StyledDocument.getBackground文件调用，则返回null。
  - getForeground
```
public Color getForeground()
```
    把前景颜色来呈现的符号。如果没有前台颜色，则返回空值。这是实施，如果相关的文件是一个styleddocument叫 StyledDocument.getBackground。如果相关的文件是不是一个styleddocument，相关组件的使用前景颜色。如果没有相关的组件，则返回。
  - getFont
```
public Font getFont()
```
    取字体，字形应根据。这是实施，如果相关的文件是一个styleddocument叫 StyledDocument.getFont。如果相关的文件是不是一个styleddocument，相关组件使用字体。如果没有相关的组件，则返回。
  - isUnderline
```
public boolean isUnderline()
```
    确定是否应强调符号。如果是真的，一个下划线应该通过基线绘制。
  - isStrikeThrough
```
public boolean isStrikeThrough()
```
    确定符号应该有删除线。如果是真的，一条线应通过圆心的象形文字。
  - isSubscript
```
public boolean isSubscript()
```
    确定符号应呈现为上标。
  - isSuperscript
```
public boolean isSuperscript()
```
    确定是否应作为下标符号。
  - getTabExpander
```
public TabExpander getTabExpander()
```
    取tabexpander使用如果标签视图中呈现。
  - checkPainter
```
protected void checkPainter()
```
    查看是否存在一个字形的画家。如果一个画家不存在，一个默认的字形的画家将被安装。
  - getTabbedSpan
```
public float getTabbedSpan(float x,
                           TabExpander e)
```
    确定使用给定的标签扩展实现时所需的跨度。
    
    Specified by:
    
    getTabbedSpan 接口 TabableView
    
    参数
    
    x -位置的视图将位于选项卡扩展> = 0的目的。
    
    e -如何扩大标签时遇到的。
    
    结果
    
    所需的跨度> = 0
    
    另请参见：
    
    TabableView.getTabbedSpan(float, javax.swing.text.TabExpander)
  - getPartialSpan
```
public float getPartialSpan(int p0,
                            int p1)
```
    确定视图的一部分的同一个轴上的跨度作为标签展开的范围。这是适用于tabexpander如果Tab扩展涉及调整文本没有空格与制表符的部分。因此，有一个假设，给定的范围不包含标签。
    这种方法可以同时服务gettabbedspan或getpreferredsize叫。它必须安排自己的文本缓冲区来进行测量。
    
    Specified by:
    
    getPartialSpan 接口 TabableView
    
    参数
    
    p0 -启动文件偏移> = 0
    
    p1 -结尾的文件偏移> = P0
    
    结果
    
    跨度> = 0
  - getStartOffset
```
public int getStartOffset()
```
    提取的模型，这是负责的部分。
    
    重写：
    
    getStartOffset 方法重写，继承类 View
    
    结果
    
    该模型的起始偏移量
    
    另请参见：
    
    View.getStartOffset()
  - getEndOffset
```
public int getEndOffset()
```
    提取的模型，这是负责的部分。
    
    重写：
    
    getEndOffset 方法重写，继承类 View
    
    结果
    
    结束偏移到模型中
    
    另请参见：
    
    View.getEndOffset()
  - paint
```
public void paint(Graphics g,
                  Shape a)
```
    渲染一个文本样式运行的一部分。
    
    Specified by:
    
    paint 方法重写，继承类 View
    
    参数
    
    g -绘制表面使用
    
    a -分配区域进行渲染
  - getMinimumSpan
```
public float getMinimumSpan(int axis)
```
    沿着一个轴确定该视图的最小间距。
    此实现返回最长的非易碎的区域内的视图作为View.X_AXIS最小跨度。
    
    重写：
    
    getMinimumSpan 方法重写，继承类 View
    
    参数
    
    axis -可能是 View.X_AXIS或 View.Y_AXIS
    
    结果
    
    最小跨度的视图可以被渲染成
    
    异常
    
    IllegalArgumentException -如果 axis参数无效
    
    另请参见：
    
    View.getMinimumSpan(int)
  - getPreferredSpan
```
public float getPreferredSpan(int axis)
```
    沿着一个轴确定该视图的首选跨度。
    
    Specified by:
    
    getPreferredSpan 方法重写，继承类 View
    
    参数
    
    axis -可能是view.x_axis或view.y_axis
    
    结果
    
    跨度的视图将被渲染成> = 0。通常情况下，视图被告知要渲染到返回的跨度，虽然没有保证。父可能会选择调整或打破视图。
    
    另请参见：
    
    View.getPreferredSpan(int)
  - getAlignment
```
public float getAlignment(int axis)
```
    沿着一个轴确定此视图所需的对齐方式。为标签，对准沿字体基线为Y轴，与父对准沿X轴。
    
    重写：
    
    getAlignment 方法重写，继承类 View
    
    参数
    
    axis -可能是view.x_axis或view.y_axis
    
    结果
    
    所需的对准。这应该是一个值在0和1之间的包容性，其中0表示对准在原点和1表示对齐到完整的跨度远离原点。0.5的对齐方式将是视图的中心。
  - modelToView
```
public Shape modelToView(int pos,
                         Shape a,
                         Position.Bias b)
                  throws BadLocationException
```
    提供从文档模型坐标空间到映射到它的视图的坐标空间的映射。
    
    Specified by:
    
    modelToView 方法重写，继承类 View
    
    参数
    
    pos -位置转换> = 0
    
    a -分配区域进行渲染
    
    b - Position.Bias.Forward或 Position.Bias.Backward
    
    结果
    
    给定位置的包围盒
    
    异常
    
    BadLocationException -如果给定的位置不在相关文件表示一个有效的位置
    
    另请参见：
    
    View.modelToView(int, java.awt.Shape, javax.swing.text.Position.Bias)
  - viewToModel
```
public int viewToModel(float x,
                       float y,
                       Shape a,
                       Position.Bias[] biasReturn)
```
    从视图坐标空间提供一个映射到模型的逻辑坐标空间。
    
    Specified by:
    
    viewToModel 方法重写，继承类 View
    
    参数
    
    x - x坐标> = 0
    
    y - Y坐标> = 0
    
    a -分配区域进行渲染
    
    biasReturn - Position.Bias.Forward或 Position.Bias.Backward作为该数组的元素返回零
    
    结果
    
    在模型中的位置，最好的代表给定的角度来看> = 0
    
    另请参见：
    
    View.viewToModel(float, float, java.awt.Shape, javax.swing.text.Position.Bias[])
  - getBreakWeight
```
public int getBreakWeight(int axis,
                          float pos,
                          float len)
```
    确定如何有吸引力的突破机会，在这种观点是。这可用于确定哪些观点是最有吸引力的电话 breakView在格式化的过程。重量越高，断裂的吸引力越大。等于或低于 View.BadBreakWeight不应被视为一个突破。一个值大于或等于 View.ForcedBreakWeight应该被打破。
    这是实现了父类的y_axis。在x_axis以下值可以返回。
    
    view.excellentbreakweight
    
    如果有空格进行所需的休息位置。
    
    view.badbreakweight
    
    如果所需的中断位置结果在起始偏移的中断位置。
    
    view.goodbreakweight
    
    如果其他条件不发生。
    
    通常如果可以找到导致破一个空白位置的行为，否则断字符之间。
    
    重写：
    
    getBreakWeight 方法重写，继承类 View
    
    参数
    
    axis -可能是view.x_axis或view.y_axis
    
    pos的破断视图> = 0开始的可能的位置。这可能是有用的计算标签位置。
    
    len -指定的相对长度从POS在潜在破坏所需的> = 0。
    
    结果
    
    的重量，这应该是View.ForcedBreakWeight和View.BadBreakWeight之间的值。
    
    另请参见：
    
    LabelView， ParagraphView， View.BadBreakWeight， View.GoodBreakWeight， View.ExcellentBreakWeight， View.ForcedBreakWeight
  - breakView
```
public View breakView(int axis,
                      int p0,
                      float pos,
                      float len)
```
    将此视图在给定长度上打破这个视图。这是实施企图突破一个空格的位置，并返回一个与最后的空白片段。如果一个空白位置可以不被发现，最近使用字符。
    
    重写：
    
    breakView 方法重写，继承类 View
    
    参数
    
    axis -可能是view.x_axis或view.y_axis
    
    p0 -定位模型中的碎片的地方应该是表示> = 0。
    
    pos的位置沿轴的断裂视图将占据> = 0。这可能是有用的东西，如标签计算。
    
    len -指定的距离沿轴线在一个潜在的突破需要> = 0。
    
    结果
    
    视图的片段，表示给定的跨度，如果视图可以被打破。如果视图不支持拆分行为，则返回视图本身。
    
    另请参见：
    
    View.breakView(int, int, float, float)
  - createFragment
```
public View createFragment(int p0,
                           int p1)
```
    创建表示元素的一部分的视图。这是潜在有用的，在格式化操作期间采取测量的片段的视图。如果视图不支持分裂（默认），它应该返回自身。
    这一观点并支持分裂。它实现返回一个嵌套类，该类在该视图中仅表示视图的一部分。
    
    重写：
    
    createFragment 方法重写，继承类 View
    
    参数
    
    p0 -起始偏移> = 0。这应该是一个大于或等于元素起始偏移量和小于元素结束偏移量的值的值。
    
    p1 -结束偏移> P0。这应该是一个小于或等于元素结束偏移量和大于元素起始偏移量的值。
    
    结果
    
    视图片段，或它本身，如果视图不支持断裂成碎片
    
    另请参见：
    
    LabelView
  - getNextVisualPositionFrom
```
public int getNextVisualPositionFrom(int pos,
                                     Position.Bias b,
                                     Shape a,
                                     int direction,
                                     Position.Bias[] biasRet)
                              throws BadLocationException
```
    提供了一种方法来确定下一步的直观模型，一个可能的地方插入位置。一些视图可能是不可见的，它们可能不在模型中的相同的顺序中，或者它们只是可能不允许访问模型中的一些位置。此方法使指定在> = 0的范围内转换的位置。如果值为- 1，则将自动计算一个位置。如果该值小于1，将抛出的 BadLocationException。
    
    重写：
    
    getNextVisualPositionFrom 方法重写，继承类 View
    
    参数
    
    pos的位置转换
    
    a -分配区域进行渲染
    
    direction -这可以被认为是箭头键通常发现键盘上的当前位置的方向。这可能是swingconstants.west，swingconstants.east，SwingConstants.NORTH，或swingconstants.south。
    
    结果
    
    最能代表下一个位置视觉位置的模型中的位置。
    
    异常
    
    BadLocationException -给定的位置不在有效的文档位置
    
    IllegalArgumentException -无效的方向
  - insertUpdate
```
public void insertUpdate(DocumentEvent e,
                         Shape a,
                         ViewFactory f)
```
    给出了一个在该视图负责的位置上插入到文档中的通知。这是实现呼叫preferencechanged沿轴线的字形渲染。
    
    重写：
    
    insertUpdate 方法重写，继承类 View
    
    参数
    
    e -从相关文档的变更信息
    
    a -视图的当前配置
    
    f -工厂用重建如果视图有孩子
    
    另请参见：
    
    View.insertUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)
  - removeUpdate
```
public void removeUpdate(DocumentEvent e,
                         Shape a,
                         ViewFactory f)
```
    给予通知，该视图是由该视图负责的位置中的某个文件被删除的。这是实现呼叫preferencechanged沿轴线的字形渲染。
    
    重写：
    
    removeUpdate 方法重写，继承类 View
    
    参数
    
    e -从相关文档的变更信息
    
    a -视图的当前配置
    
    f -工厂用重建如果视图有孩子
    
    另请参见：
    
    View.removeUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)
  - changedUpdate
```
public void changedUpdate(DocumentEvent e,
                          Shape a,
                          ViewFactory f)
```
    从该视图负责的位置上更改属性的文档的通知。这是实现呼叫preferencechanged沿水平轴和垂直轴。
    
    重写：
    
    changedUpdate 方法重写，继承类 View
    
    参数
    
    e -从相关文档的变更信息
    
    a -视图的当前配置
    
    f -工厂用重建如果视图有孩子
    
    另请参见：
    
    View.changedUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)

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 GlyphView

Nested Class Summary

Field Summary

Fields inherited from class javax.swing.text.View

Fields inherited from interface javax.swing.SwingConstants

构造方法摘要

方法摘要

Methods inherited from class javax.swing.text.View

Methods inherited from class java.lang.Object

Constructor Detail

GlyphView

方法详细信息

clone

getGlyphPainter

setGlyphPainter

getText

getBackground

getForeground

getFont

isUnderline

isStrikeThrough

isSubscript

isSuperscript

getTabExpander

checkPainter

getTabbedSpan

getPartialSpan

getStartOffset

getEndOffset

paint

getMinimumSpan

getPreferredSpan

getAlignment

modelToView

viewToModel

getBreakWeight

breakView

createFragment

getNextVisualPositionFrom

insertUpdate

removeUpdate

changedUpdate