QTextFrame Class
La clase QTextFrame representa un marco en un QTextDocument. Más...
| Cabecera: | #include <QTextFrame> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Hereda: | QTextObject |
| Heredado por: |
- Lista de todos los miembros, incluidos los heredados
- QTextFrame es parte de las APIs de Procesamiento de Texto Enriquecido.
Nota: Todas las funciones de esta clase son reentrantes.
Tipos Públicos
Funciones Públicas
| QTextFrame(QTextDocument *document) | |
| virtual | ~QTextFrame() |
| QTextFrame::iterator | begin() const |
| QList<QTextFrame *> | childFrames() const |
| QTextFrame::iterator | end() const |
| QTextCursor | firstCursorPosition() const |
| int | firstPosition() const |
| QTextFrameFormat | frameFormat() const |
| QTextCursor | lastCursorPosition() const |
| int | lastPosition() const |
| QTextFrame * | parentFrame() const |
| void | setFrameFormat(const QTextFrameFormat &format) |
Descripción Detallada
Los marcos de texto proporcionan estructura para el texto en un documento. Se utilizan como contenedores genéricos para otros elementos del documento. Los marcos se crean normalmente utilizando QTextCursor::insertFrame().
Los marcos pueden utilizarse para crear estructuras jerárquicas en documentos de texto enriquecido. Cada documento tiene un marco raíz (QTextDocument::rootFrame()), y cada marco por debajo del marco raíz tiene un marco padre y una lista (posiblemente vacía) de marcos hijos. El marco padre puede encontrarse con parentFrame(), y la función childFrames() proporciona una lista de marcos hijos.
Cada marco contiene al menos un bloque de texto para que los cursores de texto puedan insertar nuevos elementos del documento en su interior. En consecuencia, la clase QTextFrame::iterator se utiliza para recorrer tanto los bloques como los marcos hijos dentro de un marco dado. Los elementos hijo primero y último del marco pueden encontrarse con begin() y end().
Un marco también tiene un formato (especificado con QTextFrameFormat) que puede establecerse con setFormat() y leerse con format().
Se pueden obtener cursores de texto que apunten a la primera y última posición válida del cursor dentro de un marco; utilice para ello las funciones firstCursorPosition() y lastCursorPosition(). La extensión del marco en el documento puede encontrarse con firstPosition() y lastPosition().
Puede iterar sobre el contenido de un marco utilizando la clase QTextFrame::iterator: esto proporciona acceso de sólo lectura a su lista interna de bloques de texto y marcos hijos.
Véase también QTextCursor y QTextDocument.
Documentación de los tipos de miembros
QTextFrame::Iterator
Sinónimo de estilo Qt para QTextFrame::iterator.
Documentación de funciones miembro
[explicit] QTextFrame::QTextFrame(QTextDocument *document)
Crea un nuevo marco vacío para el texto document.
[virtual noexcept] QTextFrame::~QTextFrame()
Destruye el marco de texto.
Advertencia: Los marcos de texto son propiedad del documento, por lo que nunca debe destruirlos usted mismo. Para eliminar un marco de su documento, elimine su contenido utilizando un QTextCursor.
QTextFrame::iterator QTextFrame::begin() const
Devuelve un iterador que apunta al primer elemento del documento dentro del marco. Consulte el documento STL-style-Iterators para más información.
Véase también end().
QList<QTextFrame *> QTextFrame::childFrames() const
Devuelve una lista (posiblemente vacía) de los marcos hijos del marco.
Véase también parentFrame().
QTextFrame::iterator QTextFrame::end() const
Devuelve un iterador que apunta a la posición pasada del último elemento del documento dentro del marco. Consulte el documento STL-Style Iterators para más información.
Véase también begin().
QTextCursor QTextFrame::firstCursorPosition() const
Devuelve la primera posición del cursor dentro del marco.
Véase también lastCursorPosition(), firstPosition() y lastPosition().
int QTextFrame::firstPosition() const
Devuelve la primera posición del documento dentro del marco.
Véase también lastPosition(), firstCursorPosition() y lastCursorPosition().
QTextFrameFormat QTextFrame::frameFormat() const
Devuelve el formato del marco.
Véase también setFrameFormat().
QTextCursor QTextFrame::lastCursorPosition() const
Devuelve la última posición del cursor dentro del marco.
Véase también firstCursorPosition(), firstPosition() y lastPosition().
int QTextFrame::lastPosition() const
Devuelve la última posición del documento dentro del marco.
Véase también firstPosition(), firstCursorPosition() y lastCursorPosition().
QTextFrame *QTextFrame::parentFrame() const
Devuelve el marco padre del marco. Si el marco es el marco raíz de un documento, devolverá 0.
Véase también childFrames() y QTextDocument::rootFrame().
void QTextFrame::setFrameFormat(const QTextFrameFormat &format)
Establece el marco format.
Véase también frameFormat().
© 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.
