Класс LineBreakMeasurer

public final class LineBreakMeasurer extends Object

Класс LineBreakMeasurer позволяет разбивать форматированный текст на строки (или сегменты), которые помещаются в заданное визуальное поле. Это полезно для клиентов, которые хотят отобразить абзац текста, который помещается в определенную ширину, называемую шириной выравнивания.

LineBreakMeasurer создается с помощью итератора по форматированному тексту. Диапазон итератора должен соответствовать одному абзацу текста. LineBreakMeasurer сохраняет позицию в тексте для начала следующего сегмента текста. Изначально эта позиция — начало текста. Абзацам присваивается общее направление (слева направо или справа налево) в соответствии с правилами форматирования двунаправленного текста. Все сегменты, полученные из абзаца, имеют то же направление, что и абзац.

Сегменты текста получаются с помощью метода nextLayout, который возвращает TextLayout, представляющий текст, который помещается в ширину выравнивания. Метод nextLayout перемещает текущую позицию к концу макета, возвращённого методом nextLayout.

LineBreakMeasurer реализует наиболее часто используемую политику разбиения строк: каждое слово, которое помещается в ширину выравнивания, размещается на строке. Если первое слово не помещается, то все символы, которые помещаются в ширину выравнивания, помещаются на строке. На каждой строке размещается хотя бы один символ.

Экземпляры TextLayout , возвращаемые методом LineBreakMeasurer , обрабатывают табуляции как пробелы нулевой ширины. Клиенты, которые хотят получить сегменты с табуляцией для позиционирования, должны использовать перегрузку nextLayout , которая принимает ограничительный смещение в тексте. Ограничительный смещение должно быть первым символом после табуляции. Объекты TextLayout , возвращаемые этим методом, заканчиваются в указанном пределе (или раньше, если текст между текущей позицией и пределом не помещается полностью в ширину выравнивания).

Клиентам, которые выстраивают текст с табуляцией, после размещения первого сегмента на строке необходима немного другая политика разбиения строк. Вместо того, чтобы помещать части слов в оставшееся пространство, они должны помещать слова, которые не помещаются в оставшееся пространство целиком, на следующую строку. Это изменение политики можно запросить в перегрузке nextLayout , которая принимает параметр boolean . Если этот параметр true, nextLayout возвращает null , если первое слово не поместится в заданное пространство. См. пример с табуляцией ниже.

В общем случае, если текст, используемый для построения LineBreakMeasurer , изменяется, необходимо создать новый LineBreakMeasurer , чтобы отразить изменение. (Старый LineBreakMeasurer продолжает работать должным образом, но он не будет знать об изменении текста.) Тем не менее, если изменение текста заключается во вставке или удалении одного символа, существующий LineBreakMeasurer можно «обновить», вызвав insertChar или deleteChar. Обновление существующего LineBreakMeasurer намного быстрее, чем создание нового. Клиенты, которые изменяют текст, основываясь на вводе пользователя, должны использовать эти методы.

Примеры:

Отображение абзаца в компоненте

 public void paint(Graphics graphics) {

     float dx = 0f, dy = 5f;
     Graphics2D g2d = (Graphics2D)graphics;
     FontRenderContext frc = g2d.getFontRenderContext();

     AttributedString text = new AttributedString(".....");
     AttributedCharacterIterator paragraph = text.getIterator();

     LineBreakMeasurer measurer = new LineBreakMeasurer(paragraph, frc);
     measurer.setPosition(paragraph.getBeginIndex());
     float wrappingWidth = (float)getSize().width;

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

         TextLayout layout = measurer.nextLayout(wrappingWidth);

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

         layout.draw(graphics, dx, dy);
         dy += 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(Float.valueOf(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;
     }
 }