Макеты документов

Макет документа актуален только при отображении его на устройстве или при запросе информации, требующей визуального представления документа. До тех пор, пока это не произойдет, документ не нуждается в форматировании и подготовке для устройства.

Обзор

Макет каждого документа управляется подклассом класса QAbstractTextDocumentLayout. Этот класс предоставляет общий интерфейс для механизмов макета и рендеринга. Текущее поведение по умолчанию для рендеринга реализовано в закрытом классе. Такой подход позволяет создавать пользовательские макеты и обеспечивает механизм, используемый при подготовке страниц для печати или экспорта в файлы Portable Document Format (PDF).

Пример - Макет текста с формой

Иногда важно форматировать обычный текст в области произвольной формы, например, при рендеринге пользовательского виджета. Scribe предоставляет общие функции, такие как те, что предоставляются классом QTextLayout, чтобы помочь разработчикам выполнять задачи по переводу слов и макетированию, не создавая предварительно документ.

Форматирование и отрисовка абзаца простого текста просты. Приведенный ниже пример покажет макет абзаца текста, используя один шрифт, вокруг правой стороны круга.

    QTextLayout textLayout(text, font);
    qreal margin = 10;
    qreal radius = qMin(width()/2.0, height()/2.0) - margin;
    QFontMetrics fm(font);

    qreal lineHeight = fm.height();
    qreal y = 0;

    textLayout.beginLayout();

    while (1) {
        // create a new line
        QTextLine line = textLayout.createLine();
        if (!line.isValid())
            break;

        qreal x1 = qMax(0.0, pow(pow(radius,2)-pow(radius-y,2), 0.5));
        qreal x2 = qMax(0.0, pow(pow(radius,2)-pow(radius-(y+lineHeight),2), 0.5));
        qreal x = qMax(x1, x2) + margin;
        qreal lineWidth = (width() - margin) - x;

        line.setLineWidth(lineWidth);
        line.setPosition(QPointF(x, margin+y));
        y += line.height();
    }

    textLayout.endLayout();

    QPainter painter;
    painter.begin(this);
    painter.setRenderHint(QPainter::Antialiasing);
    painter.fillRect(rect(), Qt::white);
    painter.setBrush(QBrush(Qt::black));
    painter.setPen(QPen(Qt::black));
    textLayout.draw(&painter, QPoint(0,0));

    painter.setBrush(QBrush(QColor("#a6ce39")));
    painter.setPen(QPen(Qt::black));
    painter.drawEllipse(QRectF(-radius, margin, 2*radius, 2*radius));
    painter.end();

Мы создаём макет текста, задавая строку текста, которую хотим отобразить, и шрифт для использования. Мы убеждаемся, что предоставленный нами текст отформатирован правильно, получая строки текста из формата текста и обрезая оставшийся текст, используя доступное пространство. Строки позиционируются по мере продвижения вниз по странице.

Отформатированный текст может быть нарисован на устройстве рисования; в приведенном выше коде текст отображается непосредственно на виджете.