Класс QTextFrameFormat
Класс QTextFrameFormat предоставляет информацию о форматировании фреймов в QTextDocument. Подробнее...
| Заголовок: | #include <QTextFrameFormat> |
| CMake: | find_package(Qt6 COMPONENTS Gui REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Наследует: | QTextFormat |
| Наследует классы: |
Примечание: Все функции в этом классе являются входно-синхронизированными (reentrant).
Открытые типы
| перечисление | BorderStyle { BorderStyle_None, BorderStyle_Dotted, BorderStyle_Dashed, BorderStyle_Solid, BorderStyle_Double, …, BorderStyle_Outset } |
| перечисление | Position { InFlow, FloatLeft, FloatRight } |
Открытые функции
| QTextFrameFormat() | |
| qreal | border() const |
| QBrush | borderBrush() const |
| QTextFrameFormat::BorderStyle | borderStyle() const |
| qreal | bottomMargin() const |
| QTextLength | height() const |
| bool | isValid() const |
| qreal | leftMargin() const |
| qreal | margin() const |
| qreal | padding() const |
| QTextFormat::PageBreakFlags | pageBreakPolicy() const |
| QTextFrameFormat::Position | position() const |
| qreal | rightMargin() const |
| void | setBorder(qreal width) |
| void | setBorderBrush(const QBrush &brush) |
| void | setBorderStyle(QTextFrameFormat::BorderStyle style) |
| void | setBottomMargin(qreal margin) |
| void | setHeight(const QTextLength &height) |
| void | setHeight(qreal height) |
| void | setLeftMargin(qreal margin) |
| void | setMargin(qreal margin) |
| void | setPadding(qreal width) |
| void | setPageBreakPolicy(QTextFormat::PageBreakFlags policy) |
| void | setPosition(QTextFrameFormat::Position policy) |
| void | setRightMargin(qreal margin) |
| void | setTopMargin(qreal margin) |
| void | setWidth(const QTextLength &width) |
| void | setWidth(qreal width) |
| qreal | topMargin() const |
| QTextLength | width() const |
Подробное описание
Фрейм текста группирует один или несколько блоков текста, предоставляя уровень структуры, больший, чем абзац. Формат фрейма определяет, как он отображается и позиционируется на экране. Он не напрямую определяет поведение форматирования текста внутри, но задаёт ограничения на расположение его дочерних элементов.
Формат фрейма определяет width() и height() фрейма на экране. Каждый фрейм может иметь border(), который окружает его содержимое прямоугольной рамкой. Граница окружена margin() вокруг фрейма, а содержимое фрейма отделено от границы отступом padding(). Эта схема аналогична модели ячеек, используемой Cascading Style Sheets для HTML-страниц.
Позиция position() фрейма устанавливается с помощью setPosition() и определяет, как он расположен относительно окружающего текста.
Действительность объекта QTextFrameFormat можно определить с помощью функции isValid().
См. также QTextFrame и QTextBlockFormat.
Документация по типам членов
перечисление QTextFrameFormat::BorderStyle
Это перечисление описывает различные стили границ для фрейма текста.
| Константа | Значение |
|---|---|
QTextFrameFormat::BorderStyle_None |
0 |
QTextFrameFormat::BorderStyle_Dotted |
1 |
QTextFrameFormat::BorderStyle_Dashed |
2 |
QTextFrameFormat::BorderStyle_Solid |
3 |
QTextFrameFormat::BorderStyle_Double |
4 |
QTextFrameFormat::BorderStyle_DotDash |
5 |
QTextFrameFormat::BorderStyle_DotDotDash |
6 |
QTextFrameFormat::BorderStyle_Groove |
7 |
QTextFrameFormat::BorderStyle_Ridge |
8 |
QTextFrameFormat::BorderStyle_Inset |
9 |
QTextFrameFormat::BorderStyle_Outset |
10 |
См. также borderStyle() и FrameBorderStyle.
перечисление QTextFrameFormat::Position
Это перечисление описывает, как фрейм расположен относительно окружающего текста.
| Константа | Значение |
|---|---|
QTextFrameFormat::InFlow |
0 |
QTextFrameFormat::FloatLeft |
1 |
QTextFrameFormat::FloatRight |
2 |
См. также position() и CssFloat.
Документация по функциям членов
QTextFrameFormat::QTextFrameFormat()
Создаёт объект формата фрейма текста со свойствами по умолчанию.
qreal QTextFrameFormat::border() const
Возвращает ширину рамки в пикселях.
См. также setBorder().
QBrush QTextFrameFormat::borderBrush() const
Возвращает кисть, используемую для рамки.
См. также setBorderBrush().
QTextFrameFormat::BorderStyle QTextFrameFormat::borderStyle() const
Возвращает стиль рамки.
См. также setBorderStyle().
qreal QTextFrameFormat::bottomMargin() const
Возвращает ширину нижнего отступа рамки в пикселях.
См. также setBottomMargin().
QTextLength QTextFrameFormat::height() const
Возвращает высоту прямоугольника рамки.
См. также setHeight().
bool QTextFrameFormat::isValid() const
Возвращает true, если описание формата валидно; в противном случае возвращает false.
qreal QTextFrameFormat::leftMargin() const
Возвращает ширину левого отступа рамки в пикселях.
См. также setLeftMargin().
qreal QTextFrameFormat::margin() const
Возвращает ширину внешнего отступа рамки в пикселях.
См. также setMargin().
qreal QTextFrameFormat::padding() const
Возвращает ширину внутреннего отступа рамки в пикселях.
См. также setPadding().
QTextFormat::PageBreakFlags QTextFrameFormat::pageBreakPolicy() const
Возвращает текущую политику разрыва страницы для рамки/таблицы. По умолчанию QTextFormat::PageBreak_Auto.
См. также setPageBreakPolicy().
QTextFrameFormat::Position QTextFrameFormat::position() const
Возвращает политику позиционирования для рамок с этим форматом.
См. также setPosition().
qreal QTextFrameFormat::rightMargin() const
Возвращает ширину правого отступа рамки в пикселях.
См. также setRightMargin().
void QTextFrameFormat::setBorder(qreal width)
Устанавливает ширину (в пикселях) рамки.
См. также border().
void QTextFrameFormat::setBorderBrush(const QBrush &brush)
Устанавливает кисть, используемую для рамки.
См. также borderBrush().
void QTextFrameFormat::setBorderStyle(QTextFrameFormat::BorderStyle style)
Устанавливает стиль рамки.
См. также borderStyle().
void QTextFrameFormat::setBottomMargin(qreal margin)
Устанавливает нижний отступ рамки в пикселях.
См. также bottomMargin().
void QTextFrameFormat::setHeight(const QTextLength &height)
Устанавливает высоту рамки.
См. также height().
void QTextFrameFormat::setHeight(qreal height)
Это перегруженный метод.
Устанавливает высоту рамки.
void QTextFrameFormat::setLeftMargin(qreal margin)
Устанавливает левый отступ рамки в пикселях.
См. также leftMargin().
void QTextFrameFormat::setMargin(qreal margin)
Устанавливает отступ рамки в пикселях. Этот метод также устанавливает левые, правые, верхние и нижние отступы рамки в то же значение. Индивидуальные отступы переопределяют общий отступ.
См. также margin().
void QTextFrameFormat::setPadding(qreal width)
Устанавливает ширину внутреннего отступа рамки в пикселях.
См. также padding().
void QTextFrameFormat::setPageBreakPolicy(QTextFormat::PageBreakFlags policy)
Устанавливает политику разрыва страницы для рамки/таблицы на policy.
См. также pageBreakPolicy().
void QTextFrameFormat::setPosition(QTextFrameFormat::Position policy)
Устанавливает policy для позиционирования рамок с этим форматом.
См. также position().
void QTextFrameFormat::setRightMargin(qreal margin)
Устанавливает правый отступ рамки в пикселях.
См. также rightMargin().
void QTextFrameFormat::setTopMargin(qreal margin)
Устанавливает верхний отступ рамки в пикселях.
См. также topMargin().
void QTextFrameFormat::setWidth(const QTextLength &width)
Устанавливает ширину прямоугольника рамки.
См. также width() и QTextLength.
void QTextFrameFormat::setWidth(qreal width)
Это перегруженный метод.
Удобный метод, который устанавливает ширину прямоугольника рамки на указанную фиксированную ширину width.
qreal QTextFrameFormat::topMargin() const
Возвращает ширину верхнего отступа рамки в пикселях.
См. также setTopMargin().
QTextLength QTextFrameFormat::width() const
Возвращает ширину прямоугольника рамки.
См. также setWidth() и QTextLength.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.0/qtextframeformat.html