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