|  | Home · All Classes · Modules

# QTextFrameFormat Class Reference
[QtGui module]

The QTextFrameFormat class provides formatting information for frames in a QTextDocument. More...

Inherits QTextFormat.

Inherited by QTextTableFormat.

### Types

- enum BorderStyle { BorderStyle_None, BorderStyle_Dotted, BorderStyle_Dashed, BorderStyle_Solid, ..., BorderStyle_Outset }
- enum Position { InFlow, FloatLeft, FloatRight }

### Methods

- __init__ (self)
- __init__ (self, QTextFrameFormat)
- float border (self)
- QBrush borderBrush (self)
- BorderStyle borderStyle (self)
- float bottomMargin (self)
- QTextLength height (self)
- bool isValid (self)
- float leftMargin (self)
- float margin (self)
- float padding (self)
- QTextFormat.PageBreakFlags pageBreakPolicy (self)
- Position position (self)
- float rightMargin (self)
- setBorder (self, float aborder)
- setBorderBrush (self, QBrush brush)
- setBorderStyle (self, BorderStyle style)
- setBottomMargin (self, float amargin)
- setHeight (self, float aheight)
- setHeight (self, QTextLength aheight)
- setLeftMargin (self, float amargin)
- setMargin (self, float amargin)
- setPadding (self, float apadding)
- setPageBreakPolicy (self, QTextFormat.PageBreakFlags flags)
- setPosition (self, Position f)
- setRightMargin (self, float amargin)
- setTopMargin (self, float amargin)
- setWidth (self, QTextLength length)
- setWidth (self, float awidth)
- float topMargin (self)
- QTextLength width (self)

## Detailed Description

The QTextFrameFormat class provides formatting information for frames in a QTextDocument.

A text frame groups together one or more blocks of text, providing a layer of structure larger than the paragraph. The format of a frame specifies how it is rendered and positioned on the screen. It does not directly specify the behavior of the text formatting within, but provides constraints on the layout of its children.

The frame format defines the width() and height() of the frame on the screen. Each frame can have a border() that surrounds its contents with a rectangular box. The border is surrounded by a margin() around the frame, and the contents of the frame are kept separate from the border by the frame's padding(). This scheme is similar to the box model used by Cascading Style Sheets for HTML pages.

The position() of a frame is set using setPosition() and determines how it is located relative to the surrounding text.

The validity of a QTextFrameFormat object can be determined with the isValid() function.

## Type Documentation

### QTextFrameFormat.BorderStyle

This enum describes different border styles for the text frame.

Constant | Value
--- | ---
`QTextFrameFormat.BorderStyle_None` | `0`
`QTextFrameFormat.BorderStyle_Dotted` | `1`
`QTextFrameFormat.BorderStyle_Dashed` | `2`
`QTextFrameFormat.BorderStyle_Solid` | `3`
`QTextFrameFormat.BorderStyle_Double` | `4`
`QTextFrameFormat.BorderStyle_DotDash` | `5`
`QTextFrameFormat.BorderStyle_DotDotDash` | `6`
`QTextFrameFormat.BorderStyle_Groove` | `7`
`QTextFrameFormat.BorderStyle_Ridge` | `8`
`QTextFrameFormat.BorderStyle_Inset` | `9`
`QTextFrameFormat.BorderStyle_Outset` | `10`

This enum was introduced or modified in Qt 4.3.

See also borderStyle() and FrameBorderStyle.

### QTextFrameFormat.Position

This enum describes how a frame is located relative to the surrounding text.

Constant | Value
--- | ---
`QTextFrameFormat.InFlow` | `0`
`QTextFrameFormat.FloatLeft` | `1`
`QTextFrameFormat.FloatRight` | `2`

See also position() and CssFloat.

## Method Documentation

### QTextFrameFormat.__init__ (self)

Constructs a text frame format object with the default properties.

### QTextFrameFormat.__init__ (self, QTextFrameFormat)

### float QTextFrameFormat.border (self)

Returns the width of the border in pixels.

See also setBorder().

### QBrush QTextFrameFormat.borderBrush (self)

Returns the brush used for the frame's border.

This function was introduced in Qt 4.3.

See also setBorderBrush().

### BorderStyle QTextFrameFormat.borderStyle (self)

Returns the style of the frame's border.

This function was introduced in Qt 4.3.

See also setBorderStyle().

### float QTextFrameFormat.bottomMargin (self)

Returns the width of the frame's bottom margin in pixels.

This function was introduced in Qt 4.3.

See also setBottomMargin().

### QTextLength QTextFrameFormat.height (self)

Returns the height of the frame's border rectangle.

See also setHeight().

### bool QTextFrameFormat.isValid (self)

Returns true if the format description is valid; otherwise returns false.

### float QTextFrameFormat.leftMargin (self)

Returns the width of the frame's left margin in pixels.

This function was introduced in Qt 4.3.

See also setLeftMargin().

### float QTextFrameFormat.margin (self)

Returns the width of the frame's external margin in pixels.

See also setMargin().

### float QTextFrameFormat.padding (self)

Returns the width of the frame's internal padding in pixels.

See also setPadding().

### QTextFormat.PageBreakFlags QTextFrameFormat.pageBreakPolicy (self)

Returns the currently set page break policy for the frame/table. The default is QTextFormat.PageBreak_Auto.

This function was introduced in Qt 4.2.

See also setPageBreakPolicy().

### Position QTextFrameFormat.position (self)

Returns the positioning policy for frames with this frame format.

See also setPosition().

### float QTextFrameFormat.rightMargin (self)

Returns the width of the frame's right margin in pixels.

This function was introduced in Qt 4.3.

See also setRightMargin().

### QTextFrameFormat.setBorder (self, float aborder)

Sets the width (in pixels) of the frame's border.

See also border().

### QTextFrameFormat.setBorderBrush (self, QBrush brush)

Sets the brush used for the frame's border.

This function was introduced in Qt 4.3.

See also borderBrush().

### QTextFrameFormat.setBorderStyle (self, BorderStyle style)

Sets the style of the frame's border.

This function was introduced in Qt 4.3.

See also borderStyle().

### QTextFrameFormat.setBottomMargin (self, float amargin)

Sets the frame's bottom margin in pixels.

This function was introduced in Qt 4.3.

See also bottomMargin().

### QTextFrameFormat.setHeight (self, float aheight)

Sets the frame's height.

See also height().

### QTextFrameFormat.setHeight (self, QTextLength aheight)

This is an overloaded function.

Sets the frame's height.

### QTextFrameFormat.setLeftMargin (self, float amargin)

Sets the frame's left margin in pixels.

This function was introduced in Qt 4.3.

See also leftMargin().

### QTextFrameFormat.setMargin (self, float amargin)

Sets the frame's margin in pixels. This method also sets the left, right, top and bottom margins of the frame to the same value. The individual margins override the general margin.

See also margin().

### QTextFrameFormat.setPadding (self, float apadding)

Sets the width of the frame's internal padding in pixels.

See also padding().

### QTextFrameFormat.setPageBreakPolicy (self, QTextFormat.PageBreakFlags flags)

Sets the page break policy for the frame/table to policy.

This function was introduced in Qt 4.2.

See also pageBreakPolicy().

### QTextFrameFormat.setPosition (self, Position f)

Sets the policy for positioning frames with this frame format.

See also position().

### QTextFrameFormat.setRightMargin (self, float amargin)

Sets the frame's right margin in pixels.

This function was introduced in Qt 4.3.

See also rightMargin().

### QTextFrameFormat.setTopMargin (self, float amargin)

Sets the frame's top margin in pixels.

This function was introduced in Qt 4.3.

See also topMargin().

### QTextFrameFormat.setWidth (self, QTextLength length)

Sets the frame's border rectangle's width.

See also width() and QTextLength.

### QTextFrameFormat.setWidth (self, float awidth)

This is an overloaded function.

Convenience method that sets the width of the frame's border rectangle's width to the specified fixed width.

### float QTextFrameFormat.topMargin (self)

Returns the width of the frame's top margin in pixels.

This function was introduced in Qt 4.3.

See also setTopMargin().

### QTextLength QTextFrameFormat.width (self)

Returns the width of the frame's border rectangle.

See also setWidth() and QTextLength.