内容

• 公共类型
• 公共函数
• 详细描述

QTextOption 类

QTextOption class provides a description of general rich text properties. 更多...

头：	#include <QTextOption>
qmake:	QT += gui

• 所有成员列表，包括继承成员

注意： 此类的所有函数 可重入 .

公共类型

class	Tab
enum	Flag { IncludeTrailingSpaces, ShowTabsAndSpaces, ShowLineAndParagraphSeparators, ShowDocumentTerminator, AddSpaceForLineAndParagraphSeparators, SuppressColors }
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
Flags	flags () const
void	setAlignment (Qt::Alignment alignment )
void	setFlags (Flags flags )
void	setTabArray (const QList<qreal> & tabStops )
void	setTabStop (qreal tabStop )
void	setTabs (const QList<Tab> & tabStops )
void	setTextDirection (Qt::LayoutDirection direction )
void	setUseDesignMetrics (bool enable )
void	setWrapMode (WrapMode mode )
QList<qreal>	tabArray () const
qreal	tabStop () const
QList<Tab>	tabs () const
Qt::LayoutDirection	textDirection () const
bool	useDesignMetrics () const
WrapMode	wrapMode () const
QTextOption &	operator= (const QTextOption & other )

详细描述

QTextOption class provides a description of general rich text properties.

QTextOption is used to encapsulate common rich text properties in a single object. It contains information about text alignment, layout direction, word wrapping, and other standard properties associated with text rendering and layout.

另请参阅 QTextEdit , QTextDocument ，和 QTextCursor .

成员类型文档编制

enum QTextOption:: Flag
flags QTextOption:: Flags

常量	值	描述
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.
QTextOption::ShowLineAndParagraphSeparators	0x2	Visualize line and paragraph separators with appropriate symbol characters.
QTextOption::ShowDocumentTerminator	0x10	Visualize the end of the document with a section sign. This enum value was added in Qt 5.7.
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).

Flags 类型是 typedef 对于 QFlags <Flag>。它存储 Flag 值的 OR 组合。

enum QTextOption:: TabType

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

常量	值	描述
QTextOption::LeftTab	0	左 Tab
QTextOption::RightTab	1	右 Tab
QTextOption::CenterTab	2	居中 Tab
QTextOption::DelimiterTab	3	停在某个定界符处的 Tab

该枚举在 Qt 4.4 引入或被修改。

enum QTextOption:: WrapMode

此枚举描述文本如何在文档中换行。

常量	值	描述
QTextOption::NoWrap	0	文本根本不换行。
QTextOption::WordWrap	1	文本在单词边界处换行。
QTextOption::ManualWrap	2	如同 QTextOption::NoWrap
QTextOption::WrapAnywhere	3	文本可以在行的任何位置处换行，即使出现在单词中间。
QTextOption::WrapAtWordBoundaryOrAnywhere	4	若可能，在单词边界处换行；否则，换行将出现在行的适当位置处，甚至在单词中间。

成员函数文档编制

QTextOption:: QTextOption ()

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。

QTextOption:: QTextOption ( Qt::Alignment alignment )

构造文本选项采用给定 alignment 为文本。单词换行特性被设为 QTextOption::WordWrap 。设计指标所用标志被设为 false。

QTextOption:: QTextOption (const QTextOption & other )

构造副本为 other 文本选项。

QTextOption:: ~QTextOption ()

销毁文本选项。

Qt::Alignment QTextOption:: alignment () const

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

另请参阅 setAlignment ().

Flags QTextOption:: flags () const

返回与选项关联的标志。

另请参阅 setFlags ().

void QTextOption:: setAlignment ( Qt::Alignment alignment )

将选项的文本对齐方式设为指定 alignment .

另请参阅 alignment ().

void QTextOption:: setFlags ( Flags flags )

Sets the flags associated with the option to the given flags .

另请参阅 flags ().

void QTextOption:: setTabArray (const QList < qreal > & tabStops )

Sets the tab positions for the text layout to those specified by tabStops .

另请参阅 tabArray (), setTabStop ()，和 setTabs ().

void QTextOption:: setTabStop ( qreal tabStop )

Sets the default distance in device units between tab stops to the value specified by tabStop .

另请参阅 tabStop (), setTabArray (), setTabs ()，和 tabs ().

void QTextOption:: setTabs (const QList < Tab > & tabStops )

Set the Tab properties to tabStops .

另请参阅 tabStop () 和 tabs ().

void QTextOption:: setTextDirection ( Qt::LayoutDirection direction )

Sets the direction of the text layout defined by the option to the given direction .

另请参阅 textDirection ().

void QTextOption:: setUseDesignMetrics ( bool enable )

若 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 ().

void QTextOption:: setWrapMode ( WrapMode mode )

Sets the option's text wrap mode to the given mode .

另请参阅 wrapMode ().

QList < qreal > QTextOption:: tabArray () const

Returns a list of tab positions defined for the text layout.

另请参阅 setTabArray () 和 tabStop ().

qreal QTextOption:: tabStop () const

Returns the distance in device units between tab stops. Convenient function for the above method

另请参阅 setTabStop (), tabArray (), setTabs ()，和 tabs ().

QList < Tab > QTextOption:: tabs () const

Returns a list of tab positions defined for the text layout.

该函数在 Qt 4.4 引入。

另请参阅 tabStop (), setTabs ()，和 setTabStop ().

Qt::LayoutDirection QTextOption:: textDirection () const

Returns the direction of the text layout defined by the option.

另请参阅 setTextDirection ().

bool QTextOption:: useDesignMetrics () const

返回 true if the layout uses design rather than device metrics; otherwise returns false .

另请参阅 setUseDesignMetrics ().

WrapMode QTextOption:: wrapMode () const

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

另请参阅 setWrapMode ().

QTextOption &QTextOption:: operator= (const QTextOption & other )

返回 true 如果文本选项如同 other 文本选项；否则返回 false .