class QTextOption#

《QTextOption》类提供了通用富文本属性的描述。《更多》…

简略说明#

方法#

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对片段翻译的贡献。如果您发现翻译中存在问题，您也可以通过在https:/bugreports.qt.io/projects/PYSIDE上创建票证来通知我们。

详细描述#

QTextOption 用于在单个对象中封装常见的富文本属性。它包含关于文本对齐、布局方向、单词换行和其他与文本渲染和布局相关的标准属性的信息。

另请参阅

QTextDocument QTextCursor

class TabType#

此枚举包含不同的制表符类型

常数

描述

QTextOption.LeftTab

左制表符

QTextOption.RightTab

右制表符

QTextOption.CenterTab

居中式制表符

QTextOption.DelimiterTab

在某特定分隔符字符处停止的制表符
class WrapMode#

此枚举描述了文档中文本的换行方式。

常数

描述

QTextOption.NoWrap

文本完全不换行。

QTextOption.WordWrap

文本在词边界处换行。

QTextOption.ManualWrap

与 QTextOption::NoWrap 相同

QTextOption.WrapAnywhere

文本可以换行，即使在行中有任何位置，甚至可以在单词中间。

QTextOption.WrapAtWordBoundaryOrAnywhere

如果可能，则在单词边界处换行；否则，将会在行的适当位置换行，即使是在单词中间。
class Flag#

常数

描述

QTextOption.IncludeTrailingSpaces

(继承自 enum.Flag) 当设置此选项时，naturalTextWidth() 和 naturalTextRect() 将返回包含文本行尾空格宽度的值；否则，此宽度将不包含。

QTextOption.ShowTabsAndSpaces

使用小点来可视化空格，小箭头来表示制表符。非断行空格与断行空格以不同的方式显示。

QTextOption.ShowLineAndParagraphSeparators

使用适当的符号字符可视化行和段落分隔符。

QTextOption.ShowDocumentTerminator

使用节符号可视化文档的结尾。此枚举值是在Qt 5.7中加入的。

QTextOption.AddSpaceForLineAndParagraphSeparators

在确定换行位置时，考虑为绘制分隔符字符而添加的空间。

QTextOption.SuppressColors

抑制字符格式中的所有颜色变化（除主要选择外）。
__init__(alignment)#
参数：

alignment – AlignmentFlag 的组合

构造一个具有给定 alignment 的文本选项。文本自动换行属性被设置为 WordWrap。使用设计度量标志被设置为false。

__init__(o)
参数：

o – QTextOption

构造其他文本选项的副本。

__init__()

使用默认的文本属性构造一个文本选项。文本对齐属性被设置为 Qt::AlignLeft。文本自动换行属性被设置为 WordWrap。使用设计度量标志被设置为false。

alignment()#
返回类型：

AlignmentFlag 的组合

返回由选项定义的文本对齐方式。

另请参阅

setAlignment()

flags()#
返回类型：

Flag 的组合

返回与选项相关的标志。

另请参阅

setFlags()

setAlignment(alignment)#
参数：

alignment – AlignmentFlag 的组合

将选项的文本对齐设置为指定的 alignment。

另请参阅

alignment()

setFlags(flags)#
参数：

flags – Flag 的组合

将与选项相关的标志设置为给定的 flags。

另请参阅

flags()

setTabArray(tabStops)#
参数：

tabStops – .list of qreal

为文本布局设置Tab的停止位置为tabStops中指定的位置。

setTabStopDistance(tabStopDistance)#
参数：

tabStopDistance – float

默认将Tab停止之间的设备单位距离设置为由tabStopDistance指定的值。

setTabs(tabStops)#
参数：

tabStops – .list of QTextOption.Tab

为文本布局设置Tab的停止位置为tabStops中指定的位置。

另请参阅

tabs() tabStopDistance()

setTextDirection(aDirection)#
参数：

aDirection – LayoutDirection

将选项所定义的文本布局的方向设置为给定的direction。

另请参阅

textDirection()

setUseDesignMetrics(b)#
参数：

b – bool

如果enable为true，则布局将使用设计度量；否则，它将使用绘图设备的度量（默认行为）。

另请参阅

useDesignMetrics()

setWrapMode(wrap)#
参数：

wrap – WrapMode

将选项的文本换行模式设置为给定的mode。

另请参阅

wrapMode()

tabArray()#
返回类型：

qreal列表

返回文本布局中定义的制表位位置的列表。

tabStopDistance()#
返回类型：

浮点数

返回制表位之间的设备单位距离。

tabs()#
返回类型：

. QTextOption.Tab 列表

返回文本布局中定义的制表位位置的列表。

textDirection()#
返回类型：

LayoutDirection

返回选项定义的文本布局方向。

另请参阅

setTextDirection()

useDesignMetrics()#
返回类型：

布尔值

如果布局使用设计而非设备度量，则返回true；否则返回false。

另请参阅

setUseDesignMetrics()

wrapMode()#
返回类型：

WrapMode

返回选项定义的文本换行模式。

另请参阅

setWrapMode()