PySide6.QtGui.QTextFrameFormat

class QTextFrameFormat

QTextFrameFormat 类为 QTextDocument 中的框架提供格式化信息。更多…

PySide6.QtGui.QTextFrameFormat 的继承图

继承者： QTextTableFormat

概要

方法

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述

文本框架将一组或多组文本块组合在一起，提供了一个比段落更大的结构层。框架的格式指定了它在屏幕上的渲染和定位方式。它并不直接指定内部文本格式的行为，而是为其子元素的布局提供约束。

框架格式定义了屏幕上框架的width()和height()。每个框架可以有一个border()，用一个矩形框包围其内容。边框周围有一个margin()，框架的内容通过框架的padding()与边框保持分离。这个方案类似于用于HTML页面的层叠样式表（CSS）中的盒子模型。

../../_images/qtextframe-style.png

框架的position()是通过setPosition()设置的，并决定了它相对于周围文本的位置。

可以通过isValid()函数来确定QTextFrameFormat对象的有效性。

class Position

此枚举描述了一个框架相对于周围文本的定位方式。

常量

描述

QTextFrameFormat.InFlow

QTextFrameFormat.FloatLeft

QTextFrameFormat.FloatRight

另请参阅

position() CssFloat

class BorderStyle

此枚举描述了文本框架的不同边框样式。

常量

描述

QTextFrameFormat.BorderStyle_None

QTextFrameFormat.BorderStyle_Dotted

QTextFrameFormat.BorderStyle_Dashed

QTextFrameFormat.BorderStyle_Solid

QTextFrameFormat.BorderStyle_Double

QTextFrameFormat.BorderStyle_DotDash

QTextFrameFormat.BorderStyle_DotDotDash

QTextFrameFormat.BorderStyle_Groove

QTextFrameFormat.BorderStyle_Ridge

QTextFrameFormat.BorderStyle_Inset

QTextFrameFormat.BorderStyle_Outset

另请参阅

borderStyle() FrameBorderStyle

__init__()

使用默认属性构造一个文本框架格式对象。

__init__(fmt)
Parameters:

fmt – QTextFormat

border()
Return type:

浮点数

返回边框的宽度，单位为像素。

另请参阅

setBorder()

borderBrush()
Return type:

QBrush

返回用于框架边框的画笔。

另请参阅

setBorderBrush()

borderStyle()
Return type:

BorderStyle

返回框架边框的样式。

另请参阅

setBorderStyle()

bottomMargin()
Return type:

浮点数

返回框架底部边距的宽度（以像素为单位）。

另请参阅

setBottomMargin()

height()
Return type:

QTextLength

返回框架边框矩形的高度。

另请参阅

setHeight()

leftMargin()
Return type:

浮点数

返回框架左边距的宽度（以像素为单位）。

另请参阅

setLeftMargin()

margin()
Return type:

浮点数

返回框架外部边距的宽度（以像素为单位）。

另请参阅

setMargin()

padding()
Return type:

浮点数

返回框架内部填充的宽度，单位为像素。

另请参阅

setPadding()

pageBreakPolicy()
Return type:

PageBreakFlag 的组合

返回当前为框架/表格设置的页面分页策略。默认值为PageBreak_Auto。

另请参阅

setPageBreakPolicy()

position()
Return type:

位置

返回具有此帧格式的帧的定位策略。

另请参阅

setPosition()

rightMargin()
Return type:

浮点数

返回框架右边距的宽度（以像素为单位）。

另请参阅

setRightMargin()

setBorder(border)
Parameters:

边框 – 浮动

设置框架边框的宽度（以像素为单位）。

另请参阅

border()

setBorderBrush(brush)
Parameters:

画笔 – QBrush

设置用于框架边框的brush。

另请参阅

borderBrush()

setBorderStyle(style)
Parameters:

样式 – BorderStyle

设置框架边框的style。

另请参阅

borderStyle()

setBottomMargin(margin)
Parameters:

margin – 浮点数

设置框架的底部margin（以像素为单位）。

另请参阅

bottomMargin()

setHeight(height)
Parameters:

高度 – QTextLength

设置框架的height。

另请参阅

height()

setHeight(height)
Parameters:

height – 浮点数

这是一个重载函数。

设置框架的height。

setLeftMargin(margin)
Parameters:

margin – 浮点数

设置框架的左侧margin（以像素为单位）。

另请参阅

leftMargin()

setMargin(margin)
Parameters:

margin – 浮点数

设置框架的margin（边距）为像素值。此方法还将框架的左、右、上、下边距设置为相同的值。单独的边距设置会覆盖通用边距设置。

另请参阅

margin()

setPadding(padding)
Parameters:

padding – 浮点数

设置框架内部填充的宽度，单位为像素。

另请参阅

padding()

setPageBreakPolicy(flags)
Parameters:

flags – PageBreakFlag 的组合

设置框架/表格的分页策略为policy。

另请参阅

pageBreakPolicy()

setPosition(f)
Parameters:

f – 位置

设置用于使用此框架格式定位框架的policy。

另请参阅

position()

setRightMargin(margin)
Parameters:

margin – 浮点数

设置框架的右边距为像素。

另请参阅

rightMargin()

setTopMargin(margin)
Parameters:

margin – 浮点数

设置框架的顶部margin（以像素为单位）。

另请参阅

topMargin()

setWidth(length)
Parameters:

长度 – QTextLength

设置框架的边框矩形的width。

另请参阅

width() QTextLength

setWidth(width)
Parameters:

width – 浮点数

这是一个重载函数。

便捷方法，将框架边框矩形的宽度设置为指定的固定width。

topMargin()
Return type:

浮点数

返回框架顶部边距的宽度（以像素为单位）。

另请参阅

setTopMargin()

width()
Return type:

QTextLength

返回框架边框矩形的宽度。

另请参阅

setWidth() QTextLength