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

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

Обзор

Макет каждого документа управляется подклассом класса 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();

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

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