QTextFormat class provides formatting information for a QTextDocument . 更多...
| 头： | #include <QTextFormat> |
| qmake: | QT += gui |
| 继承者： |
QTextBlockFormat , QTextCharFormat , QTextFrameFormat ，和 QTextListFormat |
注意： 此类的所有函数 可重入 .
| enum | FormatType { InvalidFormat, BlockFormat, CharFormat, ListFormat, FrameFormat, UserFormat } |
| enum | ObjectTypes { NoObject, ImageObject, TableObject, TableCellObject, UserObject } |
| enum | PageBreakFlag { PageBreak_Auto, PageBreak_AlwaysBefore, PageBreak_AlwaysAfter } |
| flags | PageBreakFlags |
| enum | Property { ObjectIndex, CssFloat, LayoutDirection, OutlinePen, ..., UserProperty } |
| QTextFormat () | |
| QTextFormat (int type ) | |
| QTextFormat (const QTextFormat & other ) | |
| ~QTextFormat () | |
| QBrush | background () const |
| bool | boolProperty (int propertyId ) const |
| QBrush | brushProperty (int propertyId ) const |
| void | clearBackground () |
| void | clearForeground () |
| void | clearProperty (int propertyId ) |
| QColor | colorProperty (int propertyId ) const |
| qreal | doubleProperty (int propertyId ) const |
| QBrush | foreground () const |
| bool | hasProperty (int propertyId ) const |
| int | intProperty (int propertyId ) const |
| bool | isBlockFormat () const |
| bool | isCharFormat () const |
| bool | isEmpty () const |
| bool | isFrameFormat () const |
| bool | isImageFormat () const |
| bool | isListFormat () const |
| bool | isTableCellFormat () const |
| bool | isTableFormat () const |
| bool | isValid () const |
| Qt::LayoutDirection | layoutDirection () const |
| QTextLength | lengthProperty (int propertyId ) const |
| QVector<QTextLength> | lengthVectorProperty (int propertyId ) const |
| void | merge (const QTextFormat & other ) |
| int | objectIndex () const |
| int | objectType () const |
| QPen | penProperty (int propertyId ) const |
| QMap<int, QVariant> | properties () const |
| QVariant | property (int propertyId ) const |
| int | propertyCount () const |
| void | setBackground (const QBrush & brush ) |
| void | setForeground (const QBrush & brush ) |
| void | setLayoutDirection (Qt::LayoutDirection direction ) |
| void | setObjectIndex (int index ) |
| void | setObjectType (int type ) |
| void | setProperty (int propertyId , const QVariant & value ) |
| void | setProperty (int propertyId , const QVector<QTextLength> & value ) |
| QString | stringProperty (int propertyId ) const |
| void | swap (QTextFormat & other ) |
| QTextBlockFormat | toBlockFormat () const |
| QTextCharFormat | toCharFormat () const |
| QTextFrameFormat | toFrameFormat () const |
| QTextImageFormat | toImageFormat () const |
| QTextListFormat | toListFormat () const |
| QTextTableCellFormat | toTableCellFormat () const |
| QTextTableFormat | toTableFormat () const |
| int | type () const |
| operator QVariant () const | |
| bool | operator!= (const QTextFormat & other ) const |
| QTextFormat & | operator= (const QTextFormat & other ) |
| bool | operator== (const QTextFormat & other ) const |
QTextFormat class provides formatting information for a QTextDocument .
A QTextFormat is a generic class used for describing the format of parts of a QTextDocument 。派生类 QTextCharFormat , QTextBlockFormat , QTextListFormat ，和 QTextTableFormat 通常更有用，并描述应用于文档特定部分的格式。
格式拥有
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 type (), and the format can be tested with isCharFormat (), isBlockFormat (), isListFormat (), isTableFormat (), isFrameFormat ()，和 isImageFormat (). If the type is determined, it can be retrieved with toCharFormat (), toBlockFormat (), toListFormat (), toTableFormat (), toFrameFormat ()，和 toImageFormat ().
A format's properties can be set with the setProperty () functions, and retrieved with boolProperty (), intProperty (), doubleProperty ()，和 stringProperty () as appropriate. All the property IDs used in the format can be retrieved with allPropertyIds(). One format can be merged into another using merge ().
A format's object index can be set with setObjectIndex ()，和检索采有 objectIndex (). These methods can be used to associate the format with a QTextObject . It is used to represent lists, frames, and tables inside the document.
另请参阅 富文本处理 .
This enum describes the text item a QTextFormat object is formatting.
| 常量 | 值 | 描述 |
|---|---|---|
QTextFormat::InvalidFormat
|
-1
|
由默认构造函数创建的无效格式 |
QTextFormat::BlockFormat
|
1
|
对象格式文本块 |
QTextFormat::CharFormat
|
2
|
对象格式单个字符 |
QTextFormat::ListFormat
|
3
|
The object formats a list Unused Value, a table's FormatType is FrameFormat. |
QTextFormat::FrameFormat
|
5
|
对象格式帧 |
QTextFormat::UserFormat
|
100
|
另请参阅 QTextCharFormat , QTextBlockFormat , QTextListFormat , QTextTableFormat ，和 type ().
This enum describes what kind of QTextObject this format is associated with.
| 常量 | 值 | 描述 |
|---|---|---|
QTextFormat::NoObject
|
0
|
|
QTextFormat::ImageObject
|
1
|
|
QTextFormat::TableObject
|
2
|
|
QTextFormat::TableCellObject
|
3
|
|
QTextFormat::UserObject
|
0x1000
|
The first object that can be used for application-specific purposes. |
另请参阅 QTextObject , QTextTable ，和 QTextObject::format ().
This enum describes how page breaking is performed when printing. It maps to the corresponding css properties.
| 常量 | 值 | 描述 |
|---|---|---|
QTextFormat::PageBreak_Auto
|
0
|
The page break is determined automatically depending on the available space on the current page |
QTextFormat::PageBreak_AlwaysBefore
|
0x001
|
The page is always broken before the paragraph/table |
QTextFormat::PageBreak_AlwaysAfter
|
0x010
|
A new page is always started after the paragraph/table |
该枚举在 Qt 4.2 引入或被修改。
PageBreakFlags 类型是 typedef 对于 QFlags <PageBreakFlag>. It stores an OR combination of PageBreakFlag values.
另请参阅 QTextBlockFormat::pageBreakPolicy (), QTextFrameFormat::pageBreakPolicy ()，和 PageBreakPolicy .
This enum describes the different properties a format can have.
| 常量 | 值 | 描述 |
|---|---|---|
QTextFormat::ObjectIndex
|
0x0
|
The index of the formatted object. See objectIndex (). |
段落和字符特性
| 常量 | 值 | 描述 |
|---|---|---|
QTextFormat::CssFloat
|
0x0800
|
How a frame is located relative to the surrounding text |
QTextFormat::LayoutDirection
|
0x0801
|
The layout direction of the text in the document ( Qt::LayoutDirection ). |
QTextFormat::OutlinePen
|
0x810
|
|
QTextFormat::ForegroundBrush
|
0x821
|
|
QTextFormat::BackgroundBrush
|
0x820
|
|
QTextFormat::BackgroundImageUrl
|
0x823
|
段落特性
| 常量 | 值 | 描述 |
|---|---|---|
QTextFormat::BlockAlignment
|
0x1010
|
|
QTextFormat::BlockTopMargin
|
0x1030
|
|
QTextFormat::BlockBottomMargin
|
0x1031
|
|
QTextFormat::BlockLeftMargin
|
0x1032
|
|
QTextFormat::BlockRightMargin
|
0x1033
|
|
QTextFormat::TextIndent
|
0x1034
|
|
QTextFormat::TabPositions
|
0x1035
|
Specifies the tab positions. The tab positions are structs of QTextOption::Tab which are stored in a QList (internally, in a QList < QVariant >). |
QTextFormat::BlockIndent
|
0x1040
|
|
QTextFormat::LineHeight
|
0x1048
|
|
QTextFormat::LineHeightType
|
0x1049
|
|
QTextFormat::BlockNonBreakableLines
|
0x1050
|
|
QTextFormat::BlockTrailingHorizontalRulerWidth
|
0x1060
|
The width of a horizontal ruler element. |
字符特性
| 常量 | 值 | 描述 |
|---|---|---|
QTextFormat::FontFamily
|
0x2000
|
|
QTextFormat::FontPointSize
|
0x2001
|
|
QTextFormat::FontPixelSize
|
0x2009
|
|
QTextFormat::FontSizeAdjustment
|
0x2002
|
Specifies the change in size given to the fontsize already set using FontPointSize or FontPixelSize. |
QTextFormat::FontFixedPitch
|
0x2008
|
|
QTextFormat::FontWeight
|
0x2003
|
|
QTextFormat::FontItalic
|
0x2004
|
|
QTextFormat::FontUnderline
|
0x2005
|
This property has been deprecated. Use QTextFormat::TextUnderlineStyle instead. |
QTextFormat::FontOverline
|
0x2006
|
|
QTextFormat::FontStrikeOut
|
0x2007
|
|
QTextFormat::FontCapitalization
|
FirstFontProperty
|
Specifies the capitalization type that is to be applied to the text. |
QTextFormat::FontLetterSpacingType
|
0x2033
|
Specifies the meaning of the FontLetterSpacing property. The default is QFont::PercentageSpacing . |
QTextFormat::FontLetterSpacing
|
0x1FE1
|
Changes the default spacing between individual letters in the font. The value is specified as a percentage or absolute value, depending on FontLetterSpacingType. The default value is 100%. |
QTextFormat::FontWordSpacing
|
0x1FE2
|
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::FontStretch
|
0x2034
|
相当于 QFont::Stretch property |
QTextFormat::FontStyleHint
|
0x1FE3
|
相当于 QFont::StyleHint property |
QTextFormat::FontStyleStrategy
|
0x1FE4
|
相当于 QFont::StyleStrategy property |
QTextFormat::FontKerning
|
0x1FE5
|
Specifies whether the font has kerning turned on. |
QTextFormat::FontHintingPreference
|
0x1FE6
|
Controls the use of hinting according to values of the QFont::HintingPreference 枚举。 |
QTextFormat::TextUnderlineColor
|
0x2010
|
|
QTextFormat::TextVerticalAlignment
|
0x2021
|
|
QTextFormat::TextOutline
|
0x2022
|
|
QTextFormat::TextUnderlineStyle
|
0x2023
|
|
QTextFormat::TextToolTip
|
0x2024
|
Specifies the (optional) tool tip to be displayed for a fragment of text. |
QTextFormat::IsAnchor
|
0x2030
|
|
QTextFormat::AnchorHref
|
0x2031
|
|
QTextFormat::AnchorName
|
0x2032
|
|
QTextFormat::ObjectType
|
0x2f00
|
列表特性
| 常量 | 值 | 描述 |
|---|---|---|
QTextFormat::ListStyle
|
0x3000
|
Specifies the style used for the items in a list, described by values of the QTextListFormat::Style 枚举。 |
QTextFormat::ListIndent
|
0x3001
|
Specifies the amount of indentation used for a list. |
QTextFormat::ListNumberPrefix
|
0x3002
|
Defines the text which is prepended to item numbers in numeric lists. |
QTextFormat::ListNumberSuffix
|
0x3003
|
Defines the text which is appended to item numbers in numeric lists. |
Table and frame properties
| 常量 | 值 | 描述 |
|---|---|---|
QTextFormat::FrameBorder
|
0x4000
|
|
QTextFormat::FrameBorderBrush
|
0x4009
|
|
QTextFormat::FrameBorderStyle
|
0x4010
|
见 BorderStyle 枚举。 |
QTextFormat::FrameBottomMargin
|
0x4006
|
|
QTextFormat::FrameHeight
|
0x4004
|
|
QTextFormat::FrameLeftMargin
|
0x4007
|
|
QTextFormat::FrameMargin
|
0x4001
|
|
QTextFormat::FramePadding
|
0x4002
|
|
QTextFormat::FrameRightMargin
|
0x4008
|
|
QTextFormat::FrameTopMargin
|
0x4005
|
|
QTextFormat::FrameWidth
|
0x4003
|
|
QTextFormat::TableCellSpacing
|
0x4102
|
|
QTextFormat::TableCellPadding
|
0x4103
|
|
QTextFormat::TableColumns
|
0x4100
|
|
QTextFormat::TableColumnWidthConstraints
|
0x4101
|
|
QTextFormat::TableHeaderRowCount
|
0x4104
|
Table cell properties
| 常量 | 值 |
|---|---|
QTextFormat::TableCellRowSpan
|
0x4810
|
QTextFormat::TableCellColumnSpan
|
0x4811
|
QTextFormat::TableCellLeftPadding
|
0x4814
|
QTextFormat::TableCellRightPadding
|
0x4815
|
QTextFormat::TableCellTopPadding
|
0x4812
|
QTextFormat::TableCellBottomPadding
|
0x4813
|
Image properties
| 常量 | 值 |
|---|---|
QTextFormat::ImageName
|
0x5000
|
QTextFormat::ImageWidth
|
0x5010
|
QTextFormat::ImageHeight
|
0x5011
|
Selection properties
| 常量 | 值 | 描述 |
|---|---|---|
QTextFormat::FullWidthSelection
|
0x06000
|
When set on the characterFormat of a selection, the whole width of the text will be shown selected. |
Page break properties
| 常量 | 值 | 描述 |
|---|---|---|
QTextFormat::PageBreakPolicy
|
0x7000
|
Specifies how pages are broken. See the PageBreakFlag 枚举。 |
QTextFormat::UserProperty
|
0x100000
|
另请参阅 property () 和 setProperty ().
Creates a new text format with an
InvalidFormat
.
另请参阅 FormatType .
Creates a new text format of the given type .
另请参阅 FormatType .
Creates a new text format with the same attributes as the other text format.
Destroys this text format.
Returns the brush used to paint the document's background.
另请参阅 setBackground (), clearBackground ()，和 foreground ().
Returns the value of the property specified by propertyId . If the property isn't of QTextFormat::Bool type, false is returned instead.
另请参阅 setProperty (), intProperty (), doubleProperty (), stringProperty (), colorProperty (), lengthProperty (), lengthVectorProperty ()，和 特性 .
Returns the value of the property given by propertyId ; if the property isn't of QVariant::Brush type, Qt::NoBrush 被返回取而代之。
另请参阅 setProperty (), boolProperty (), intProperty (), doubleProperty (), stringProperty (), lengthProperty (), lengthVectorProperty ()，和 特性 .
Clears the brush used to paint the document's background. The default brush will be used.
另请参阅 background (), setBackground ()，和 clearForeground ().
Clears the brush used to paint the document's foreground. The default brush will be used.
另请参阅 foreground (), setForeground ()，和 clearBackground ().
Clears the value of the property given by propertyId
另请参阅 特性 .
Returns the value of the property given by propertyId ; if the property isn't of QVariant::Color type, an invalid color is returned instead.
另请参阅 setProperty (), boolProperty (), intProperty (), doubleProperty (), stringProperty (), lengthProperty (), lengthVectorProperty ()，和 特性 .
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.
另请参阅 setProperty (), boolProperty (), intProperty (), stringProperty (), colorProperty (), lengthProperty (), lengthVectorProperty ()，和 特性 .
Returns the brush used to render foreground details, such as text, frame outlines, and table borders.
另请参阅 setForeground (), clearForeground ()，和 background ().
返回
true
if the text format has a property with the given
propertyId
；否则返回
false
.
另请参阅 properties () 和 特性 .
Returns the value of the property specified by propertyId . If the property is not of QTextFormat::Integer type, 0 is returned instead.
另请参阅 setProperty (), boolProperty (), doubleProperty (), stringProperty (), colorProperty (), lengthProperty (), lengthVectorProperty ()，和 特性 .
返回
true
if this text format is a
BlockFormat
；否则返回
false
.
返回
true
if this text format is a
CharFormat
；否则返回
false
.
Returns true if the format does not store any properties; false otherwise.
该函数在 Qt 5.3 引入。
另请参阅 propertyCount () 和 properties ().
返回
true
if this text format is a
FrameFormat
；否则返回
false
.
返回
true
if this text format is an image format; otherwise returns
false
.
返回
true
if this text format is a
ListFormat
；否则返回
false
.
返回
true
if this text format is a
TableCellFormat
；否则返回
false
.
该函数在 Qt 4.4 引入。
返回
true
if this text format is a
TableFormat
；否则返回
false
.
返回
true
if the format is valid (i.e. is not
InvalidFormat
); otherwise returns
false
.
Returns the document's layout direction.
另请参阅 setLayoutDirection ().
Returns the value of the property given by propertyId .
另请参阅 setProperty (), boolProperty (), intProperty (), doubleProperty (), stringProperty (), colorProperty (), lengthVectorProperty ()，和 特性 .
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.
另请参阅 setProperty (), boolProperty (), intProperty (), doubleProperty (), stringProperty (), colorProperty (), lengthProperty ()，和 特性 .
Merges the other format with this format; where there are conflicts the other format takes precedence.
Returns the index of the format object, or -1 if the format object is invalid.
另请参阅 setObjectIndex ().
Returns the text format's object type.
另请参阅 ObjectTypes and setObjectType ().
Returns the value of the property given by propertyId ; if the property isn't of QVariant::Pen type, Qt::NoPen 被返回取而代之。
另请参阅 setProperty (), boolProperty (), intProperty (), doubleProperty (), stringProperty (), lengthProperty (), lengthVectorProperty ()，和 特性 .
Returns a map with all properties of this text format.
Returns the property specified by the given propertyId .
另请参阅 setProperty () 和 特性 .
Returns the number of properties stored in the format.
该函数在 Qt 4.3 引入。
Sets the brush use to paint the document's background to the brush 指定。
另请参阅 background (), clearBackground ()，和 setForeground ().
Sets the foreground brush to the specified brush . The foreground brush is mostly used to render text.
另请参阅 foreground (), clearForeground ()，和 setBackground ().
Sets the document's layout direction to the specified direction .
另请参阅 layoutDirection ().
Sets the format object's object index .
另请参阅 objectIndex ().
Sets the text format's object type to type .
另请参阅 ObjectTypes and objectType ().
Sets the property specified by the propertyId 到给定 value .
Sets the value of the property given by propertyId to value .
另请参阅 lengthVectorProperty () 和 特性 .
Returns the value of the property given by propertyId ; if the property isn't of QVariant::String type, an empty string is returned instead.
另请参阅 setProperty (), boolProperty (), intProperty (), doubleProperty (), colorProperty (), lengthProperty (), lengthVectorProperty ()，和 特性 .
Swaps this text format with other 。此函数非常快，且从不失败。
该函数在 Qt 5.0 引入。
Returns this format as a block format.
Returns this format as a character format.
Returns this format as a frame format.
Returns this format as an image format.
Returns this format as a list format.
Returns this format as a table cell format.
该函数在 Qt 4.4 引入。
Returns this format as a table format.
返回此格式的类型。
另请参阅 FormatType .
Returns the text format as a QVariant
返回
true
if this text format is different from the
other
text format.
赋值 other text format to this text format, and returns a reference to this text format.
返回
true
if this text format is the same as the
other
text format.
