QTextOption 类提供一般富文本特性的描述。 更多...
| 头： |
#include <QTextOption>
|
| CMake: |
find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
|
| qmake: |
QT += gui
|
注意： 此类的所有函数 可重入 .
| struct | Tab |
| enum | Flag { IncludeTrailingSpaces, ShowTabsAndSpaces, ShowLineAndParagraphSeparators, ShowDocumentTerminator, ShowDefaultIgnorables, …, DisableEmojiParsing } |
| flags | Flags |
| enum | TabType { LeftTab, RightTab, CenterTab, DelimiterTab } |
| enum | WrapMode { NoWrap, WordWrap, ManualWrap, WrapAnywhere, WrapAtWordBoundaryOrAnywhere } |
| QTextOption () | |
| QTextOption (Qt::Alignment alignment ) | |
| QTextOption (const QTextOption & other ) | |
| ~QTextOption () | |
| Qt::Alignment | alignment () const |
| QTextOption::Flags | flags () const |
| void | setAlignment (Qt::Alignment alignment ) |
| void | setFlags (QTextOption::Flags flags ) |
| void | setTabArray (const QList<qreal> & tabStops ) |
| void | setTabStopDistance (qreal tabStopDistance ) |
| void | setTabs (const QList<QTextOption::Tab> & tabStops ) |
| void | setTextDirection (Qt::LayoutDirection direction ) |
| void | setUseDesignMetrics (bool enable ) |
| void | setWrapMode (QTextOption::WrapMode mode ) |
| QList<qreal> | tabArray () const |
| qreal | tabStopDistance () const |
| QList<QTextOption::Tab> | tabs () const |
| Qt::LayoutDirection | textDirection () const |
| bool | useDesignMetrics () const |
| QTextOption::WrapMode | wrapMode () const |
| QTextOption & | operator= (const QTextOption & other ) |
QTextOption 用于把常见富文本特性封装在单对象中。它包含文本对齐、布局方向、自动换行及其它与文本渲染和布局关联的标准特性的有关信息。
另请参阅 QTextEdit , QTextDocument ，和 QTextCursor .
| 常量 | 值 | 描述 |
|---|---|---|
QTextOption::IncludeTrailingSpaces
|
0x80000000
|
当此选项有设置时， QTextLine::naturalTextWidth () and naturalTextRect() will return a value that includes the width of trailing spaces in the text; otherwise this width is excluded. |
QTextOption::ShowTabsAndSpaces
|
0x1
|
Visualize spaces with little dots, and tabs with little arrows. Non-breaking spaces are shown differently to breaking spaces. |
QTextOption::ShowLineAndParagraphSeparators
|
0x2
|
Visualize line and paragraph separators with appropriate symbol characters. |
QTextOption::ShowDocumentTerminator (since Qt 5.7)
|
0x10
|
Visualize the end of the document with a section sign. |
QTextOption::ShowDefaultIgnorables (since Qt 6.9)
|
0x20
|
Render normally non-visual characters if supported by font. |
QTextOption::AddSpaceForLineAndParagraphSeparators
|
0x4
|
While determining the line-break positions take into account the space added for drawing a separator character. |
QTextOption::SuppressColors
|
0x8
|
Suppress all color changes in the character formats (except the main selection). |
QTextOption::DisableEmojiParsing (since Qt 6.9)
|
0x40
|
By default, Qt will detect emoji sequences in input strings and prioritize using color fonts to display them. This extra step can be disabled by setting the DisableEmojiParsing flag if it is known in advance that it will not be needed. |
Flags 类型是 typedef 对于 QFlags <Flag>。它存储 Flag 值的 OR (或) 组合。
此枚举包含不同类型的制表符
| 常量 | 值 | 描述 |
|---|---|---|
QTextOption::LeftTab
|
0
|
左 Tab |
QTextOption::RightTab
|
1
|
右 Tab |
QTextOption::CenterTab
|
2
|
居中 Tab |
QTextOption::DelimiterTab
|
3
|
停在某个定界符处的 Tab |
此枚举描述文本如何在文档中换行。
| 常量 | 值 | 描述 |
|---|---|---|
QTextOption::NoWrap
|
0
|
文本根本不换行。 |
QTextOption::WordWrap
|
1
|
文本在单词边界处换行。 |
QTextOption::ManualWrap
|
2
|
如同 QTextOption::NoWrap |
QTextOption::WrapAnywhere
|
3
|
文本可以在行的任何位置处换行，即使出现在单词中间。 |
QTextOption::WrapAtWordBoundaryOrAnywhere
|
4
|
若可能，在单词边界处换行；否则，换行将出现在行的适当位置处，甚至在单词中间。 |
Constructs a text option with default properties for text. The text alignment property is set to Qt::AlignLeft . The word wrap property is set to QTextOption::WordWrap 。设计指标所用标志被设为 false。
构造文本选项采用给定 alignment 为文本。单词换行特性被设为 QTextOption::WordWrap 。设计指标所用标志被设为 false。
构造副本为 other 文本选项。
[noexcept]
QTextOption::
~QTextOption
()
销毁文本选项。
返回由选项定义的文本对齐方式。
另请参阅 setAlignment ().
返回与选项关联的标志。
另请参阅 setFlags ().
将选项的文本对齐方式设为指定 alignment .
另请参阅 alignment ().
Sets the flags associated with the option to the given flags .
另请参阅 flags ().
Sets the tab positions for the text layout to those specified by tabStops .
另请参阅 tabArray (), setTabStopDistance ()，和 setTabs ().
Sets the default distance in device units between tab stops to the value specified by tabStopDistance .
另请参阅 tabStopDistance (), setTabArray (), setTabs ()，和 tabs ().
Sets the tab positions for the text layout to those specified by tabStops .
另请参阅 tabs () 和 tabStopDistance ().
Sets the direction of the text layout defined by the option to the given direction .
另请参阅 textDirection ().
若 enable is true then the layout will use design metrics; otherwise it will use the metrics of the paint device (which is the default behavior).
另请参阅 useDesignMetrics ().
Sets the option's text wrap mode to the given mode .
另请参阅 wrapMode ().
Returns a list of tab positions defined for the text layout.
另请参阅 setTabArray () 和 tabStopDistance ().
Returns the distance in device units between tab stops.
另请参阅 setTabStopDistance (), tabArray (), setTabs ()，和 tabs ().
Returns a list of tab positions defined for the text layout.
另请参阅 tabStopDistance (), setTabs ()，和 setTabStopDistance ().
Returns the direction of the text layout defined by the option.
另请参阅 setTextDirection ().
返回
true
if the layout uses design rather than device metrics; otherwise returns
false
.
另请参阅 setUseDesignMetrics ().
返回由选项定义的文本换行模式。
另请参阅 setWrapMode ().
返回
true
若文本选项如同
other
文本选项；否则返回
false
.