En esta página

Diseños de documentos

El diseño de un documento solo es relevante cuando se va a mostrar en un dispositivo o cuando se solicita información que requiera una representación visual del documento. Hasta que esto ocurra, no es necesario dar formato al documento ni prepararlo para un dispositivo.

Descripción general

El diseño de cada documento se gestiona mediante una subclase de la clase ` QAbstractTextDocumentLayout `. Esta clase proporciona una interfaz común para los motores de diseño y representación. El comportamiento de representación predeterminado está implementado actualmente en una clase privada. Este enfoque permite crear diseños personalizados y proporciona el mecanismo utilizado al preparar páginas para su impresión o exportación a archivos en formato PDF (Portable Document Format).

Ejemplo: maquetación de texto con forma

A veces es importante poder dar formato a texto sin formato dentro de una región de forma irregular, por ejemplo, al renderizar un widget personalizado. Scribe proporciona funciones genéricas, como las que ofrece la clase ` QTextLayout `, para ayudar a los desarrolladores a realizar tareas de ajuste de línea y diseño sin necesidad de crear primero un documento.

Captura de pantalla de un texto que se adapta a la forma de un círculo.

Dar formato y dibujar un párrafo de texto sin formato es sencillo. El ejemplo siguiente maquetará un párrafo de texto, utilizando una única fuente, alrededor del borde derecho de un círculo.

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();

Creamos un diseño de texto, especificando la cadena de texto que queremos mostrar y la fuente que se va a utilizar. Nos aseguramos de que el texto que hemos proporcionado esté formateado correctamente obteniendo líneas de texto a partir del formato de texto y ajustando el texto restante al espacio disponible. Las líneas se posicionan a medida que avanzamos por la página.

El texto formateado se puede dibujar en un dispositivo de dibujo; en el código anterior, el texto se dibuja directamente en un widget.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.