class QTextOption#

The QTextOption class provides a description of general rich text properties. More

Synopsis#

Methods#

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description#

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.

class TabType#

This enum holds the different types of tabulator

Constant

Description

QTextOption.LeftTab

A left-tab

QTextOption.RightTab

A right-tab

QTextOption.CenterTab

A centered-tab

QTextOption.DelimiterTab

A tab stopping at a certain delimiter-character

class WrapMode#

This enum describes how text is wrapped in a document.

Constant

Description

QTextOption.NoWrap

Text is not wrapped at all.

QTextOption.WordWrap

Text is wrapped at word boundaries.

QTextOption.ManualWrap

Same as QTextOption::NoWrap

QTextOption.WrapAnywhere

Text can be wrapped at any point on a line, even if it occurs in the middle of a word.

QTextOption.WrapAtWordBoundaryOrAnywhere

If possible, wrapping occurs at a word boundary; otherwise it will occur at the appropriate point on the line, even in the middle of a word.

class Flag#

Constant

Description

QTextOption.IncludeTrailingSpaces

(inherits enum.Flag) When this option is set, naturalTextWidth() and naturalTextRect() will return a value that includes the width of trailing spaces in the text; otherwise this width is excluded.

QTextOption.ShowTabsAndSpaces

Visualize spaces with little dots, and tabs with little arrows. Non-breaking spaces are shown differently to breaking spaces.

QTextOption.ShowLineAndParagraphSeparators

Visualize line and paragraph separators with appropriate symbol characters.

QTextOption.ShowDocumentTerminator

Visualize the end of the document with a section sign. This enum value was added in Qt 5.7.

QTextOption.AddSpaceForLineAndParagraphSeparators

While determining the line-break positions take into account the space added for drawing a separator character.

QTextOption.SuppressColors

Suppress all color changes in the character formats (except the main selection).

__init__(alignment)#
Parameters:

alignment – Combination of AlignmentFlag

Constructs a text option with the given alignment for text. The word wrap property is set to WordWrap . The using of design metrics flag is set to false.

__init__(o)
Parameters:

oQTextOption

Construct a copy of the other text option.

__init__()

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 WordWrap . The using of design metrics flag is set to false.

alignment()#
Return type:

Combination of AlignmentFlag

Returns the text alignment defined by the option.

See also

setAlignment()

flags()#
Return type:

Combination of Flag

Returns the flags associated with the option.

See also

setFlags()

setAlignment(alignment)#
Parameters:

alignment – Combination of AlignmentFlag

Sets the option’s text alignment to the specified alignment.

See also

alignment()

setFlags(flags)#
Parameters:

flags – Combination of Flag

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

See also

flags()

setTabArray(tabStops)#
Parameters:

tabStops – .list of qreal

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

setTabStopDistance(tabStopDistance)#
Parameters:

tabStopDistance – float

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

setTabs(tabStops)#
Parameters:

tabStops – .list of QTextOption.Tab

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

setTextDirection(aDirection)#
Parameters:

aDirectionLayoutDirection

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

See also

textDirection()

setUseDesignMetrics(b)#
Parameters:

b – bool

If 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).

setWrapMode(wrap)#
Parameters:

wrapWrapMode

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

See also

wrapMode()

tabArray()#
Return type:

.list of qreal

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

tabStopDistance()#
Return type:

float

Returns the distance in device units between tab stops.

tabs()#
Return type:

.list of QTextOption.Tab

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

textDirection()#
Return type:

LayoutDirection

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

useDesignMetrics()#
Return type:

bool

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

wrapMode()#
Return type:

WrapMode

Returns the text wrap mode defined by the option.

See also

setWrapMode()