QTextFormat¶

Inheritance diagram of QTextFormat

Inherited by: QTextFrameFormat, QTextTableFormat, QTextListFormat, QTextBlockFormat, QTextCharFormat, QTextTableCellFormat, QTextImageFormat

Synopsis¶

Functions¶

def __eq__ (rhs)
def __ne__ (rhs)
def background ()
def boolProperty (propertyId)
def brushProperty (propertyId)
def clearBackground ()
def clearForeground ()
def clearProperty (propertyId)
def colorProperty (propertyId)
def doubleProperty (propertyId)
def foreground ()
def hasProperty (propertyId)
def intProperty (propertyId)
def isBlockFormat ()
def isCharFormat ()
def isFrameFormat ()
def isImageFormat ()
def isListFormat ()
def isTableCellFormat ()
def isTableFormat ()
def isValid ()
def layoutDirection ()
def lengthProperty (propertyId)
def lengthVectorProperty (propertyId)
def merge (other)
def objectIndex ()
def objectType ()
def penProperty (propertyId)
def properties ()
def property (propertyId)
def propertyCount ()
def setBackground (brush)
def setForeground (brush)
def setLayoutDirection (direction)
def setObjectIndex (object)
def setObjectType (type)
def setProperty (propertyId, lengths)
def setProperty (propertyId, value)
def stringProperty (propertyId)
def toBlockFormat ()
def toCharFormat ()
def toFrameFormat ()
def toImageFormat ()
def toListFormat ()
def toTableCellFormat ()
def toTableFormat ()
def type ()

Detailed Description¶

The PySide.QtGui.QTextFormat class provides formatting information for a PySide.QtGui.QTextDocument .

A PySide.QtGui.QTextFormat is a generic class used for describing the format of parts of a PySide.QtGui.QTextDocument . The derived classes PySide.QtGui.QTextCharFormat , PySide.QtGui.QTextBlockFormat , PySide.QtGui.QTextListFormat , and PySide.QtGui.QTextTableFormat are usually more useful, and describe the formatting that is applied to specific parts of the document.

A format has a FormatType which specifies the kinds of text item it can format; e.g. a block of text, a list, a table, etc. A format also has various properties (some specific to particular format types), as described by the Property enum. Every property has a corresponding Property.

The format type is given by PySide.QtGui.QTextFormat.type() , and the format can be tested with PySide.QtGui.QTextFormat.isCharFormat() , PySide.QtGui.QTextFormat.isBlockFormat() , PySide.QtGui.QTextFormat.isListFormat() , PySide.QtGui.QTextFormat.isTableFormat() , PySide.QtGui.QTextFormat.isFrameFormat() , and PySide.QtGui.QTextFormat.isImageFormat() . If the type is determined, it can be retrieved with PySide.QtGui.QTextFormat.toCharFormat() , PySide.QtGui.QTextFormat.toBlockFormat() , PySide.QtGui.QTextFormat.toListFormat() , PySide.QtGui.QTextFormat.toTableFormat() , PySide.QtGui.QTextFormat.toFrameFormat() , and PySide.QtGui.QTextFormat.toImageFormat() .

A format’s properties can be set with the PySide.QtGui.QTextFormat.setProperty() functions, and retrieved with PySide.QtGui.QTextFormat.boolProperty() , PySide.QtGui.QTextFormat.intProperty() , PySide.QtGui.QTextFormat.doubleProperty() , and PySide.QtGui.QTextFormat.stringProperty() as appropriate. All the property IDs used in the format can be retrieved with allPropertyIds(). One format can be merged into another using PySide.QtGui.QTextFormat.merge() .

A format’s object index can be set with PySide.QtGui.QTextFormat.setObjectIndex() , and retrieved with PySide.QtGui.QTextFormat.objectIndex() . These methods can be used to associate the format with a PySide.QtGui.QTextObject . It is used to represent lists, frames, and tables inside the document.

See also

Rich Text Processing

class PySide.QtGui.QTextFormat¶

class PySide.QtGui.QTextFormat(rhs)

class PySide.QtGui.QTextFormat(type)

Parameters:	rhs – `PySide.QtGui.QTextFormat` type – `PySide.QtCore.int`

Creates a new text format with an InvalidFormat .

See also

QTextFormat.FormatType

Creates a new text format with the same attributes as the other text format.

Creates a new text format of the given type .

See also

QTextFormat.FormatType

PySide.QtGui.QTextFormat.Property¶

This enum describes the different properties a format can have.

Constant	Description
QTextFormat.ObjectIndex	The index of the formatted object. See `PySide.QtGui.QTextFormat.objectIndex()` .

Paragraph and character properties

Constant	Description
QTextFormat.CssFloat	How a frame is located relative to the surrounding text
QTextFormat.LayoutDirection	The layout direction of the text in the document ( `Qt.LayoutDirection` ).
QTextFormat.OutlinePen
QTextFormat.ForegroundBrush
QTextFormat.BackgroundBrush
QTextFormat.BackgroundImageUrl

Paragraph properties

Constant	Description
QTextFormat.BlockAlignment
QTextFormat.BlockTopMargin
QTextFormat.BlockBottomMargin
QTextFormat.BlockLeftMargin
QTextFormat.BlockRightMargin
QTextFormat.TextIndent
QTextFormat.TabPositions	Specifies the tab positions. The tab positions are structs of `QTextOption.Tab` which are stored in a `QList` (internally, in a `QList` < `PySide.QtCore.QVariant` >).
QTextFormat.BlockIndent
QTextFormat.BlockNonBreakableLines
QTextFormat.BlockTrailingHorizontalRulerWidth	The width of a horizontal ruler element.

Character properties

Constant	Description
QTextFormat.FontFamily
QTextFormat.FontPointSize
QTextFormat.FontPixelSize
QTextFormat.FontSizeAdjustment	Specifies the change in size given to the fontsize already set using `FontPointSize` or `FontPixelSize` .
QTextFormat.FontFixedPitch
QTextFormat.FontWeight
QTextFormat.FontItalic
QTextFormat.FontUnderline	This property has been deprecated. Use `QTextFormat.TextUnderlineStyle` instead.
QTextFormat.FontOverline
QTextFormat.FontStrikeOut
QTextFormat.FontCapitalization	Specifies the capitalization type that is to be applied to the text.
QTextFormat.FontLetterSpacing	Changes the default spacing between individual letters in the font. The value is specified in percentage, with 100 as the default value.
QTextFormat.FontWordSpacing	Changes the default spacing between individual words. A positive value increases the word spacing by the corresponding pixels; a negative value decreases the spacing.
QTextFormat.FontStyleHint	Corresponds to the `QFont.StyleHint` property
QTextFormat.FontStyleStrategy	Corresponds to the `QFont.StyleStrategy` property
QTextFormat.FontKerning	Specifies whether the font has kerning turned on.
QTextFormat.TextUnderlineColor
QTextFormat.TextVerticalAlignment
QTextFormat.TextOutline
QTextFormat.TextUnderlineStyle
QTextFormat.TextToolTip	Specifies the (optional) tool tip to be displayed for a fragment of text.
QTextFormat.IsAnchor
QTextFormat.AnchorHref
QTextFormat.AnchorName
QTextFormat.ObjectType

List properties

Constant	Description
QTextFormat.ListStyle
QTextFormat.ListIndent

Table and frame properties

Constant	Description
QTextFormat.FrameBorder
QTextFormat.FrameBorderBrush
QTextFormat.FrameBorderStyle	See the `QTextFrameFormat.BorderStyle` enum.
QTextFormat.FrameBottomMargin
QTextFormat.FrameHeight
QTextFormat.FrameLeftMargin
QTextFormat.FrameMargin
QTextFormat.FramePadding
QTextFormat.FrameRightMargin
QTextFormat.FrameTopMargin
QTextFormat.FrameWidth
QTextFormat.TableCellSpacing
QTextFormat.TableCellPadding
QTextFormat.TableColumns
QTextFormat.TableColumnWidthConstraints
QTextFormat.TableHeaderRowCount

Table cell properties

Constant	Description
QTextFormat.TableCellRowSpan
QTextFormat.TableCellColumnSpan
QTextFormat.TableCellLeftPadding
QTextFormat.TableCellRightPadding
QTextFormat.TableCellTopPadding
QTextFormat.TableCellBottomPadding

Image properties

Constant	Description
QTextFormat.ImageName
QTextFormat.ImageWidth
QTextFormat.ImageHeight

Selection properties

Constant	Description
QTextFormat.FullWidthSelection	When set on the characterFormat of a selection, the whole width of the text will be shown selected.

Page break properties

Constant	Description
QTextFormat.PageBreakPolicy	Specifies how pages are broken. See the `QTextFormat.PageBreakFlag` enum.
QTextFormat.UserProperty

PySide.QtGui.QTextFormat.FormatType¶

This enum describes the text item a PySide.QtGui.QTextFormat object is formatting.

Constant	Description
QTextFormat.InvalidFormat	An invalid format as created by the default constructor
QTextFormat.BlockFormat	The object formats a text block
QTextFormat.CharFormat	The object formats a single character
QTextFormat.ListFormat	The object formats a list
QTextFormat.TableFormat	The object formats a table
QTextFormat.FrameFormat	The object formats a frame
QTextFormat.UserFormat

PySide.QtGui.QTextFormat.ObjectTypes¶

This enum describes what kind of PySide.QtGui.QTextObject this format is associated with.

Constant	Description
QTextFormat.NoObject
QTextFormat.ImageObject
QTextFormat.TableObject
QTextFormat.TableCellObject
QTextFormat.UserObject	The first object that can be used for application-specific purposes.

PySide.QtGui.QTextFormat.PageBreakFlag¶

This enum describes how page breaking is performed when printing. It maps to the corresponding css properties.

Constant	Description
QTextFormat.PageBreak_Auto	The page break is determined automatically depending on the available space on the current page
QTextFormat.PageBreak_AlwaysBefore	The page is always broken before the paragraph/table
QTextFormat.PageBreak_AlwaysAfter	A new page is always started after the paragraph/table

PySide.QtGui.QTextFormat.background()¶

Return type:	`PySide.QtGui.QBrush`

Returns the brush used to paint the document’s background.

PySide.QtGui.QTextFormat.boolProperty(propertyId)¶

Parameters:	propertyId – `PySide.QtCore.int`
Return type:	`PySide.QtCore.bool`

Returns the value of the property specified by propertyId . If the property isn’t of QTextFormat::Bool type, false is returned instead.

PySide.QtGui.QTextFormat.brushProperty(propertyId)¶

Parameters:	propertyId – `PySide.QtCore.int`
Return type:	`PySide.QtGui.QBrush`

Returns the value of the property given by propertyId ; if the property isn’t of QVariant.Brush type, Qt.NoBrush is returned instead.

PySide.QtGui.QTextFormat.clearBackground()¶: Clears the brush used to paint the document’s background. The default brush will be used.

See also

PySide.QtGui.QTextFormat.background() PySide.QtGui.QTextFormat.setBackground() PySide.QtGui.QTextFormat.clearForeground()

PySide.QtGui.QTextFormat.clearForeground()¶: Clears the brush used to paint the document’s foreground. The default brush will be used.

See also

PySide.QtGui.QTextFormat.foreground() PySide.QtGui.QTextFormat.setForeground() PySide.QtGui.QTextFormat.clearBackground()

PySide.QtGui.QTextFormat.clearProperty(propertyId)¶

Parameters:	propertyId – `PySide.QtCore.int`

Clears the value of the property given by propertyId

See also

QTextFormat.Property

PySide.QtGui.QTextFormat.colorProperty(propertyId)¶

Parameters:	propertyId – `PySide.QtCore.int`
Return type:	`PySide.QtGui.QColor`

Returns the value of the property given by propertyId ; if the property isn’t of QVariant.Color type, an invalid color is returned instead.

PySide.QtGui.QTextFormat.doubleProperty(propertyId)¶

Parameters:	propertyId – `PySide.QtCore.int`
Return type:	`PySide.QtCore.qreal`

Returns the value of the property specified by propertyId . If the property isn’t of QVariant.Double or QMetaType.Float type, 0 is returned instead.

PySide.QtGui.QTextFormat.foreground()¶

Return type:	`PySide.QtGui.QBrush`

Returns the brush used to render foreground details, such as text, frame outlines, and table borders.

PySide.QtGui.QTextFormat.hasProperty(propertyId)¶

Parameters:	propertyId – `PySide.QtCore.int`
Return type:	`PySide.QtCore.bool`

Returns true if the text format has a property with the given propertyId ; otherwise returns false.

See also

PySide.QtGui.QTextFormat.properties() QTextFormat.Property

PySide.QtGui.QTextFormat.intProperty(propertyId)¶

Parameters:	propertyId – `PySide.QtCore.int`
Return type:	`PySide.QtCore.int`

Returns the value of the property specified by propertyId . If the property is not of QTextFormat::Integer type, 0 is returned instead.

PySide.QtGui.QTextFormat.isBlockFormat()¶

Return type:	`PySide.QtCore.bool`

Returns true if this text format is a BlockFormat ; otherwise returns false.

PySide.QtGui.QTextFormat.isCharFormat()¶

Return type:	`PySide.QtCore.bool`

Returns true if this text format is a CharFormat ; otherwise returns false.

PySide.QtGui.QTextFormat.isFrameFormat()¶

Return type:	`PySide.QtCore.bool`

Returns true if this text format is a FrameFormat ; otherwise returns false.

PySide.QtGui.QTextFormat.isImageFormat()¶

Return type:	`PySide.QtCore.bool`

Returns true if this text format is an image format; otherwise returns false.

PySide.QtGui.QTextFormat.isListFormat()¶

Return type:	`PySide.QtCore.bool`

Returns true if this text format is a ListFormat ; otherwise returns false.

PySide.QtGui.QTextFormat.isTableCellFormat()¶

Return type:	`PySide.QtCore.bool`

Returns true if this text format is a TableCellFormat ; otherwise returns false.

PySide.QtGui.QTextFormat.isTableFormat()¶

Return type:	`PySide.QtCore.bool`

Returns true if this text format is a TableFormat ; otherwise returns false.

PySide.QtGui.QTextFormat.isValid()¶

Return type:	`PySide.QtCore.bool`

Returns true if the format is valid (i.e. is not InvalidFormat ); otherwise returns false.

PySide.QtGui.QTextFormat.layoutDirection()¶

Return type:	`PySide.QtCore.Qt.LayoutDirection`

Returns the document’s layout direction.

PySide.QtGui.QTextFormat.lengthProperty(propertyId)¶

Parameters:	propertyId – `PySide.QtCore.int`
Return type:	`PySide.QtGui.QTextLength`

Returns the value of the property given by propertyId .

PySide.QtGui.QTextFormat.lengthVectorProperty(propertyId)¶

Parameters:	propertyId – `PySide.QtCore.int`
Return type:

Returns the value of the property given by propertyId . If the property isn’t of QTextFormat::LengthVector type, an empty length vector is returned instead.

PySide.QtGui.QTextFormat.merge(other)¶

Parameters:	other – `PySide.QtGui.QTextFormat`

Merges the other format with this format; where there are conflicts the other format takes precedence.

PySide.QtGui.QTextFormat.objectIndex()¶

Return type:	`PySide.QtCore.int`

Returns the index of the format object, or -1 if the format object is invalid.

PySide.QtGui.QTextFormat.objectType()¶

Return type:	`PySide.QtCore.int`

Returns the text format’s object type.

See also

QTextFormat.ObjectTypes PySide.QtGui.QTextFormat.setObjectType()

PySide.QtGui.QTextFormat.__ne__(rhs)¶

Parameters:	rhs – `PySide.QtGui.QTextFormat`
Return type:	`PySide.QtCore.bool`

Returns true if this text format is different from the other text format.

PySide.QtGui.QTextFormat.__eq__(rhs)¶

Parameters:	rhs – `PySide.QtGui.QTextFormat`
Return type:	`PySide.QtCore.bool`

Returns true if this text format is the same as the other text format.

PySide.QtGui.QTextFormat.penProperty(propertyId)¶

Parameters:	propertyId – `PySide.QtCore.int`
Return type:	`PySide.QtGui.QPen`

Returns the value of the property given by propertyId ; if the property isn’t of QVariant.Pen type, Qt.NoPen is returned instead.

PySide.QtGui.QTextFormat.properties()¶

Return type:

Returns a map with all properties of this text format.

PySide.QtGui.QTextFormat.property(propertyId)¶

Parameters:	propertyId – `PySide.QtCore.int`
Return type:	object

Returns the property specified by the given propertyId .

See also

PySide.QtGui.QTextFormat.setProperty() QTextFormat.Property

PySide.QtGui.QTextFormat.propertyCount()¶

Return type:	`PySide.QtCore.int`

Returns the number of properties stored in the format.

PySide.QtGui.QTextFormat.setBackground(brush)¶

Parameters:	brush – `PySide.QtGui.QBrush`

Sets the brush use to paint the document’s background to the brush specified.

PySide.QtGui.QTextFormat.setForeground(brush)¶

Parameters:	brush – `PySide.QtGui.QBrush`

Sets the foreground brush to the specified brush . The foreground brush is mostly used to render text.

PySide.QtGui.QTextFormat.setLayoutDirection(direction)¶

Parameters:	direction – `PySide.QtCore.Qt.LayoutDirection`

PySide.QtGui.QTextFormat.setObjectIndex(object)¶

Parameters:	object – `PySide.QtCore.int`

Sets the format object’s object index .

PySide.QtGui.QTextFormat.setObjectType(type)¶

Parameters:	type – `PySide.QtCore.int`

Sets the text format’s object type to type .

See also

QTextFormat.ObjectTypes PySide.QtGui.QTextFormat.objectType()

PySide.QtGui.QTextFormat.setProperty(propertyId, value)¶

Parameters:	propertyId – `PySide.QtCore.int` value – object

Sets the property specified by the propertyId to the given value .

See also

PySide.QtGui.QTextFormat.property() QTextFormat.Property

PySide.QtGui.QTextFormat.setProperty(propertyId, lengths)

Parameters:	propertyId – `PySide.QtCore.int` lengths –

PySide.QtGui.QTextFormat.stringProperty(propertyId)¶

Parameters:	propertyId – `PySide.QtCore.int`
Return type:	unicode

Returns the value of the property given by propertyId ; if the property isn’t of QVariant.String type, an empty string is returned instead.

PySide.QtGui.QTextFormat.toBlockFormat()¶

Return type:	`PySide.QtGui.QTextBlockFormat`

Returns this format as a block format.

PySide.QtGui.QTextFormat.toCharFormat()¶

Return type:	`PySide.QtGui.QTextCharFormat`

Returns this format as a character format.

PySide.QtGui.QTextFormat.toFrameFormat()¶

Return type:	`PySide.QtGui.QTextFrameFormat`

Returns this format as a frame format.

PySide.QtGui.QTextFormat.toImageFormat()¶

Return type:	`PySide.QtGui.QTextImageFormat`

Returns this format as an image format.

PySide.QtGui.QTextFormat.toListFormat()¶

Return type:	`PySide.QtGui.QTextListFormat`

Returns this format as a list format.

PySide.QtGui.QTextFormat.toTableCellFormat()¶

Return type:	`PySide.QtGui.QTextTableCellFormat`

Returns this format as a table cell format.

PySide.QtGui.QTextFormat.toTableFormat()¶

Return type:	`PySide.QtGui.QTextTableFormat`

Returns this format as a table format.

PySide.QtGui.QTextFormat.type()¶

Return type:	`PySide.QtCore.int`

Returns the type of this format.

See also

QTextFormat.FormatType

Table Of Contents

Previous topic

Next topic

QTextFormat¶

Synopsis¶

Functions¶

Detailed Description¶

Table Of Contents

Previous topic

Next topic

Quick search

QTextFormat¶

Synopsis¶

Functions¶

Detailed Description¶