TextLayout (Java Platform SE 8 )

java.lang.Object
- java.awt.font.TextLayout

All Implemented Interfaces:

Cloneable
```
public final class TextLayout
extends Object
implements Cloneable
```
TextLayout是风格字符数据的不可变的图形表示。
它提供以下功能：
- 隐式双向分析和重新排序，
- 光标定位和移动，包括用于混合方向文本的分割光标，
- 突出显示，包括混合方向文本的逻辑和视觉突出显示，
- 多个基线（罗马，悬挂和居中），
- 打测试，
- 理由，
- 默认字体替换，
- 诸如上升，下降和提前的度量信息，以及
- 渲染
一个TextLayout对象可以使用其draw方法渲染。

TextLayout可以直接或通过使用LineBreakMeasurer构建。直接构建时，源文本代表一个段落。 LineBreakMeasurer允许将样式文本分解成适合特定宽度的行。有关更多信息，请参阅LineBreakMeasurer文档。

TextLayout建设逻辑进行如下：
- 段落属性被提取和检查，
- 文本被分析用于双向重新排序，并且如果需要则重新排序信息被计算，
- 文本被分割成样式运行
- 为样式运行选择字体，首先如果存在属性TextAttribute.FONT使用字体，否则通过使用已定义的属性计算默认字体
- 如果文本在多个基准上，则运行或子文件进一步分解为共享一个共同基准的子目录，
- 使用所选择的字体为每次运行生成glyphvectors，
- 对glyphvectors执行最终双向重排序
从TextLayout对象的方法返回的所有图形信息都是相对于TextLayout的起点， TextLayout是TextLayout对象的基线与其左边缘的TextLayout 。而且，假定传递给TextLayout对象的方法的坐标是相对于TextLayout对象的来源。客户通常需要在TextLayout对象的坐标系和另一个对象（例如Graphics对象）中的坐标系之间进行TextLayout 。

TextLayout对象由样式文本构建，但它们不保留对其源文本的引用。因此，以前用于生成TextLayout的文本的更改不会影响TextLayout 。

一对三种方法TextLayout对象（ getNextRightHit ， getNextLeftHit和hitTestChar ）返回的实例TextHitInfo 。这些TextHitInfo对象中的偏移量相对于TextLayout ， 而不是用于创建TextLayout的文本。类似地，接受TextHitInfo实例作为参数的TextLayout方法期望TextHitInfo对象的偏移量相对于TextLayout ，而不是任何基础文本存储模型。

示例：

构造和绘制一个TextLayout及其边界矩形：
```
   Graphics2D g = ...;
   Point2D loc = ...;
   Font font = Font.getFont("Helvetica-bold-italic");
   FontRenderContext frc = g.getFontRenderContext();
   TextLayout layout = new TextLayout("This is a string", font, frc);
   layout.draw(g, (float)loc.getX(), (float)loc.getY());

   Rectangle2D bounds = layout.getBounds();
   bounds.setRect(bounds.getX()+loc.getX(),
                  bounds.getY()+loc.getY(),
                  bounds.getWidth(),
                  bounds.getHeight());
   g.draw(bounds);
 
```
测试一个TextLayout （确定哪个字符在特定的图形位置）：
```
   Point2D click = ...;
   TextHitInfo hit = layout.hitTestChar(
                         (float) (click.getX() - loc.getX()),
                         (float) (click.getY() - loc.getY()));
 
```
按右箭头按键：
```
   int insertionIndex = ...;
   TextHitInfo next = layout.getNextRightHit(insertionIndex);
   if (next != null) {
       // translate graphics to origin of layout on screen
       g.translate(loc.getX(), loc.getY());
       Shape[] carets = layout.getCaretShapes(next.getInsertionIndex());
       g.draw(carets[0]);
       if (carets[1] != null) {
           g.draw(carets[1]);
       }
   }
 
```
绘制对应于源文本中的子字符串的选择范围。所选区域可能不是视觉上连续的：
```
   // selStart, selLimit should be relative to the layout,
   // not to the source text

   int selStart = ..., selLimit = ...;
   Color selectionColor = ...;
   Shape selection = layout.getLogicalHighlightShape(selStart, selLimit);
   // selection may consist of disjoint areas
   // graphics is assumed to be tranlated to origin of layout
   g.setColor(selectionColor);
   g.fill(selection);
 
```
绘制视觉上连续的选择范围。选择范围可以对应于源文本中的多个子字符串。可以使用getLogicalRangesForVisualSelection()获取相应的源文本子串的范围：
```
   TextHitInfo selStart = ..., selLimit = ...;
   Shape selection = layout.getVisualHighlightShape(selStart, selLimit);
   g.setColor(selectionColor);
   g.fill(selection);
   int[] ranges = getLogicalRangesForVisualSelection(selStart, selLimit);
   // ranges[0], ranges[1] is the first selection range,
   // ranges[2], ranges[3] is the second selection range, etc.
 
```
注意：字体旋转可以使文本基线旋转，多次运行不同的旋转可能导致基线弯曲或曲折。为了解决这个（罕见的）可能性，指定了一些API返回度量值并在“基线相对坐标”（例如，上升，前进）中获取参数，而其他API在“标准坐标”（例如getBounds）中。基线相对坐标中的值将“x”坐标映射到沿着基线的距离（正x沿着基线向前），“y”坐标与“x”处垂直于基线的距离y从基线矢量顺时针旋转90度）。沿着x轴和y轴测量标准坐标值，在TextLayout的原点为0,0。每个相关API的文档指示什么值在什么坐标系中。通常，与测量相关的API处于基准相对坐标，而与显示相关的API处于标准坐标。
另请参见：

LineBreakMeasurer ， TextAttribute ， TextHitInfo ， LayoutPath

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`TextLayout.CaretPolicy` 定义确定强插插位置的策略。

Field Summary

Fields
Modifier and Type	Field and Description
`static TextLayout.CaretPolicy`	`DEFAULT_CARET_POLICY` 当客户端未指定策略时，将使用此 `CaretPolicy` 。

构造方法摘要

构造方法
Constructor and Description
`TextLayout(AttributedCharacterIterator text, FontRenderContext frc)` 从一个迭代器构造一个 `TextLayout`样式文本。
`TextLayout(String string, Font font, FontRenderContext frc)` 构造一个`TextLayout`从`String`和`Font` 。
`TextLayout(String string, Map<? extends AttributedCharacterIterator.Attribute,?> attributes, FontRenderContext frc)` 构造一个 `TextLayout`从 `String` ，并设置一个属性。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`protected Object`	`clone()` 创建一个这个 `TextLayout`的副本。
`void`	`draw(Graphics2D g2, float x, float y)` 在指定的`Graphics2D`上下文中指定的位置呈现此`TextLayout` 。
`boolean`	`equals(Object obj)` 返回 `true`如果指定的 `Object`是 `TextLayout`对象，如果指定的 `Object`等于这个 `TextLayout` 。
`boolean`	`equals(TextLayout rhs)` 如果两个布局相等，则返回 `true` 。
`float`	`getAdvance()` 返回此 `TextLayout` 。
`float`	`getAscent()` 返回此 `TextLayout`的上升。
`byte`	`getBaseline()` 返回此 `TextLayout`的基准。
`float[]`	`getBaselineOffsets()` 返回用于此 `TextLayout`的基线的偏移数组。
`Shape`	`getBlackBoxBounds(int firstEndpoint, int secondEndpoint)` 返回指定范围内的字符的黑框边界。
`Rectangle2D`	`getBounds()` 返回此 `TextLayout`的范围。
`float[]`	`getCaretInfo(TextHitInfo hit)` 返回与hit对应的插入符号的 `hit` 。
`float[]`	`getCaretInfo(TextHitInfo hit, Rectangle2D bounds)` 返回与hit对应的插入符号的 `hit` 。
`Shape`	`getCaretShape(TextHitInfo hit)` 返回 `Shape`代表在指定的打这个的自然边界中插入符号 `TextLayout` 。
`Shape`	`getCaretShape(TextHitInfo hit, Rectangle2D bounds)` 返回一个`Shape`，表示指定边界内指定点的插入符号。
`Shape[]`	`getCaretShapes(int offset)` 返回对应于强和弱插入符号的两个路径。
`Shape[]`	`getCaretShapes(int offset, Rectangle2D bounds)` 返回对应于强和弱插入符号的两个路径。
`Shape[]`	`getCaretShapes(int offset, Rectangle2D bounds, TextLayout.CaretPolicy policy)` 返回对应于强和弱插入符号的两个路径。
`int`	`getCharacterCount()` 返回此 `TextLayout` 。
`byte`	`getCharacterLevel(int index)` 返回index处的 `index` 。
`float`	`getDescent()` 返回这个 `TextLayout`的下降。
`TextLayout`	`getJustifiedLayout(float justificationWidth)` 创建一个这个 `TextLayout`对齐到指定宽度的副本。
`LayoutPath`	`getLayoutPath()` 返回LayoutPath，如果布局路径是默认路径，则为null（x映射到advance，y映射到offset）。
`float`	`getLeading()` 返回 `TextLayout`的领先。
`Shape`	`getLogicalHighlightShape(int firstEndpoint, int secondEndpoint)` 返回一个 `Shape`将逻辑选择包围在指定的范围内，扩展到此 `TextLayout` 。
`Shape`	`getLogicalHighlightShape(int firstEndpoint, int secondEndpoint, Rectangle2D bounds)` 返回一个 `Shape`将逻辑选择包含在指定的范围内，扩展到指定的 `bounds` 。
`int[]`	`getLogicalRangesForVisualSelection(TextHitInfo firstEndpoint, TextHitInfo secondEndpoint)` 返回与视觉选择对应的文本的逻辑范围。
`TextHitInfo`	`getNextLeftHit(int offset)` 返回左侧（顶部）的下一个插入符号的命中; 如果没有这样的命中，返回`null` 。
`TextHitInfo`	`getNextLeftHit(int offset, TextLayout.CaretPolicy policy)` 返回左侧（顶部）的下一个插入符号的命中; 如果没有这样的命中，返回`null` 。
`TextHitInfo`	`getNextLeftHit(TextHitInfo hit)` 返回左侧（顶部）的下一个插入符号的命中; 如果没有这样的命中，返回`null` 。
`TextHitInfo`	`getNextRightHit(int offset)` 返回右侧（下）的下一个插入符号的命中; 如果没有这样的命中，返回`null` 。
`TextHitInfo`	`getNextRightHit(int offset, TextLayout.CaretPolicy policy)` 返回右侧（下）的下一个插入符号的命中; 如果没有这样的命中，返回`null` 。
`TextHitInfo`	`getNextRightHit(TextHitInfo hit)` 返回右侧（下）的下一个插入符号的命中; 如果没有这样的命中，返回`null` 。
`Shape`	`getOutline(AffineTransform tx)` 返回一个 `Shape`代表这个 `TextLayout`的大纲。
`Rectangle`	`getPixelBounds(FontRenderContext frc, float x, float y)` 在给定位置的给定 `FontRenderContext`的图形中渲染时返回此 `TextLayout`的像素边界。
`float`	`getVisibleAdvance()` 返回此 `TextLayout`的提前，减去尾随空格。
`Shape`	`getVisualHighlightShape(TextHitInfo firstEndpoint, TextHitInfo secondEndpoint)` 返回一个 `Shape`将视觉选择包围在指定的范围内，扩展到边界。
`Shape`	`getVisualHighlightShape(TextHitInfo firstEndpoint, TextHitInfo secondEndpoint, Rectangle2D bounds)` 返回包含指定范围内的视觉选择的路径，扩展为 `bounds` 。
`TextHitInfo`	`getVisualOtherHit(TextHitInfo hit)` 返回指定命中的插入符号对面的命中。
`protected void`	`handleJustify(float justificationWidth)` 证明这个布局。
`int`	`hashCode()` 返回此 `TextLayout`的哈希码。
`TextHitInfo`	`hitTestChar(float x, float y)` 返回 `TextHitInfo`对应于指定点。
`TextHitInfo`	`hitTestChar(float x, float y, Rectangle2D bounds)` 返回 `TextHitInfo`对应于指定点。
`void`	`hitToPoint(TextHitInfo hit, Point2D point)` 将命中转换为标准坐标中的一个点。
`boolean`	`isLeftToRight()` 返回 `true`如果这 `TextLayout`有一个左到右的基本方向或 `false`如果它有一个从右到左的基本方向。
`boolean`	`isVertical()` 如果这个 `TextLayout`是垂直的，则返回 `true` 。
`String`	`toString()` 返回此 `TextLayout` 。

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

- 字段详细信息
  - DEFAULT_CARET_POLICY
```
public static final TextLayout.CaretPolicy DEFAULT_CARET_POLICY
```
    当客户端未指定策略时，将使用此CaretPolicy 。有了这个策略，对方向与线方向相同的角色的打击比反向角色的命中强。如果角色的方向相同，则角色前缘的命中要强于角色后缘的命中。
- 构造方法详细信息
  - TextLayout
```
public TextLayout(String string,
                  Font font,
                  FontRenderContext frc)
```
    构造一个TextLayout从String和Font 。所有文本都使用指定的Font进行样式Font 。
    String必须指定一段文字，因为双向算法需要整个段落。
    
    参数
    
    string - 要显示的文字
    
    font - a Font用于样式文本
    
    frc - 包含有关正确测量文本所需的图形设备信息。文本测量可能会根据设备分辨率和抗锯齿等属性略有不同。该参数不指定TextLayout与用户空间之间的TextLayout 。
  - TextLayout
```
public TextLayout(String string,
                  Map<? extends AttributedCharacterIterator.Attribute,?> attributes,
                  FontRenderContext frc)
```
    构造一个TextLayout从String ，并设置一个属性。
    所有文本都使用提供的属性进行风格化。
    
    string必须指定一段文字，因为双向算法需要整个段落。
    
    参数
    
    string - 要显示的文字
    
    attributes - 用于对文本进行样式的属性
    
    frc - 包含有关正确测量文本所需的图形设备的信息。文本测量可能会根据设备分辨率和抗锯齿等属性略有不同。该参数不指定TextLayout与用户空间之间的TextLayout 。
  - TextLayout
```
public TextLayout(AttributedCharacterIterator text,
                  FontRenderContext frc)
```
    从样式文本的迭代器构造一个TextLayout 。
    迭代器必须指定单个文本段落，因为双向算法需要整个段落。
    
    参数
    
    text - 要显示的样式文本
    
    frc - 包含有关正确测量文本所需的图形设备的信息。文本测量可能会根据设备分辨率和抗锯齿等属性略有不同。该参数不指定TextLayout与用户空间之间的TextLayout 。
- 方法详细信息
  - clone
```
protected Object clone()
```
    创建一个这个 TextLayout的副本。
    
    重写：
    
    clone在 Object
    
    结果
    
    这个实例的一个克隆。
    
    另请参见：
    
    Cloneable
  - getJustifiedLayout
```
public TextLayout getJustifiedLayout(float justificationWidth)
```
    创建一个这个TextLayout对齐到指定宽度的副本。
    如果这个TextLayout已经被证明是正当的，就会抛出异常。如果此TextLayout对象的调整率为零，一个TextLayout相同此TextLayout被返回。
    
    参数
    
    justificationWidth - 当对齐线时使用的宽度。为了获得最佳效果，它不应该与当前的进展情况有太大的不同。
    
    结果
    
    一个 TextLayout对齐到指定的宽度。
    
    异常
    
    Error - 如果这个布局已经被证明是对的，那么会抛出一个错误。
  - handleJustify
```
protected void handleJustify(float justificationWidth)
```
    证明这个布局。被子类别覆盖以控制对齐（如果有子类，那就是...）如果段落属性（源文本，可能由布局属性默认）表示非零对齐比，布局将只能证明。文本将被对齐到指定的宽度。当前的实现还会调整悬挂的标点符号和尾随空格以超出对齐宽度。一旦有理由，布局可能不会被重新调整。
    一些代码可能依赖于不可更改的布局。子类不应该直接调用它，而应该调用getJustifiedLayout，这将在此布局的克隆上调用此方法，保留原始。
    
    参数
    
    justificationWidth - 调整justificationWidth使用的宽度。为了获得最佳效果，它不应该与当前的进展情况有太大的不同。
    
    另请参见：
    
    getJustifiedLayout(float)
  - getBaseline
```
public byte getBaseline()
```
    返回此TextLayout的基准。基线是Font中定义的值Font ，罗马，中心和悬挂。上升和下降是相对于这个基线。 baselineOffsets也是相对于这个基线。
    
    结果
    
    这个基准是 TextLayout 。
    
    另请参见：
    
    getBaselineOffsets() ， Font
  - getBaselineOffsets
```
public float[] getBaselineOffsets()
```
    返回用于此TextLayout的基线的偏移数组。
    该数组由Font中定义的值之一进行索引，这些值是罗马，中心和挂起。这些值是相对于这个TextLayout对象的基线，所以getBaselineOffsets[getBaseline()] == 0 。将偏移量添加到TextLayout对象的基线的位置，以获取新基线的位置。
    
    结果
    
    该偏移数组包含用于此 TextLayout 。
    
    另请参见：
    
    getBaseline() ， Font
  - getAdvance
```
public float getAdvance()
```
    返回此TextLayout 。提前是从原始到最右边（最下方）字符前进的距离。这是在基线相对坐标。
    
    结果
    
    这个 TextLayout 。
  - getVisibleAdvance
```
public float getVisibleAdvance()
```
    返回此TextLayout ，减去尾随空格。这是在基线相对坐标。
    
    结果
    
    这个 TextLayout没有尾随的空格。
    
    另请参见：
    
    getAdvance()
  - getAscent
```
public float getAscent()
```
    返回此TextLayout的上升。上升是从TextLayout的顶部（右）到基线的距离。它始终为正或零。上升足以容纳上标的文本，并且是每个字形的上升，偏移和基线的总和的最大值。上升是TextLayout中所有文本基线的最大上升。它在基线相对坐标。
    
    结果
    
    这个 TextLayout的上升。
  - getDescent
```
public float getDescent()
```
    返回此TextLayout的下降。下降是从基线到TextLayout的底部（左）的TextLayout 。它始终为正或零。下降足以适应下标文本，并且是每个字形的下降，偏移和基线之和的最大值。这是TextLayout中所有文本基线的最大下降。它在基线相对坐标。
    
    结果
    
    这个 TextLayout的下降。
  - getLeading
```
public float getLeading()
```
    返回TextLayout的领先。领先的是这个建议的行间距TextLayout 。这是在基线相对坐标。
    领先的是从领先的血统，并在所有字形向量的计算基准TextLayout 。算法大致如下：
    maxD = 0; maxDL = 0; for (GlyphVector g in all glyphvectors) { maxD = max(maxD, g.getDescent() + offsets[g.getBaseline()]); maxDL = max(maxDL, g.getDescent() + g.getLeading() + offsets[g.getBaseline()]); } return maxDL - maxD;
    结果
    
    这个领先的 TextLayout 。
  - getBounds
```
public Rectangle2D getBounds()
```
    返回此TextLayout的范围。边界是标准坐标。
    由于光栅化效果，此边界可能不会包含TextLayout渲染的所有像素。
    这可能与TextLayout的上升，下降，起源或进步TextLayout 。
    
    结果
    
    一个Rectangle2D这是这个TextLayout的界限。
  - getPixelBounds
```
public Rectangle getPixelBounds(FontRenderContext frc,
                                float x,
                                float y)
```
    在给定位置的给定FontRenderContext的图形中渲染时，返回此TextLayout的像素边界。图形渲染方面不一定是一样的FontRenderContext用于创建此TextLayout ，并且可以为null。如果为空，则FontRenderContext如此TextLayout使用。
    
    参数
    
    frc - FontRenderContext的 Graphics 。
    
    x - 要呈现这个 TextLayout的x TextLayout 。
    
    y - 渲染这个 TextLayout的y TextLayout 。
    
    结果
    
    一个 Rectangle限制将受影响的像素。
    
    从以下版本开始：
    
    1.6
    
    另请参见：
    
    GlyphVector.getPixelBounds(java.awt.font.FontRenderContext, float, float)
  - isLeftToRight
```
public boolean isLeftToRight()
```
    返回true如果这TextLayout有一个左到右的基本方向或false如果它有一个从右到左的基本方向。 TextLayout具有从左到右（LTR）或从右到左（RTL）的基本方向。基本方向与线上文本的实际方向无关，可能是LTR，RTL或混合。从左到右的布局默认情况下应该向左摆放。如果布局在选项卡上，则选项卡从左到右运行，以便逻辑上连续的布局从左到右定位。 RTL布局也是如此。默认情况下，它们应该向左定位，并且选项卡从左到右运行。
    
    结果
    
    true如果这个TextLayout的基本方向是从左到右; false否则。
  - isVertical
```
public boolean isVertical()
```
    如果 TextLayout是垂直的，则返回 true 。
    
    结果
    
    true如果这TextLayout是垂直的; false另外。
  - getCharacterCount
```
public int getCharacterCount()
```
    返回此 TextLayout 。
    
    结果
    
    这个 TextLayout 。
  - getCaretInfo
```
public float[] getCaretInfo(TextHitInfo hit,
                            Rectangle2D bounds)
```
    返回与hit对应的插入符号的hit 。数组的第一个元素是插入符号与基线的交集，作为基线的距离。数组的第二个元素是相对于该点的基线测量的插入符号的反斜率（运行/上升）。
    此方法用于信息使用。要显示getCaretShapes ，最好使用getCaretShapes 。
    
    参数
    
    hit - 这个 TextLayout一个角色的 TextLayout
    
    bounds - bounds插入符号信息的界限。边界在基线相对坐标。
    
    结果
    
    一个包含插入符位置和斜率的双元素数组。返回的插入符号信息在基线相对坐标中。
    
    另请参见：
    
    getCaretShapes(int, Rectangle2D, TextLayout.CaretPolicy) ， Font.getItalicAngle()
  - getCaretInfo
```
public float[] getCaretInfo(TextHitInfo hit)
```
    返回与hit相对应的插入符的hit 。此方法是一个方便过载getCaretInfo ，并使用此的自然边界TextLayout 。
    
    参数
    
    hit - 在这个 TextLayout一个字符的 TextLayout
    
    结果
    
    关于与命中对应的插入符号的信息。返回的插入符号信息在基线相对坐标中。
  - getNextRightHit
```
public TextHitInfo getNextRightHit(TextHitInfo hit)
```
    返回右侧（下）的下一个插入符号的命中; 如果没有这样的命中，返回null 。如果命中字符索引超出范围，则抛出IllegalArgumentException 。
    
    参数
    
    hit - 这个布局中一个角色的命中
    
    结果
    
    一个命中，其插入符号出现在提供的命中的插入符号右侧（底部）的下一个位置或 null 。
  - getNextRightHit
```
public TextHitInfo getNextRightHit(int offset,
                                   TextLayout.CaretPolicy policy)
```
    返回右侧（下）的下一个插入符号的命中; 如果没有这样的命中，返回null 。按照指定的策略确定，指定的偏移量处于右侧的强插销符号。返回的命中是指定策略确定的两个可能命中之一。
    
    参数
    
    offset - 在此TextLayout插入偏移量。不能小于0或大于此TextLayout对象的字符数。
    
    policy - 用于选择强 policy的策略
    
    结果
    
    一个命中，其插入符号出现在提供的命中的插入符号右侧（底部）的下一个位置，或 null 。
  - getNextRightHit
```
public TextHitInfo getNextRightHit(int offset)
```
    返回右侧（下）的下一个插入符号的命中; 如果没有这样的命中，返回null 。按照默认策略确定的指定偏移量，右侧的强插头位于右侧。返回的命中是由默认策略确定的两个可能的命中中更强的。
    
    参数
    
    offset - 在这个TextLayout插入偏移量。不能小于0或大于TextLayout对象的字符数。
    
    结果
    
    一个命中，其插入符号出现在提供的命中的插入符号右侧（底部）的下一个位置，或 null 。
  - getNextLeftHit
```
public TextHitInfo getNextLeftHit(TextHitInfo hit)
```
    返回左侧（顶部）的下一个插入符号的命中; 如果没有这样的命中，返回null 。如果命中字符索引超出范围，则抛出IllegalArgumentException 。
    
    参数
    
    hit - 这个 TextLayout一个字符的 TextLayout 。
    
    结果
    
    一个命中，其插入符号出现在提供的命中的插入符号左侧（顶部）的下一个位置，或 null 。
  - getNextLeftHit
```
public TextHitInfo getNextLeftHit(int offset,
                                  TextLayout.CaretPolicy policy)
```
    返回左侧（顶部）的下一个插入符号的命中; 如果没有这样的命中，返回null 。击打位于指定偏移处的强插销符号的左侧，由指定的策略确定。返回的命中是指定策略确定的两个可能命中之一。
    
    参数
    
    offset -一个插入在该偏移TextLayout 。不能小于0或大于此TextLayout对象的字符数。
    
    policy - 用于选择强 policy的策略
    
    结果
    
    一个命中，其插入符号出现在提供的命中的插入符号左侧（顶部）的下一个位置，或 null 。
  - getNextLeftHit
```
public TextHitInfo getNextLeftHit(int offset)
```
    返回左侧（顶部）的下一个插入符号的命中; 如果没有这样的命中，返回null 。击打位于指定偏移量的强插销符号左侧，由默认策略确定。返回的命中是由默认策略确定的两个可能的命中中更强的。
    
    参数
    
    offset -一个插入在该偏移TextLayout 。不能小于0或大于此TextLayout对象的字符数。
    
    结果
    
    一个命中，其插入符号出现在提供的命中的插入符号左侧（顶部）的下一个位置，或 null 。
  - getVisualOtherHit
```
public TextHitInfo getVisualOtherHit(TextHitInfo hit)
```
    返回指定命中的插入符号对面的命中。
    
    参数
    
    hit - 指定的命中
    
    结果
    
    在指定的命中的插入符号的对面的一个打击。
  - getCaretShape
```
public Shape getCaretShape(TextHitInfo hit,
                           Rectangle2D bounds)
```
    返回一个Shape，表示指定边界内指定点的插入符号。
    
    参数
    
    hit - 生成插入符号的命中
    
    bounds - 用于生成插入符号的TextLayout的范围。边界在基线相对坐标。
    
    结果
    
    一个Shape代表插入符号。返回的形状是标准坐标。
  - getCaretShape
```
public Shape getCaretShape(TextHitInfo hit)
```
    返回 Shape代表在指定的打这个的自然边界中插入符号 TextLayout 。
    
    参数
    
    hit - 生成插入符号的命中
    
    结果
    
    一个Shape代表插入符号。返回的形状是标准坐标。
  - getCharacterLevel
```
public byte getCharacterLevel(int index)
```
    在index返回字符的index 。指数-1和characterCount被分配了这个TextLayout的基准水平。
    
    参数
    
    index - 从中获取级别的角色的索引
    
    结果
    
    在指定索引处的字符级别。
  - getCaretShapes
```
public Shape[] getCaretShapes(int offset,
                              Rectangle2D bounds,
                              TextLayout.CaretPolicy policy)
```
    返回对应于强和弱插入符号的两个路径。
    
    参数
    
    offset - 在这 TextLayout一个抵消
    
    bounds - 扩展bounds的范围。边界在基线相对坐标。
    
    policy - 指定的 CaretPolicy
    
    结果
    
    两个路径的数组。元素零是强插支符号。如果有两个插入符号，元素是弱插入符号，否则为null 。返回的形状是标准坐标。
  - getCaretShapes
```
public Shape[] getCaretShapes(int offset,
                              Rectangle2D bounds)
```
    返回对应于强和弱插入符号的两个路径。此方法是使用默认脱字符策略的getCaretShapes的方便超载。
    
    参数
    
    offset - 这个 TextLayout一个抵消
    
    bounds - 扩展bounds的范围。这是在基线相对坐标。
    
    结果
    
    两个路径对应于强和弱插入符由限定DEFAULT_CARET_POLICY 。这些是标准坐标。
  - getCaretShapes
```
public Shape[] getCaretShapes(int offset)
```
    返回对应于强和弱插入符号的两个路径。这种方法的便捷用法getCaretShapes使用默认插入符策略和此TextLayout对象的自然边界。
    
    参数
    
    offset - 在这 TextLayout一个抵消
    
    结果
    
    两个路径对应于强和弱插入符由限定DEFAULT_CARET_POLICY 。这些是标准坐标。
  - getLogicalRangesForVisualSelection
```
public int[] getLogicalRangesForVisualSelection(TextHitInfo firstEndpoint,
                                                TextHitInfo secondEndpoint)
```
    返回与视觉选择对应的文本的逻辑范围。
    
    参数
    
    firstEndpoint - 视觉范围的终点
    
    secondEndpoint - 视觉范围的另一端点。该端点可以小于firstEndpoint 。
    
    结果
    
    一组整数，表示所选范围的起始/极限对。
    
    另请参见：
    
    getVisualHighlightShape(TextHitInfo, TextHitInfo, Rectangle2D)
  - getVisualHighlightShape
```
public Shape getVisualHighlightShape(TextHitInfo firstEndpoint,
                                     TextHitInfo secondEndpoint,
                                     Rectangle2D bounds)
```
    返回包含指定范围内的视觉选择的路径，扩展为bounds 。
    如果选择包括最左边的（最上面的）位置时，该选择被扩展到的左侧（顶部） bounds 。如果选择包括最右边（最下）位置，则选择将扩展到边界的右侧（底部）。选择的高度（垂直线宽度）始终扩展为bounds 。
    
    虽然选择始终是连续的，但逻辑选择的文本在具有混合方向文本的行上可能是不连续的。可以使用getLogicalRangesForVisualSelection所选文本的逻辑范围。例如，考虑文本“ABCdef”，大写字母表示从右到左的文本，从右到左的行显示，从0L的视觉选择（“A”的前沿）到3T（尾随'd'的边缘）。文本显示如下，粗体下划线区域表示选择：
```
  defCBA  
```
    逻辑选择范围为0-3,4-6（ABC，ef），因为视觉上连续的文本在逻辑上是不连续的。还要注意的是，由于布局上的最右边的位置（在'A'的右边）被选中，所以选择被扩展到边界的右边。
    参数
    
    firstEndpoint - 视觉选择的一端
    
    secondEndpoint - 视觉选择的另一端
    
    bounds - 扩展选择的边界矩形。这是在基线相对坐标。
    
    结果
    
    一个Shape封闭选择。这是在标准坐标。
    
    另请参见：
    
    getLogicalRangesForVisualSelection(TextHitInfo, TextHitInfo) ， getLogicalHighlightShape(int, int, Rectangle2D)
  - getVisualHighlightShape
```
public Shape getVisualHighlightShape(TextHitInfo firstEndpoint,
                                     TextHitInfo secondEndpoint)
```
    返回一个Shape在指定范围内的视觉选择的Shape，扩展到边界。此方法是一个方便过载getVisualHighlightShape使用此的自然边界TextLayout 。
    
    参数
    
    firstEndpoint - 视觉选择的一端
    
    secondEndpoint - 视觉选择的另一端
    
    结果
    
    一个Shape封闭选择。这是在标准坐标。
  - getLogicalHighlightShape
```
public Shape getLogicalHighlightShape(int firstEndpoint,
                                      int secondEndpoint,
                                      Rectangle2D bounds)
```
    返回一个Shape将逻辑选择包含在指定的范围内，扩展到指定的bounds 。
    如果选择范围包括所述第一逻辑字符，则选择被扩展到的所述部分bounds此开始前TextLayout 。如果该范围包括最后的逻辑字符，选择被扩展到的所述部分bounds此结束后TextLayout 。选择的高度（垂直线上的宽度）始终扩展为bounds 。
    
    在具有混合方向文本的行上，选择可以是不连续的。只有开始和关闭之间逻辑范围内的这些字符才会显示出来。例如，考虑文本“ABCdef”，其中大写字母表示从右到左的文本，以从右到左的行显示，逻辑选择从0到4（“ABCd”）。文字显示如下，粗体字用于选择，下划线为扩展名：
```
  defCBA  
```
    选择是不连续的，因为所选择的字符在视觉上是不连续的。还要注意的是，由于该范围包括所述第一逻辑字符（A），选择被扩展到的所述部分bounds的布局，这在这种情况下（右到左线）的右侧部分的开始前bounds 。
    参数
    
    firstEndpoint - 要选择的字符范围内的端点
    
    secondEndpoint - 要选择的其他端点的字符范围。可以低于firstEndpoint 。范围包括min（firstEndpoint，secondEndpoint）的字符，但不包括max（firstEndpoint，secondEndpoint）。
    
    bounds - 用于扩展选择的边界矩形。这是在基线相对坐标。
    
    结果
    
    包围选区的区域。这是在标准坐标。
    
    另请参见：
    
    getVisualHighlightShape(TextHitInfo, TextHitInfo, Rectangle2D)
  - getLogicalHighlightShape
```
public Shape getLogicalHighlightShape(int firstEndpoint,
                                      int secondEndpoint)
```
    返回一个Shape将逻辑选择包含在指定范围内，扩展到此TextLayout 。此方法是一个方便过载getLogicalHighlightShape使用此的自然边界TextLayout 。
    
    参数
    
    firstEndpoint - 要选择的字符范围内的端点
    
    secondEndpoint - 要选择的字符范围的另一个端点。可以少于firstEndpoint 。范围包括min（firstEndpoint，secondEndpoint）的字符，但不包括max（firstEndpoint，secondEndpoint）。
    
    结果
    
    一个Shape封闭选择。这是在标准坐标。
  - getBlackBoxBounds
```
public Shape getBlackBoxBounds(int firstEndpoint,
                               int secondEndpoint)
```
    返回指定范围内的字符的黑框边界。黑框边界是由对应于开始和限制之间的字符的所有字形的边界框的并集组成的区域。这个区域可以是不相交的。
    
    参数
    
    firstEndpoint - 字符范围的一端
    
    secondEndpoint - 另一端的字符范围。可以小于firstEndpoint 。
    
    结果
    
    一个Shape封闭黑盒边界。这是在标准坐标。
  - hitTestChar
```
public TextHitInfo hitTestChar(float x,
                               float y,
                               Rectangle2D bounds)
```
    返回TextHitInfo对应于指定点。在TextLayout映射的范围之外的TextLayout地在第一个逻辑字符的前沿或最后一个逻辑字符的后沿，而不管该字符在行中的位置。只有沿着基准线的方向才被用来做这个评估。
    
    参数
    
    x - 从这个TextLayout的起点的x偏移。这是在标准坐标。
    
    y - 从这个TextLayout的起点的y偏移。这是在标准坐标。
    
    bounds -的的界限TextLayout 。这是在基线相对坐标。
    
    结果
    
    描述指定点下的字符和边缘（前导或尾部）的命中。
  - hitTestChar
```
public TextHitInfo hitTestChar(float x,
                               float y)
```
    返回TextHitInfo对应于指定点。此方法是一个方便过载hitTestChar使用此的自然边界TextLayout 。
    
    参数
    
    x - 从这个TextLayout的起点的x偏移。这是在标准坐标。
    
    y - 从这个TextLayout的起点的y偏移。这是在标准坐标。
    
    结果
    
    描述指定点下的字符和边缘（前导或尾部）的命中。
  - hashCode
```
public int hashCode()
```
    返回此 TextLayout的哈希码。
    
    重写：
    
    hashCode在 Object类
    
    结果
    
    这个 TextLayout的哈希码。
    
    另请参见：
    
    Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)
  - equals
```
public boolean equals(Object obj)
```
    返回 true如果指定的 Object是 TextLayout对象，如果指定的 Object等于这个 TextLayout 。
    
    重写：
    
    equals在 Object类
    
    参数
    
    obj - 一个 Object以测试平等
    
    结果
    
    true如果指定的Object等于这个TextLayout ; false否则。
    
    另请参见：
    
    Object.hashCode() ， HashMap
  - equals
```
public boolean equals(TextLayout rhs)
```
    如果两个布局相等，则返回true 。如果两个布局以相同的顺序包含相等的符号，则两个布局相等。
    
    参数
    
    rhs - TextLayout与此 TextLayout进行比较
    
    结果
    
    true如果指定的 TextLayout等于这个 TextLayout 。
  - toString
```
public String toString()
```
    返回此 TextLayout 。
    
    重写：
    
    toString在 Object
    
    结果
    
    该 textLine为 TextLayout为 String 。
  - draw
```
public void draw(Graphics2D g2,
                 float x,
                 float y)
```
    在指定的Graphics2D上下文中指定位置呈现此TextLayout 。布局的起点位于x，y处。呈现可能会触及该位置getBounds()内的任何一点。这使g2不变。文本沿基线路径呈现。
    
    参数
    
    g2 - 要渲染布局的 Graphics2D上下文
    
    x - 这个TextLayout的原点的X TextLayout
    
    y - 这个TextLayout的起点的Y TextLayout
    
    另请参见：
    
    getBounds()
  - getOutline
```
public Shape getOutline(AffineTransform tx)
```
    返回代表 Shape TextLayout的大纲的 TextLayout 。
    
    参数
    
    tx - 一个可选的AffineTransform适用于这个TextLayout的大纲。
    
    结果
    
    一个Shape是这个TextLayout的大纲。这是在标准坐标。
  - getLayoutPath
```
public LayoutPath getLayoutPath()
```
    返回LayoutPath，如果布局路径是默认路径，则为null（x映射到advance，y映射到offset）。
    
    结果
    
    布局路径
    
    从以下版本开始：
    
    1.6
  - hitToPoint
```
public void hitToPoint(TextHitInfo hit,
                       Point2D point)
```
    将命中转换为标准坐标中的一个点。该点在字符的前后边缘的基线上，如果合适的话。如果路径在由击中所代表的角色的侧面断开，该点将与该角色相邻。
    
    参数
    
    hit - 打击检查。这必须是TextLayout上的有效命中。
    
    point - 返回点。点在标准坐标。
    
    异常
    
    IllegalArgumentException - 如果命中对TextLayout无效。
    
    NullPointerException - 如果命中或点为空。
    
    从以下版本开始：
    
    1.6

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 TextLayout

Nested Class Summary

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

字段详细信息

DEFAULT_CARET_POLICY

构造方法详细信息

TextLayout

TextLayout

TextLayout

方法详细信息

clone

getJustifiedLayout

handleJustify

getBaseline

getBaselineOffsets

getAdvance

getVisibleAdvance

getAscent

getDescent

getLeading

getBounds

getPixelBounds

isLeftToRight

isVertical

getCharacterCount

getCaretInfo

getCaretInfo

getNextRightHit

getNextRightHit

getNextRightHit

getNextLeftHit

getNextLeftHit

getNextLeftHit

getVisualOtherHit

getCaretShape

getCaretShape

getCharacterLevel

getCaretShapes

getCaretShapes

getCaretShapes

getLogicalRangesForVisualSelection

getVisualHighlightShape

getVisualHighlightShape

getLogicalHighlightShape

getLogicalHighlightShape

getBlackBoxBounds

hitTestChar

hitTestChar

hashCode

equals

equals

toString

draw

getOutline

getLayoutPath

hitToPoint