java.awt.font

Class LineBreakMeasurer

java.lang.Object

java.awt.font.LineBreakMeasurer

public final class LineBreakMeasurer
extends Object

的 LineBreakMeasurer类允许样式文本被分解成线（或段），适合在一个特定的视觉发展。这为客户谁想要显示一段文字，适合一个特定的宽度范围内是有用的，称为 包边宽度。

LineBreakMeasurer与样式文本迭代器构造。迭代器的范围应该是文本中的一个段落。LineBreakMeasurer保持文本的位置为下一段的开始。最初，这个位置是文本的开始。根据双向格式规则，段落被分配一个整体方向（左到右或右向左）。从段落获得的所有片段与段落有相同的方向。

通过调用该方法nextLayout得到文本段，它返回一个TextLayout表示适合在包边宽度的文本。的nextLayout方法把当前位置移到布局结束返回nextLayout。

LineBreakMeasurer实现最常用的线打破政策：每一个字，适合包装宽度内放置就行了。如果第一个字不适合，那么所有的字符，适合在包装宽度放在线。至少一个字符被放置在每一行上。

的TextLayout实例返回LineBreakMeasurer对待标签像0-width空间。客户希望获得制表符分隔段的定位应使用nextLayout以限制在文本偏移超载。限制偏移量应该是标签后的第一个字符。此方法返回的对象TextLayout端在规定（或之前，如果当前位置和极限之间的文本不适合完全在包边宽度）。

正在铺设制表符分隔的文本的客户需要在第一个段被放置在一行之后，需要一个稍微不同的行断策略。在其余的空间中，而不是拟合部分的话，他们应该放置不适合在剩余的空间完全在下一行的话。这一政策的改变可以在nextLayout以boolean参数过载要求。如果这个参数是true，nextLayout返回null如果第一句不适合给定的空间。见下面的标签示例。

一般来说，如果用于构建LineBreakMeasurer变化的文本，一种新的LineBreakMeasurer必须建立反映变化。（老LineBreakMeasurer继续正常工作，但它不会意识到文本改变。）然而，如果文本是一个字符的插入或缺失，现有的LineBreakMeasurer可以通过调用insertChar或deleteChar更新，更新现有的LineBreakMeasurer比创造一个新的快得多。基于用户键入的修改文本的客户端应该利用这些方法。

实例：

在组件中渲染一个段落

 public void paint(Graphics graphics) {

     Point2D pen = new Point2D(10, 20);
     Graphics2D g2d = (Graphics2D)graphics;
     FontRenderContext frc = g2d.getFontRenderContext();

     // let styledText be an AttributedCharacterIterator containing at least
     // one character

     LineBreakMeasurer measurer = new LineBreakMeasurer(styledText, frc);
     float wrappingWidth = getSize().width - 15;

     while (measurer.getPosition() < fStyledText.length()) {

         TextLayout layout = measurer.nextLayout(wrappingWidth);

         pen.y += (layout.getAscent());
         float dx = layout.isLeftToRight() ?
             0 : (wrappingWidth - layout.getAdvance());

         layout.draw(graphics, pen.x + dx, pen.y);
         pen.y += layout.getDescent() + layout.getLeading();
     }
 }
 

用标签渲染文本。为了简单起见，整体的文本方向被假定为左到右

 public void paint(Graphics graphics) {

     float leftMargin = 10, rightMargin = 310;
     float[] tabStops = { 100, 250 };

     // assume styledText is an AttributedCharacterIterator, and the number
     // of tabs in styledText is tabCount

     int[] tabLocations = new int[tabCount+1];

     int i = 0;
     for (char c = styledText.first(); c != styledText.DONE; c = styledText.next()) {
         if (c == '\t') {
             tabLocations[i++] = styledText.getIndex();
         }
     }
     tabLocations[tabCount] = styledText.getEndIndex() - 1;

     // Now tabLocations has an entry for every tab's offset in
     // the text.  For convenience, the last entry is tabLocations
     // is the offset of the last character in the text.

     LineBreakMeasurer measurer = new LineBreakMeasurer(styledText);
     int currentTab = 0;
     float verticalPos = 20;

     while (measurer.getPosition() < styledText.getEndIndex()) {

         // Lay out and draw each line.  All segments on a line
         // must be computed before any drawing can occur, since
         // we must know the largest ascent on the line.
         // TextLayouts are computed and stored in a Vector;
         // their horizontal positions are stored in a parallel
         // Vector.

         // lineContainsText is true after first segment is drawn
         boolean lineContainsText = false;
         boolean lineComplete = false;
         float maxAscent = 0, maxDescent = 0;
         float horizontalPos = leftMargin;
         Vector layouts = new Vector(1);
         Vector penPositions = new Vector(1);

         while (!lineComplete) {
             float wrappingWidth = rightMargin - horizontalPos;
             TextLayout layout =
                     measurer.nextLayout(wrappingWidth,
                                         tabLocations[currentTab]+1,
                                         lineContainsText);

             // layout can be null if lineContainsText is true
             if (layout != null) {
                 layouts.addElement(layout);
                 penPositions.addElement(new Float(horizontalPos));
                 horizontalPos += layout.getAdvance();
                 maxAscent = Math.max(maxAscent, layout.getAscent());
                 maxDescent = Math.max(maxDescent,
                     layout.getDescent() + layout.getLeading());
             } else {
                 lineComplete = true;
             }

             lineContainsText = true;

             if (measurer.getPosition() == tabLocations[currentTab]+1) {
                 currentTab++;
             }

             if (measurer.getPosition() == styledText.getEndIndex())
                 lineComplete = true;
             else if (horizontalPos >= tabStops[tabStops.length-1])
                 lineComplete = true;

             if (!lineComplete) {
                 // move to next tab stop
                 int j;
                 for (j=0; horizontalPos >= tabStops[j]; j++) {}
                 horizontalPos = tabStops[j];
             }
         }

         verticalPos += maxAscent;

         Enumeration layoutEnum = layouts.elements();
         Enumeration positionEnum = penPositions.elements();

         // now iterate through layouts and draw them
         while (layoutEnum.hasMoreElements()) {
             TextLayout nextLayout = (TextLayout) layoutEnum.nextElement();
             Float nextPosition = (Float) positionEnum.nextElement();
             nextLayout.draw(graphics, nextPosition.floatValue(), verticalPos);
         }

         verticalPos += maxDescent;
     }
 }
 

另请参见：

TextLayout

构造方法摘要

构造方法

Constructor and Description
LineBreakMeasurer(AttributedCharacterIterator text, BreakIterator breakIter, FontRenderContext frc) 构建了一个指定的文本 LineBreakMeasurer。
LineBreakMeasurer(AttributedCharacterIterator text, FontRenderContext frc) 构建了一个指定的文本 LineBreakMeasurer。

方法摘要

Modifier and Type	Method and Description
void	deleteChar(AttributedCharacterIterator newParagraph, int deletePos) 这 LineBreakMeasurer更新后一个字符是从文本中删除，并设置段落的开头的当前位置。
int	getPosition() 返回该 LineBreakMeasurer当前位置。
void	insertChar(AttributedCharacterIterator newParagraph, int insertPos) 这 LineBreakMeasurer更新后一个字符插入文本，并设置段落的开头的当前位置。
TextLayout	nextLayout(float wrappingWidth) 返回下一个布局，并更新当前位置。
TextLayout	nextLayout(float wrappingWidth, int offsetLimit, boolean requireNextWord) 返回下一个布局，并更新当前位置。
int	nextOffset(float wrappingWidth) 返回下一个布局的结束位置。
int	nextOffset(float wrappingWidth, int offsetLimit, boolean requireNextWord) 返回下一个布局的结束位置。
void	setPosition(int newPosition) 设置此 LineBreakMeasurer当前位置。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LineBreakMeasurer

public LineBreakMeasurer(AttributedCharacterIterator text,
                         FontRenderContext frc)

构建了一个指定的文本 LineBreakMeasurer。

参数

text -这 LineBreakMeasurer产生 TextLayout对象的文本；文本必须至少包含一个字符；如果可以通过 iter变化的文本，再调用此 LineBreakMeasurer实例是不确定的（但在一些情况下，当 insertChar或 deleteChar调用之后-见下文）

frc -包含一个图形设备，需要正确衡量文本信息；文本的测量可以略有不同的设备分辨率不同，属性如抗锯齿；这个参数没有指定 LineBreakMeasurer和用户空间之间的翻译

另请参见：

insertChar(java.text.AttributedCharacterIterator, int)， deleteChar(java.text.AttributedCharacterIterator, int)

LineBreakMeasurer

public LineBreakMeasurer(AttributedCharacterIterator text,
                         BreakIterator breakIter,
                         FontRenderContext frc)

构建了一个指定的文本 LineBreakMeasurer。

参数

text -这 LineBreakMeasurer产生 TextLayout对象的文本；文本必须至少包含一个字符；如果可以通过 iter变化的文本，再调用此 LineBreakMeasurer实例是不确定的（但在一些情况下，当 insertChar或 deleteChar调用之后-见下文）

breakIter -定义 BreakIterator换行

frc -包含一个图形设备，需要正确衡量文本信息；文本的测量可以略有不同的设备分辨率不同，属性如抗锯齿；这个参数没有指定 LineBreakMeasurer和用户空间之间的翻译

异常

IllegalArgumentException -如果文本已经小于一个字符

另请参见：

insertChar(java.text.AttributedCharacterIterator, int)， deleteChar(java.text.AttributedCharacterIterator, int)

方法详细信息

nextOffset

public int nextOffset(float wrappingWidth)

返回下一个布局的结束位置。不更新此 LineBreakMeasurer当前位置。

参数

wrappingWidth -在未来布局文本允许的最大可见的进展

结果

在代表未来 TextLayout极限文本偏移。

nextOffset

public int nextOffset(float wrappingWidth,
                      int offsetLimit,
                      boolean requireNextWord)

返回下一个布局的结束位置。不更新此 LineBreakMeasurer当前位置。

参数

wrappingWidth -在未来布局文本允许的最大可见的进展

offsetLimit -第一个字符，不能包含在未来的布局，即使限制后的文本将符合包装宽度； offsetLimit必须大于当前位置

requireNextWord -如果 true，当前位置，如果整个一词不符合 wrappingWidth返回；如果 false，偏移量返回至少有一个大于当前位置

结果

在代表未来 TextLayout极限文本偏移

nextLayout

public TextLayout nextLayout(float wrappingWidth)

返回下一个布局，并更新当前位置。

参数

wrappingWidth -在未来布局文本允许的最大可见的进展

结果

一个 TextLayout，从当前位置开始，这是在 wrappingWidth下直线拟合

nextLayout

public TextLayout nextLayout(float wrappingWidth,
                             int offsetLimit,
                             boolean requireNextWord)

返回下一个布局，并更新当前位置。

参数

wrappingWidth -在未来布局文本允许的最大可见的进展

offsetLimit -第一个字符，不能包含在未来的布局，即使限制后的文本将符合包装宽度； offsetLimit必须大于当前位置

requireNextWord -如果 true，如果当前位置的整个词不符合包装的宽度， null返回。如果 false，有效的布局还包括至少在当前位置的字符

结果

一个 TextLayout，从当前位置开始，表示在 wrappingWidth下直线拟合。如果当前位置是在这个 LineBreakMeasurer使用文本的结束， null返回

getPosition

public int getPosition()

返回该 LineBreakMeasurer当前位置。

结果

这 LineBreakMeasurer当前位置

另请参见：

setPosition(int)

setPosition

public void setPosition(int newPosition)

设置此 LineBreakMeasurer当前位置。

参数

newPosition -这 LineBreakMeasurer当前位置；位置应在用于构建这 LineBreakMeasurer文本（或文本最近通过 insertChar或 deleteChar

另请参见：

getPosition()

insertChar

public void insertChar(AttributedCharacterIterator newParagraph,
                       int insertPos)

这 LineBreakMeasurer更新后一个字符插入文本，并设置段落的开头的当前位置。

参数

newParagraph后插入文本

insertPos -位置在文本中所插入的字符

异常

IndexOutOfBoundsException -如果 newParagraph insertPos小于或大于或等于 newParagraph结束的开始

如果是 null newParagraph NullPointerException

另请参见：

deleteChar(java.text.AttributedCharacterIterator, int)

deleteChar

public void deleteChar(AttributedCharacterIterator newParagraph,
                       int deletePos)

这 LineBreakMeasurer更新后一个字符是从文本中删除，并设置段落的开头的当前位置。

参数

newParagraph后删除文本

deletePos -位置在文本的字符被删除

异常

IndexOutOfBoundsException -如果 deletePos小于或大于 newParagraph newParagraph结束的开始

如果是 null newParagraph NullPointerException

另请参见：

insertChar(java.text.AttributedCharacterIterator, int)