Home · All Classes · Modules  · QSS HELP  · QSS 案例 · VER007 HOME

QTextFormat Class Reference
^{[QtGui module]}

该QTextFormat类提供的格式化信息的QTextDocument。More...

通过继承QTextBlockFormat，QTextCharFormat，QTextFrameFormat和QTextListFormat。

Types

• enum FormatType { InvalidFormat, BlockFormat, CharFormat, ListFormat, ..., UserFormat }
• enum ObjectTypes { NoObject, ImageObject, TableObject, TableCellObject, UserObject }
• enum PageBreakFlag { PageBreak_Auto, PageBreak_AlwaysBefore, PageBreak_AlwaysAfter }
• class PageBreakFlags
• enum Property { ObjectIndex, CssFloat, LayoutDirection, OutlinePen, ..., UserProperty }

Methods

• __init__ (self)
• __init__ (self, int type)
• __init__ (self, QTextFormat rhs)
• __init__ (self, QVariant variant)
• QBrush background (self)
• bool boolProperty (self, int propertyId)
• QBrush brushProperty (self, int propertyId)
• clearBackground (self)
• clearForeground (self)
• clearProperty (self, int propertyId)
• QColor colorProperty (self, int propertyId)
• float doubleProperty (self, int propertyId)
• QBrush foreground (self)
• bool hasProperty (self, int propertyId)
• int intProperty (self, int propertyId)
• bool isBlockFormat (self)
• bool isCharFormat (self)
• bool isFrameFormat (self)
• bool isImageFormat (self)
• bool isListFormat (self)
• bool isTableCellFormat (self)
• bool isTableFormat (self)
• bool isValid (self)
• Qt.LayoutDirection layoutDirection (self)
• QTextLength lengthProperty (self, int propertyId)
• list-of-QTextLength lengthVectorProperty (self, int propertyId)
• merge (self, QTextFormat other)
• int objectIndex (self)
• int objectType (self)
• QPen penProperty (self, int propertyId)
• dict-of-int-QVariant properties (self)
• QVariant property (self, int propertyId)
• int propertyCount (self)
• setBackground (self, QBrush brush)
• setForeground (self, QBrush brush)
• setLayoutDirection (self, Qt.LayoutDirection direction)
• setObjectIndex (self, int object)
• setObjectType (self, int atype)
• setProperty (self, int propertyId, QVariant value)
• setProperty (self, int propertyId, list-of-QTextLength lengths)
• QString stringProperty (self, int propertyId)
• QTextBlockFormat toBlockFormat (self)
• QTextCharFormat toCharFormat (self)
• QTextFrameFormat toFrameFormat (self)
• QTextImageFormat toImageFormat (self)
• QTextListFormat toListFormat (self)
• QTextTableCellFormat toTableCellFormat (self)
• QTextTableFormat toTableFormat (self)
• int type (self)

Special Methods

• bool __eq__ (self, QTextFormat rhs)
• bool __ne__ (self, QTextFormat rhs)

Detailed Description

该QTextFormat类提供的格式化信息的QTextDocument。

一个QTextFormat是用于描述一个部分的格式泛型类QTextDocument。派生类QTextCharFormat，QTextBlockFormat，QTextListFormat和QTextTableFormat通常比较有益的，并且描述了应用到文档的特定部分的格式。

的一种格式有FormatType它指定了各种文本项目也可以格式化;如文本块，列表，表格等的一种格式还具有各种属性（一些具体的特定格式类型） ，所描述的属性枚举。每个属性都有相应的属性。

格式类型由下式给出type（） ，并且格式可以与测试isCharFormat（ ）isBlockFormat（ ）isListFormat（ ）isTableFormat（ ）isFrameFormat（）和isImageFormat（ ） 。如果类型是确定的，它可以被检索以toCharFormat（ ）toBlockFormat（ ）toListFormat（ ）toTableFormat（ ）toFrameFormat（）和toImageFormat（ ） 。

的一种格式的属性可以与设置setProperty（）函数，并检索与boolProperty（ ）intProperty（ ）doubleProperty（）和stringProperty（ ） （如适用） 。所有的格式使用的属性ID可以检索到allPropertyIds （ ） 。一种格式可以被合并到另一个使用merge（ ） 。

的一种格式的对象的索引可以被设置setObjectIndex（） ，并检索与objectIndex（ ） 。这些方法可用于编排格式，相关联QTextObject。它是用来表示文档内列出，框架和表格。

Type Documentation

QTextFormat.FormatType

这个枚举变量描述文本项目的QTextFormat对象被格式化。

See also QTextCharFormat，QTextBlockFormat，QTextListFormat，QTextTableFormat和type（ ） 。

QTextFormat.ObjectTypes

这个枚举说明是什么样的QTextObject此格式是与相关联。

See also QTextObject，QTextTable和QTextObject.format（ ） 。

QTextFormat.PageBreakFlag

这个枚举变量描述了如何打印网页时断进行。它映射到相应的CSS属性。

这个枚举被引入或修改的Qt 4.2 。

该PageBreakFlags类型是一个typedef为QFlags\u003cPageBreakFlag\u003e 。它存储PageBreakFlag值的或组合。

See also QTextBlockFormat.pageBreakPolicy（ ）QTextFrameFormat.pageBreakPolicy（）和PageBreakPolicy。

QTextFormat.Property

这个枚举变量描述了不同属性的格式可以有。

段落和字符属性

段落属性

字符属性

列表属性

表和框架属性

表单元格属性

图像性能

选择属性

分页符的属性

See also property（）和setProperty（ ） 。

Method Documentation

QTextFormat.__init__ (self)

创建有一个新的文本格式InvalidFormat。

See also FormatType。

QTextFormat.__init__ (self, int type)

创建给定一个新的文本格式type。

See also FormatType。

QTextFormat.__init__ (self, QTextFormat rhs)

创建一个具有相同属性的新文本格式other文本格式。

QTextFormat.__init__ (self, QVariant variant)

QBrush QTextFormat.background (self)

返回用于绘制文档的背景的画笔。

See also setBackground（ ）clearBackground（）和foreground（ ） 。

bool QTextFormat.boolProperty (self, int propertyId)

返回由指定的属性值propertyId。如果属性是QTextFormat.Bool类型没有，则返回False来代替。

See also setProperty（ ）intProperty（ ）doubleProperty（ ）stringProperty（ ）colorProperty（ ）lengthProperty（ ）lengthVectorProperty（）和Property。

QBrush QTextFormat.brushProperty (self, int propertyId)

返回由给定属性的值propertyId;如果属性是不QVariant.Brush型，Qt.NoBrush返回来代替。

See also setProperty（ ）boolProperty（ ）intProperty（ ）doubleProperty（ ）stringProperty（ ）lengthProperty（ ）lengthVectorProperty（）和Property。

QTextFormat.clearBackground (self)

清除用于绘制文档的背景的画笔。默认刷将被使用。

See also background（ ）setBackground（）和clearForeground（ ） 。

QTextFormat.clearForeground (self)

清除用于绘制文档的前景刷。默认刷将被使用。

See also foreground（ ）setForeground（）和clearBackground（ ） 。

QTextFormat.clearProperty (self, int propertyId)

清除由给定属性的值propertyId

See also Property。

QColor QTextFormat.colorProperty (self, int propertyId)

返回由给定属性的值propertyId;如果属性是不QVariant.Color输入时，将返回一个无效的颜色来代替。

See also setProperty（ ）boolProperty（ ）intProperty（ ）doubleProperty（ ）stringProperty（ ）lengthProperty（ ）lengthVectorProperty（）和Property。

float QTextFormat.doubleProperty (self, int propertyId)

返回由指定的属性值propertyId。如果属性是不QVariant.Double or QMetaType.Float类型，则返回0代替。

See also setProperty（ ）boolProperty（ ）intProperty（ ）stringProperty（ ）colorProperty（ ）lengthProperty（ ）lengthVectorProperty（）和Property。

QBrush QTextFormat.foreground (self)

返回用于渲染前景的详细信息，如文字，边框轮廓，和表格边框的画笔。

See also setForeground（ ）clearForeground（）和background（ ） 。

bool QTextFormat.hasProperty (self, int propertyId)

如果文本格式有一个属性与给定的，则返回TruepropertyId否则返回False 。

See also properties（）和Property。

int QTextFormat.intProperty (self, int propertyId)

返回由指定的属性值propertyId。如果属性是QTextFormat.Integer类型没有，则返回0代替。

See also setProperty（ ）boolProperty（ ）doubleProperty（ ）stringProperty（ ）colorProperty（ ）lengthProperty（ ）lengthVectorProperty（）和Property。

bool QTextFormat.isBlockFormat (self)

返回True如果文本格式是BlockFormat否则返回False 。

bool QTextFormat.isCharFormat (self)

返回True如果文本格式是CharFormat否则返回False 。

bool QTextFormat.isFrameFormat (self)

返回True如果文本格式是FrameFormat否则返回False 。

bool QTextFormat.isImageFormat (self)

返回True如果文本格式是一种图像格式，否则返回False 。

bool QTextFormat.isListFormat (self)

返回True如果文本格式是ListFormat否则返回False 。

bool QTextFormat.isTableCellFormat (self)

返回True如果文本格式是TableCellFormat否则返回False 。

此功能被引入Qt的4.4 。

bool QTextFormat.isTableFormat (self)

返回True如果文本格式是TableFormat否则返回False 。

bool QTextFormat.isValid (self)

返回True如果该格式是有效的（即不InvalidFormat），否则返回False 。

Qt.LayoutDirection QTextFormat.layoutDirection (self)

返回文档的布局方向。

See also setLayoutDirection（ ） 。

QTextLength QTextFormat.lengthProperty (self, int propertyId)

返回由给定属性的值propertyId。

See also setProperty（ ）boolProperty（ ）intProperty（ ）doubleProperty（ ）stringProperty（ ）colorProperty（ ）lengthVectorProperty（）和Property。

list-of-QTextLength QTextFormat.lengthVectorProperty (self, int propertyId)

返回由给定属性的值propertyId。如果属性是QTextFormat.LengthVector类型没有，则返回空长向量来代替。

See also setProperty（ ）boolProperty（ ）intProperty（ ）doubleProperty（ ）stringProperty（ ）colorProperty（ ）lengthProperty（）和Property。

QTextFormat.merge (self, QTextFormat other)

合并的other这种格式的格式;那里有冲突other格式为准。

int QTextFormat.objectIndex (self)

返回格式对象的索引，或者-1，如果格式对象是无效的。

See also setObjectIndex（ ） 。

int QTextFormat.objectType (self)

返回文本格式的对象类型。

See also ObjectTypes和setObjectType（ ） 。

QPen QTextFormat.penProperty (self, int propertyId)

返回由给定属性的值propertyId;如果属性是不QVariant.Pen型，Qt.NoPen返回来代替。

See also setProperty（ ）boolProperty（ ）intProperty（ ）doubleProperty（ ）stringProperty（ ）lengthProperty（ ）lengthVectorProperty（）和Property。

dict-of-int-QVariant QTextFormat.properties (self)

返回与此文本格式的所有属性的映射。

QVariant QTextFormat.property (self, int propertyId)

返回由给定指定的属性propertyId。

See also setProperty（）和Property。

int QTextFormat.propertyCount (self)

返回存储在格式属性的数量。

此功能被引入Qt的4.3 。

QTextFormat.setBackground (self, QBrush brush)

设置画笔使用到文档的底色漆的brush规定。

See also background（ ）clearBackground（）和setForeground（ ） 。

QTextFormat.setForeground (self, QBrush brush)

设置前景色刷到指定的brush。前台刷主要是用来渲染文本。

See also foreground（ ）clearForeground（）和setBackground（ ） 。

QTextFormat.setLayoutDirection (self, Qt.LayoutDirection direction)

设置文档的布局方向的指定的direction。

See also layoutDirection（ ） 。

QTextFormat.setObjectIndex (self, int object)

设置格式的对象的对象index。

See also objectIndex（ ） 。

QTextFormat.setObjectType (self, int atype)

设置文本格式的对象类型type。

See also ObjectTypes和objectType（ ） 。

QTextFormat.setProperty (self, int propertyId, QVariant value)

设置由指定的属性propertyId为给定的value。

See also property（）和Property。

QTextFormat.setProperty (self, int propertyId, list-of-QTextLength lengths)

设置由给定属性的值propertyId至value。

See also lengthVectorProperty（）和Property。

QString QTextFormat.stringProperty (self, int propertyId)

返回由给定属性的值propertyId;如果属性是不QVariant.String输入时，将返回一个空字符串代替。

See also setProperty（ ）boolProperty（ ）intProperty（ ）doubleProperty（ ）colorProperty（ ）lengthProperty（ ）lengthVectorProperty（）和Property。

QTextBlockFormat QTextFormat.toBlockFormat (self)

返回此格式作为块格式。

QTextCharFormat QTextFormat.toCharFormat (self)

返回此格式的字符格式。

QTextFrameFormat QTextFormat.toFrameFormat (self)

返回此格式的帧格式。

QTextImageFormat QTextFormat.toImageFormat (self)

返回此格式的图像格式。

QTextListFormat QTextFormat.toListFormat (self)

返回此格式列表格式。

QTextTableCellFormat QTextFormat.toTableCellFormat (self)

返回此格式的表格单元格的格式。

此功能被引入Qt的4.4 。

QTextTableFormat QTextFormat.toTableFormat (self)

返回此格式为表格式。

int QTextFormat.type (self)

返回此格式的类型。

See also FormatType。

bool QTextFormat.__eq__ (self, QTextFormat rhs)

bool QTextFormat.__ne__ (self, QTextFormat rhs)