Класс 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(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;
    }
}