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