Qt 4.8
|
The QTextFrameFormat class provides formatting information for frames in a QTextDocument. More...
#include <qtextformat.h>
Public Functions | |
qreal | border () const |
Returns the width of the border in pixels. More... | |
QBrush | borderBrush () const |
Returns the brush used for the frame's border. More... | |
BorderStyle | borderStyle () const |
Returns the style of the frame's border. More... | |
qreal | bottomMargin () const |
Returns the width of the frame's bottom margin in pixels. More... | |
QTextLength | height () const |
Returns the height of the frame's border rectangle. More... | |
bool | isValid () const |
Returns true if the format description is valid; otherwise returns false. More... | |
qreal | leftMargin () const |
Returns the width of the frame's left margin in pixels. More... | |
qreal | margin () const |
Returns the width of the frame's external margin in pixels. More... | |
qreal | padding () const |
Returns the width of the frame's internal padding in pixels. More... | |
PageBreakFlags | pageBreakPolicy () const |
Returns the currently set page break policy for the frame/table. More... | |
Position | position () const |
Returns the positioning policy for frames with this frame format. More... | |
QTextFrameFormat () | |
Constructs a text frame format object with the default properties. More... | |
qreal | rightMargin () const |
Returns the width of the frame's right margin in pixels. More... | |
void | setBorder (qreal border) |
Sets the width (in pixels) of the frame's border. More... | |
void | setBorderBrush (const QBrush &brush) |
Sets the brush used for the frame's border. More... | |
void | setBorderStyle (BorderStyle style) |
Sets the style of the frame's border. More... | |
void | setBottomMargin (qreal margin) |
Sets the frame's bottom margin in pixels. More... | |
void | setHeight (qreal height) |
Sets the frame's height. More... | |
void | setHeight (const QTextLength &height) |
Sets the frame's height. More... | |
void | setLeftMargin (qreal margin) |
Sets the frame's left margin in pixels. More... | |
void | setMargin (qreal margin) |
Sets the frame's margin in pixels. More... | |
void | setPadding (qreal padding) |
Sets the width of the frame's internal padding in pixels. More... | |
void | setPageBreakPolicy (PageBreakFlags flags) |
Sets the page break policy for the frame/table to policy. More... | |
void | setPosition (Position f) |
Sets the policy for positioning frames with this frame format. More... | |
void | setRightMargin (qreal margin) |
Sets the frame's right margin in pixels. More... | |
void | setTopMargin (qreal margin) |
Sets the frame's top margin in pixels. More... | |
void | setWidth (qreal width) |
Convenience method that sets the width of the frame's border rectangle's width to the specified fixed width. More... | |
void | setWidth (const QTextLength &length) |
Sets the frame's border rectangle's width. More... | |
qreal | topMargin () const |
Returns the width of the frame's top margin in pixels. More... | |
QTextLength | width () const |
Returns the width of the frame's border rectangle. More... | |
Public Functions inherited from QTextFormat | |
QBrush | background () const |
Returns the brush used to paint the document's background. More... | |
bool | boolProperty (int propertyId) const |
Returns the value of the property specified by propertyId. More... | |
QBrush | brushProperty (int propertyId) const |
Returns the value of the property given by propertyId; if the property isn't of QVariant::Brush type, Qt::NoBrush is returned instead. More... | |
void | clearBackground () |
Clears the brush used to paint the document's background. More... | |
void | clearForeground () |
Clears the brush used to paint the document's foreground. More... | |
void | clearProperty (int propertyId) |
Clears the value of the property given by propertyId. More... | |
QColor | colorProperty (int propertyId) const |
Returns the value of the property given by propertyId; if the property isn't of QVariant::Color type, an invalid color is returned instead. More... | |
qreal | doubleProperty (int propertyId) const |
Returns the value of the property specified by propertyId. More... | |
QBrush | foreground () const |
Returns the brush used to render foreground details, such as text, frame outlines, and table borders. More... | |
bool | hasProperty (int propertyId) const |
Returns true if the text format has a property with the given propertyId; otherwise returns false. More... | |
int | intProperty (int propertyId) const |
Returns the value of the property specified by propertyId. More... | |
bool | isBlockFormat () const |
Returns true if this text format is a BlockFormat ; otherwise returns false. More... | |
bool | isCharFormat () const |
Returns true if this text format is a CharFormat ; otherwise returns false. More... | |
bool | isFrameFormat () const |
Returns true if this text format is a FrameFormat ; otherwise returns false. More... | |
bool | isImageFormat () const |
Returns true if this text format is an image format; otherwise returns false. More... | |
bool | isListFormat () const |
Returns true if this text format is a ListFormat ; otherwise returns false. More... | |
bool | isTableCellFormat () const |
Returns true if this text format is a TableCellFormat ; otherwise returns false. More... | |
bool | isTableFormat () const |
Returns true if this text format is a TableFormat ; otherwise returns false. More... | |
bool | isValid () const |
Returns true if the format is valid (i. More... | |
Qt::LayoutDirection | layoutDirection () const |
Returns the document's layout direction. More... | |
QTextLength | lengthProperty (int propertyId) const |
Returns the value of the property given by propertyId. More... | |
QVector< QTextLength > | lengthVectorProperty (int propertyId) const |
Returns the value of the property given by propertyId. More... | |
void | merge (const QTextFormat &other) |
Merges the other format with this format; where there are conflicts the other format takes precedence. More... | |
int | objectIndex () const |
Returns the index of the format object, or -1 if the format object is invalid. More... | |
int | objectType () const |
Returns the text format's object type. More... | |
operator QVariant () const | |
Returns the text format as a QVariant. More... | |
bool | operator!= (const QTextFormat &rhs) const |
Returns true if this text format is different from the other text format. More... | |
QTextFormat & | operator= (const QTextFormat &rhs) |
Assigns the other text format to this text format, and returns a reference to this text format. More... | |
bool | operator== (const QTextFormat &rhs) const |
Returns true if this text format is the same as the other text format. More... | |
QPen | penProperty (int propertyId) const |
Returns the value of the property given by propertyId; if the property isn't of QVariant::Pen type, Qt::NoPen is returned instead. More... | |
QMap< int, QVariant > | properties () const |
Returns a map with all properties of this text format. More... | |
QVariant | property (int propertyId) const |
Returns the property specified by the given propertyId. More... | |
int | propertyCount () const |
Returns the number of properties stored in the format. More... | |
QTextFormat () | |
Creates a new text format with an InvalidFormat . More... | |
QTextFormat (int type) | |
Creates a new text format of the given type. More... | |
QTextFormat (const QTextFormat &rhs) | |
Creates a new text format with the same attributes as the other text format. More... | |
void | setBackground (const QBrush &brush) |
Sets the brush use to paint the document's background to the brush specified. More... | |
void | setForeground (const QBrush &brush) |
Sets the foreground brush to the specified brush. More... | |
void | setLayoutDirection (Qt::LayoutDirection direction) |
Sets the document's layout direction to the specified direction. More... | |
void | setObjectIndex (int object) |
Sets the format object's object index. More... | |
void | setObjectType (int type) |
Sets the text format's object type to type. More... | |
void | setProperty (int propertyId, const QVariant &value) |
Sets the property specified by the propertyId to the given value. More... | |
void | setProperty (int propertyId, const QVector< QTextLength > &lengths) |
Sets the value of the property given by propertyId to value. More... | |
QString | stringProperty (int propertyId) const |
Returns the value of the property given by propertyId; if the property isn't of QVariant::String type, an empty string is returned instead. More... | |
QTextBlockFormat | toBlockFormat () const |
Returns this format as a block format. More... | |
QTextCharFormat | toCharFormat () const |
Returns this format as a character format. More... | |
QTextFrameFormat | toFrameFormat () const |
Returns this format as a frame format. More... | |
QTextImageFormat | toImageFormat () const |
Returns this format as an image format. More... | |
QTextListFormat | toListFormat () const |
Returns this format as a list format. More... | |
QTextTableCellFormat | toTableCellFormat () const |
Returns this format as a table cell format. More... | |
QTextTableFormat | toTableFormat () const |
Returns this format as a table format. More... | |
int | type () const |
Returns the type of this format. More... | |
~QTextFormat () | |
Destroys this text format. More... | |
Protected Functions | |
QTextFrameFormat (const QTextFormat &fmt) | |
Creates a new frame format with the same attributes as the given text format. More... | |
Friends | |
class | QTextFormat |
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.
Definition at line 727 of file qtextformat.h.
This enum describes different border styles for the text frame.
Definition at line 742 of file qtextformat.h.
This enum describes how a frame is located relative to the surrounding text.
Enumerator | |
---|---|
InFlow | |
FloatLeft | |
FloatRight |
Definition at line 734 of file qtextformat.h.
QTextFrameFormat::QTextFrameFormat | ( | ) |
Constructs a text frame format object with the default properties.
Definition at line 2863 of file qtextformat.cpp.
|
explicitprotected |
Creates a new frame format with the same attributes as the given text format.
Definition at line 2879 of file qtextformat.cpp.
|
inline |
Returns the width of the border in pixels.
Definition at line 762 of file qtextformat.h.
Referenced by QTextHtmlExporter::emitTable(), QTextHtmlExporter::emitTextFrame(), and QTextDocumentLayoutPrivate::layoutFrame().
|
inline |
Returns the brush used for the frame's border.
Definition at line 767 of file qtextformat.h.
Referenced by QTextDocumentLayoutPrivate::drawFrameDecoration(), QTextDocumentLayoutPrivate::drawTableCell(), and QTextHtmlExporter::emitFrameStyle().
|
inline |
Returns the style of the frame's border.
Definition at line 772 of file qtextformat.h.
Referenced by QTextDocumentLayoutPrivate::drawFrameDecoration(), QTextDocumentLayoutPrivate::drawTableCell(), and QTextHtmlExporter::emitFrameStyle().
qreal QTextFrameFormat::bottomMargin | ( | ) | const |
Returns the width of the frame's bottom margin in pixels.
Definition at line 3045 of file qtextformat.cpp.
Referenced by QGraphicsTextItemPrivate::_q_mouseOnEdge(), QTextHtmlExporter::emitFrameStyle(), QTextDocumentLayoutPrivate::layoutFrame(), QTextHtmlImporter::scanTable(), and QTextOdfWriter::writeFrameFormat().
|
inline |
Returns the height of the frame's border rectangle.
Definition at line 803 of file qtextformat.h.
Referenced by QTextHtmlExporter::emitTextFrame(), and QTextDocumentLayoutPrivate::layoutFrame().
|
inline |
Returns true if the format description is valid; otherwise returns false.
Definition at line 732 of file qtextformat.h.
qreal QTextFrameFormat::leftMargin | ( | ) | const |
Returns the width of the frame's left margin in pixels.
Definition at line 3071 of file qtextformat.cpp.
Referenced by QGraphicsTextItemPrivate::_q_mouseOnEdge(), QTextHtmlExporter::emitFrameStyle(), QTextDocumentLayoutPrivate::layoutFrame(), QTextHtmlImporter::scanTable(), and QTextOdfWriter::writeFrameFormat().
|
inline |
Returns the width of the frame's external margin in pixels.
Definition at line 776 of file qtextformat.h.
Referenced by bottomMargin(), leftMargin(), rightMargin(), and topMargin().
|
inline |
Returns the width of the frame's internal padding in pixels.
Definition at line 792 of file qtextformat.h.
Referenced by QTextDocumentLayoutPrivate::layoutFrame().
|
inline |
Returns the currently set page break policy for the frame/table.
The default is QTextFormat::PageBreak_Auto.
Definition at line 808 of file qtextformat.h.
Referenced by QTextHtmlExporter::emitFrameStyle(), and QTextDocumentLayoutPrivate::layoutFlow().
|
inline |
Returns the positioning policy for frames with this frame format.
Definition at line 758 of file qtextformat.h.
Referenced by QTextDocumentLayoutPrivate::drawFlow(), QTextHtmlExporter::emitFrameStyle(), QTextDocumentLayoutPrivate::floatMargins(), QTextDocumentLayoutPrivate::hitTest(), QTextDocumentLayoutPrivate::layoutCell(), QTextDocumentLayoutPrivate::layoutFlow(), QTextDocumentLayoutPrivate::positionFloat(), and QTextDocumentLayout::resizeInlineObject().
qreal QTextFrameFormat::rightMargin | ( | ) | const |
Returns the width of the frame's right margin in pixels.
Definition at line 3097 of file qtextformat.cpp.
Referenced by QGraphicsTextItemPrivate::_q_mouseOnEdge(), QTextHtmlExporter::emitFrameStyle(), QTextDocumentLayoutPrivate::layoutFrame(), QTextHtmlImporter::scanTable(), and QTextOdfWriter::writeFrameFormat().
|
inline |
Sets the width (in pixels) of the frame's border.
Definition at line 816 of file qtextformat.h.
Referenced by QTextTableFormat::QTextTableFormat(), and QTextHtmlImporter::scanTable().
|
inline |
Sets the brush used for the frame's border.
Definition at line 765 of file qtextformat.h.
Referenced by QTextFrameFormat(), and QTextHtmlImporter::scanTable().
|
inline |
Sets the style of the frame's border.
Definition at line 770 of file qtextformat.h.
Referenced by QTextFrameFormat(), and QTextHtmlImporter::scanTable().
|
inline |
Sets the frame's bottom margin in pixels.
Definition at line 833 of file qtextformat.h.
Referenced by QTextHtmlImporter::scanTable().
|
inline |
Sets the frame's height.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
Definition at line 825 of file qtextformat.h.
Referenced by QTextHtmlImporter::scanTable().
|
inline |
Sets the frame's height.
Definition at line 827 of file qtextformat.h.
|
inline |
Sets the frame's left margin in pixels.
Definition at line 836 of file qtextformat.h.
Referenced by QTextHtmlImporter::scanTable().
void QTextFrameFormat::setMargin | ( | qreal | margin | ) |
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.
Definition at line 2981 of file qtextformat.cpp.
Referenced by QLabelPrivate::ensureTextLayouted(), QTextDocumentPrivate::rootFrame(), QTextDocument::setDocumentMargin(), and QTextHtmlExporter::toHtml().
|
inline |
Sets the width of the frame's internal padding in pixels.
Definition at line 819 of file qtextformat.h.
|
inline |
Sets the page break policy for the frame/table to policy.
Definition at line 806 of file qtextformat.h.
Referenced by QTextHtmlImporter::scanTable().
|
inline |
Sets the policy for positioning frames with this frame format.
Definition at line 756 of file qtextformat.h.
Referenced by QTextCursor::insertImage(), and QTextHtmlImporter::scanTable().
|
inline |
Sets the frame's right margin in pixels.
Definition at line 839 of file qtextformat.h.
Referenced by QTextHtmlImporter::scanTable().
|
inline |
Sets the frame's top margin in pixels.
Definition at line 830 of file qtextformat.h.
Referenced by QTextHtmlImporter::scanTable().
|
inline |
Convenience method that sets the width of the frame's border rectangle's width to the specified fixed width.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
Definition at line 822 of file qtextformat.h.
Referenced by QTextHtmlImporter::scanTable().
|
inline |
Sets the frame's border rectangle's width.
Definition at line 796 of file qtextformat.h.
qreal QTextFrameFormat::topMargin | ( | ) | const |
Returns the width of the frame's top margin in pixels.
Definition at line 3019 of file qtextformat.cpp.
Referenced by QGraphicsTextItemPrivate::_q_mouseOnEdge(), QTextHtmlExporter::emitFrameStyle(), QTextDocumentLayoutPrivate::layoutFrame(), QTextHtmlImporter::scanTable(), and QTextOdfWriter::writeFrameFormat().
|
inline |
Returns the width of the frame's border rectangle.
Definition at line 798 of file qtextformat.h.
Referenced by QTextHtmlExporter::emitTable(), QTextHtmlExporter::emitTextFrame(), QTextDocumentLayoutPrivate::layoutFrame(), and QTextDocumentLayoutPrivate::layoutTable().
|
friend |
Definition at line 813 of file qtextformat.h.