Struct qt_gui::QTextTableFormat

#[repr(C)]
pub struct QTextTableFormat { /* private fields */ }

The QTextTableFormat class provides formatting information for tables in a QTextDocument.

C++ class: QTextTableFormat.

C++ documentation:

The QTextTableFormat class provides formatting information for tables in a QTextDocument.

A table is a group of cells ordered into rows and columns. Each table contains at least one row and one column. Each cell contains a block. Tables in rich text documents are formatted using the properties defined in this class.

Tables are horizontally justified within their parent frame according to the table's alignment. This can be read with the alignment() function and set with setAlignment().

Cells within the table are separated by cell spacing. The number of pixels between cells is set with setCellSpacing() and read with cellSpacing(). The contents of each cell is surrounded by cell padding. The number of pixels between each cell edge and its contents is set with setCellPadding() and read with cellPadding().

The table's background color can be read with the background() function, and can be specified with setBackground(). The background color of each cell can be set independently, and will control the color of the cell within the padded area.

The table format also provides a way to constrain the widths of the columns in the table. Columns can be assigned a fixed width, a variable width, or a percentage of the available width (see QTextLength). The columns() function returns the number of columns with constraints, and the columnWidthConstraints() function returns the constraints defined for the table. These quantities can also be set by calling setColumnWidthConstraints() with a vector containing new constraints. If no constraints are required, clearColumnWidthConstraints() can be used to remove them.

Implementations

impl QTextTableFormat

pub unsafe fn alignment(&self) -> QFlags<AlignmentFlag>

Returns the table's alignment.

Calls C++ function: QFlags<Qt::AlignmentFlag> QTextTableFormat::alignment() const.

C++ documentation:

Returns the table’s alignment.

See also setAlignment().

pub unsafe fn border_collapse(&self) -> bool

Available on cpp_lib_version="5.14.0" only.

Returns true if borderCollapse is enabled.

Calls C++ function: bool QTextTableFormat::borderCollapse() const.

C++ documentation:

Returns true if borderCollapse is enabled.

This function was introduced in Qt 5.14.

See also setBorderCollapse().

pub unsafe fn cell_padding(&self) -> c_double

Returns the table's cell padding. This describes the distance between the border of a cell and its contents.

Calls C++ function: double QTextTableFormat::cellPadding() const.

C++ documentation:

Returns the table’s cell padding. This describes the distance between the border of a cell and its contents.

See also setCellPadding().

pub unsafe fn cell_spacing(&self) -> c_double

Returns the table's cell spacing. This describes the distance between adjacent cells.

Calls C++ function: double QTextTableFormat::cellSpacing() const.

C++ documentation:

Returns the table’s cell spacing. This describes the distance between adjacent cells.

See also setCellSpacing().

pub unsafe fn clear_column_width_constraints(&self)

Clears the column width constraints for the table.

Calls C++ function: void QTextTableFormat::clearColumnWidthConstraints().

C++ documentation:

Clears the column width constraints for the table.

See also columnWidthConstraints() and setColumnWidthConstraints().

pub unsafe fn column_width_constraints(&self) -> CppBox<QVectorOfQTextLength>

Returns a list of constraints used by this table format to control the appearance of columns in a table.

Calls C++ function: QVector<QTextLength> QTextTableFormat::columnWidthConstraints() const.

C++ documentation:

Returns a list of constraints used by this table format to control the appearance of columns in a table.

See also setColumnWidthConstraints().

pub unsafe fn columns(&self) -> c_int

Returns the number of columns specified by the table format.

Calls C++ function: int QTextTableFormat::columns() const.

C++ documentation:

Returns the number of columns specified by the table format.

pub unsafe fn copy_from( &self, other: impl CastInto<Ref<QTextTableFormat>> ) -> Ref<QTextTableFormat>

The QTextTableFormat class provides formatting information for tables in a QTextDocument.

Calls C++ function: QTextTableFormat& QTextTableFormat::operator=(const QTextTableFormat& other).

C++ documentation:

The QTextTableFormat class provides formatting information for tables in a QTextDocument.

A table is a group of cells ordered into rows and columns. Each table contains at least one row and one column. Each cell contains a block. Tables in rich text documents are formatted using the properties defined in this class.

Tables are horizontally justified within their parent frame according to the table's alignment. This can be read with the alignment() function and set with setAlignment().

Cells within the table are separated by cell spacing. The number of pixels between cells is set with setCellSpacing() and read with cellSpacing(). The contents of each cell is surrounded by cell padding. The number of pixels between each cell edge and its contents is set with setCellPadding() and read with cellPadding().

The table's background color can be read with the background() function, and can be specified with setBackground(). The background color of each cell can be set independently, and will control the color of the cell within the padded area.

The table format also provides a way to constrain the widths of the columns in the table. Columns can be assigned a fixed width, a variable width, or a percentage of the available width (see QTextLength). The columns() function returns the number of columns with constraints, and the columnWidthConstraints() function returns the constraints defined for the table. These quantities can also be set by calling setColumnWidthConstraints() with a vector containing new constraints. If no constraints are required, clearColumnWidthConstraints() can be used to remove them.

pub unsafe fn header_row_count(&self) -> c_int

Returns the number of rows in the table that define the header.

Calls C++ function: int QTextTableFormat::headerRowCount() const.

C++ documentation:

Returns the number of rows in the table that define the header.

This function was introduced in Qt 4.2.

See also setHeaderRowCount().

pub unsafe fn is_valid(&self) -> bool

Returns true if this table format is valid; otherwise returns false.

Calls C++ function: bool QTextTableFormat::isValid() const.

C++ documentation:

Returns true if this table format is valid; otherwise returns false.

pub unsafe fn new() -> CppBox<QTextTableFormat>

Constructs a new table format object.

Calls C++ function: [constructor] void QTextTableFormat::QTextTableFormat().

C++ documentation:

Constructs a new table format object.

pub unsafe fn new_copy( other: impl CastInto<Ref<QTextTableFormat>> ) -> CppBox<QTextTableFormat>

The QTextTableFormat class provides formatting information for tables in a QTextDocument.

Calls C++ function: [constructor] void QTextTableFormat::QTextTableFormat(const QTextTableFormat& other).

C++ documentation:

The QTextTableFormat class provides formatting information for tables in a QTextDocument.

A table is a group of cells ordered into rows and columns. Each table contains at least one row and one column. Each cell contains a block. Tables in rich text documents are formatted using the properties defined in this class.

Tables are horizontally justified within their parent frame according to the table's alignment. This can be read with the alignment() function and set with setAlignment().

Cells within the table are separated by cell spacing. The number of pixels between cells is set with setCellSpacing() and read with cellSpacing(). The contents of each cell is surrounded by cell padding. The number of pixels between each cell edge and its contents is set with setCellPadding() and read with cellPadding().

The table's background color can be read with the background() function, and can be specified with setBackground(). The background color of each cell can be set independently, and will control the color of the cell within the padded area.

The table format also provides a way to constrain the widths of the columns in the table. Columns can be assigned a fixed width, a variable width, or a percentage of the available width (see QTextLength). The columns() function returns the number of columns with constraints, and the columnWidthConstraints() function returns the constraints defined for the table. These quantities can also be set by calling setColumnWidthConstraints() with a vector containing new constraints. If no constraints are required, clearColumnWidthConstraints() can be used to remove them.

pub unsafe fn set_alignment(&self, alignment: QFlags<AlignmentFlag>)

Sets the table's alignment.

Calls C++ function: void QTextTableFormat::setAlignment(QFlags<Qt::AlignmentFlag> alignment).

C++ documentation:

Sets the table’s alignment.

See also alignment().

pub unsafe fn set_border_collapse(&self, border_collapse: bool)

Available on cpp_lib_version="5.14.0" only.

Enabling borderCollapse will have the following implications:

Calls C++ function: void QTextTableFormat::setBorderCollapse(bool borderCollapse).

C++ documentation:

Enabling borderCollapse will have the following implications:

• The borders and grid of the table will be rendered following the CSS table border-collapse: collapse rules
• Setting the border property to a minimum value of 1 will render a one pixel solid inner table grid using the borderBrush property and an outer border as specified
• The various border style properties of QTextTableCellFormat can be used to customize the grid and have precedence over the border and grid of the table
• The cellSpacing property will be ignored
• For print pagination:
  • Columns continued on a page will not have their top cell border rendered
  • Repeated header rows will always have their bottom cell border rendered

With borderCollapse disabled, cell borders can still be styled using QTextTableCellFormat but styling will be applied only within the cell's frame, which is probably not very useful in practice.

This function was introduced in Qt 5.14.

See also borderCollapse(), setBorder(), setBorderBrush(), setBorderStyle(), and QTextTableCellFormat.

pub unsafe fn set_cell_padding(&self, padding: c_double)

Sets the cell padding for the table. This determines the distance between the border of a cell and its contents.

Calls C++ function: void QTextTableFormat::setCellPadding(double padding).

C++ documentation:

Sets the cell padding for the table. This determines the distance between the border of a cell and its contents.

See also cellPadding().

pub unsafe fn set_cell_spacing(&self, spacing: c_double)

Sets the cell spacing for the table. This determines the distance between adjacent cells.

Calls C++ function: void QTextTableFormat::setCellSpacing(double spacing).

C++ documentation:

Sets the cell spacing for the table. This determines the distance between adjacent cells.

See also cellSpacing().

pub unsafe fn set_column_width_constraints( &self, constraints: impl CastInto<Ref<QVectorOfQTextLength>> )

Sets the column width constraints for the table.

Calls C++ function: void QTextTableFormat::setColumnWidthConstraints(const QVector<QTextLength>& constraints).

C++ documentation:

Sets the column width constraints for the table.

See also columnWidthConstraints() and clearColumnWidthConstraints().

pub unsafe fn set_columns(&self, columns: c_int)

Calls C++ function: void QTextTableFormat::setColumns(int columns).

pub unsafe fn set_header_row_count(&self, count: c_int)

Declares the first count rows of the table as table header. The table header rows get repeated when a table is broken across a page boundary.

Calls C++ function: void QTextTableFormat::setHeaderRowCount(int count).

C++ documentation:

Declares the first count rows of the table as table header. The table header rows get repeated when a table is broken across a page boundary.

This function was introduced in Qt 4.2.

See also headerRowCount().

Methods from Deref<Target = QTextFrameFormat>

pub unsafe fn border(&self) -> c_double

Returns the width of the border in pixels.

Calls C++ function: double QTextFrameFormat::border() const.

C++ documentation:

Returns the width of the border in pixels.

See also setBorder().

pub unsafe fn border_brush(&self) -> CppBox<QBrush>

Returns the brush used for the frame's border.

Calls C++ function: QBrush QTextFrameFormat::borderBrush() const.

C++ documentation:

Returns the brush used for the frame’s border.

This function was introduced in Qt 4.3.

See also setBorderBrush().

pub unsafe fn border_style(&self) -> BorderStyle

Returns the style of the frame's border.

Calls C++ function: QTextFrameFormat::BorderStyle QTextFrameFormat::borderStyle() const.

C++ documentation:

Returns the style of the frame’s border.

This function was introduced in Qt 4.3.

See also setBorderStyle().

pub unsafe fn bottom_margin(&self) -> c_double

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

Calls C++ function: double QTextFrameFormat::bottomMargin() const.

C++ documentation:

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

This function was introduced in Qt 4.3.

See also setBottomMargin().

pub unsafe fn copy_from( &self, other: impl CastInto<Ref<QTextFrameFormat>> ) -> Ref<QTextFrameFormat>

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

Calls C++ function: QTextFrameFormat& QTextFrameFormat::operator=(const QTextFrameFormat& other).

C++ documentation:

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.

pub unsafe fn height(&self) -> CppBox<QTextLength>

Returns the height of the frame's border rectangle.

Calls C++ function: QTextLength QTextFrameFormat::height() const.

C++ documentation:

Returns the height of the frame’s border rectangle.

See also setHeight().

pub unsafe fn is_valid(&self) -> bool

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

Calls C++ function: bool QTextFrameFormat::isValid() const.

C++ documentation:

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

pub unsafe fn left_margin(&self) -> c_double

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

Calls C++ function: double QTextFrameFormat::leftMargin() const.

C++ documentation:

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

This function was introduced in Qt 4.3.

See also setLeftMargin().

pub unsafe fn margin(&self) -> c_double

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

Calls C++ function: double QTextFrameFormat::margin() const.

C++ documentation:

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

See also setMargin().

pub unsafe fn padding(&self) -> c_double

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

Calls C++ function: double QTextFrameFormat::padding() const.

C++ documentation:

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

See also setPadding().

pub unsafe fn page_break_policy(&self) -> QFlags<PageBreakFlag>

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

Calls C++ function: QFlags<QTextFormat::PageBreakFlag> QTextFrameFormat::pageBreakPolicy() const.

C++ documentation:

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().

pub unsafe fn position(&self) -> Position

Returns the positioning policy for frames with this frame format.

Calls C++ function: QTextFrameFormat::Position QTextFrameFormat::position() const.

C++ documentation:

Returns the positioning policy for frames with this frame format.

See also setPosition().

pub unsafe fn right_margin(&self) -> c_double

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

Calls C++ function: double QTextFrameFormat::rightMargin() const.

C++ documentation:

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

This function was introduced in Qt 4.3.

See also setRightMargin().

pub unsafe fn set_border(&self, border: c_double)

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

Calls C++ function: void QTextFrameFormat::setBorder(double border).

C++ documentation:

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

See also border().

pub unsafe fn set_border_brush(&self, brush: impl CastInto<Ref<QBrush>>)

Sets the brush used for the frame's border.

Calls C++ function: void QTextFrameFormat::setBorderBrush(const QBrush& brush).

C++ documentation:

Sets the brush used for the frame’s border.

This function was introduced in Qt 4.3.

See also borderBrush().

pub unsafe fn set_border_style(&self, style: BorderStyle)

Sets the style of the frame's border.

Calls C++ function: void QTextFrameFormat::setBorderStyle(QTextFrameFormat::BorderStyle style).

C++ documentation:

Sets the style of the frame’s border.

This function was introduced in Qt 4.3.

See also borderStyle().

pub unsafe fn set_bottom_margin(&self, margin: c_double)

Sets the frame's bottom margin in pixels.

Calls C++ function: void QTextFrameFormat::setBottomMargin(double margin).

C++ documentation:

Sets the frame’s bottom margin in pixels.

This function was introduced in Qt 4.3.

See also bottomMargin().

pub unsafe fn set_height_double(&self, height: c_double)

This is an overloaded function.

Calls C++ function: void QTextFrameFormat::setHeight(double height).

C++ documentation:

This is an overloaded function.

Sets the frame's height.

pub unsafe fn set_height_q_text_length( &self, height: impl CastInto<Ref<QTextLength>> )

Sets the frame's height.

Calls C++ function: void QTextFrameFormat::setHeight(const QTextLength& height).

C++ documentation:

Sets the frame’s height.

See also height().

pub unsafe fn set_left_margin(&self, margin: c_double)

Sets the frame's left margin in pixels.

Calls C++ function: void QTextFrameFormat::setLeftMargin(double margin).

C++ documentation:

Sets the frame’s left margin in pixels.

This function was introduced in Qt 4.3.

See also leftMargin().

pub unsafe fn set_margin(&self, margin: c_double)

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.

Calls C++ function: void QTextFrameFormat::setMargin(double margin).

C++ documentation:

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().

pub unsafe fn set_padding(&self, padding: c_double)

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

Calls C++ function: void QTextFrameFormat::setPadding(double padding).

C++ documentation:

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

See also padding().

pub unsafe fn set_page_break_policy(&self, flags: QFlags<PageBreakFlag>)

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

Calls C++ function: void QTextFrameFormat::setPageBreakPolicy(QFlags<QTextFormat::PageBreakFlag> flags).

C++ documentation:

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

This function was introduced in Qt 4.2.

See also pageBreakPolicy().

pub unsafe fn set_position(&self, f: Position)

Sets the policy for positioning frames with this frame format.

Calls C++ function: void QTextFrameFormat::setPosition(QTextFrameFormat::Position f).

C++ documentation:

Sets the policy for positioning frames with this frame format.

See also position().

pub unsafe fn set_right_margin(&self, margin: c_double)

Sets the frame's right margin in pixels.

Calls C++ function: void QTextFrameFormat::setRightMargin(double margin).

C++ documentation:

Sets the frame’s right margin in pixels.

This function was introduced in Qt 4.3.

See also rightMargin().

pub unsafe fn set_top_margin(&self, margin: c_double)

Sets the frame's top margin in pixels.

Calls C++ function: void QTextFrameFormat::setTopMargin(double margin).

C++ documentation:

Sets the frame’s top margin in pixels.

This function was introduced in Qt 4.3.

See also topMargin().

pub unsafe fn set_width_double(&self, width: c_double)

This is an overloaded function.

Calls C++ function: void QTextFrameFormat::setWidth(double width).

C++ documentation:

This is an overloaded function.

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

pub unsafe fn set_width_q_text_length( &self, length: impl CastInto<Ref<QTextLength>> )

Sets the frame's border rectangle's width.

Calls C++ function: void QTextFrameFormat::setWidth(const QTextLength& length).

C++ documentation:

Sets the frame’s border rectangle’s width.

See also width() and QTextLength.

pub unsafe fn top_margin(&self) -> c_double

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

Calls C++ function: double QTextFrameFormat::topMargin() const.

C++ documentation:

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

This function was introduced in Qt 4.3.

See also setTopMargin().

pub unsafe fn width(&self) -> CppBox<QTextLength>

Returns the width of the frame's border rectangle.

Calls C++ function: QTextLength QTextFrameFormat::width() const.

C++ documentation:

Returns the width of the frame’s border rectangle.

See also setWidth() and QTextLength.

Methods from Deref<Target = QTextFormat>

pub unsafe fn background(&self) -> CppBox<QBrush>

Returns the brush used to paint the document's background.

Calls C++ function: QBrush QTextFormat::background() const.

C++ documentation:

Returns the brush used to paint the document’s background.

See also setBackground(), clearBackground(), and foreground().

pub unsafe fn bool_property(&self, property_id: c_int) -> bool

Returns the value of the property specified by propertyId. If the property isn't of QTextFormat::Bool type, false is returned instead.

Calls C++ function: bool QTextFormat::boolProperty(int propertyId) const.

C++ documentation:

Returns the value of the property specified by propertyId. If the property isn’t of QTextFormat::Bool type, false is returned instead.

See also setProperty(), intProperty(), doubleProperty(), stringProperty(), colorProperty(), lengthProperty(), lengthVectorProperty(), and Property.

pub unsafe fn brush_property(&self, property_id: c_int) -> CppBox<QBrush>

Returns the value of the property given by propertyId; if the property isn't of QVariant::Brush type, Qt::NoBrush is returned instead.

Calls C++ function: QBrush QTextFormat::brushProperty(int propertyId) const.

C++ documentation:

Returns the value of the property given by propertyId; if the property isn’t of QVariant::Brush type, Qt::NoBrush is returned instead.

See also setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(), lengthProperty(), lengthVectorProperty(), and Property.

pub unsafe fn clear_background(&self)

Clears the brush used to paint the document's background. The default brush will be used.

Calls C++ function: void QTextFormat::clearBackground().

C++ documentation:

Clears the brush used to paint the document’s background. The default brush will be used.

See also background(), setBackground(), and clearForeground().

pub unsafe fn clear_foreground(&self)

Clears the brush used to paint the document's foreground. The default brush will be used.

Calls C++ function: void QTextFormat::clearForeground().

C++ documentation:

Clears the brush used to paint the document’s foreground. The default brush will be used.

See also foreground(), setForeground(), and clearBackground().

pub unsafe fn clear_property(&self, property_id: c_int)

Clears the value of the property given by propertyId

Calls C++ function: void QTextFormat::clearProperty(int propertyId).

C++ documentation:

Clears the value of the property given by propertyId

See also Property.

pub unsafe fn color_property(&self, property_id: c_int) -> CppBox<QColor>

Returns the value of the property given by propertyId; if the property isn't of QVariant::Color type, an invalid color is returned instead.

Calls C++ function: QColor QTextFormat::colorProperty(int propertyId) const.

C++ documentation:

Returns the value of the property given by propertyId; if the property isn’t of QVariant::Color type, an invalid color is returned instead.

See also setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(), lengthProperty(), lengthVectorProperty(), and Property.

pub unsafe fn copy_from( &self, rhs: impl CastInto<Ref<QTextFormat>> ) -> Ref<QTextFormat>

Assigns the other text format to this text format, and returns a reference to this text format.

Calls C++ function: QTextFormat& QTextFormat::operator=(const QTextFormat& rhs).

C++ documentation:

Assigns the other text format to this text format, and returns a reference to this text format.

pub unsafe fn double_property(&self, property_id: c_int) -> c_double

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.

Calls C++ function: double QTextFormat::doubleProperty(int propertyId) const.

C++ documentation:

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.

See also setProperty(), boolProperty(), intProperty(), stringProperty(), colorProperty(), lengthProperty(), lengthVectorProperty(), and Property.

pub unsafe fn foreground(&self) -> CppBox<QBrush>

Returns the brush used to render foreground details, such as text, frame outlines, and table borders.

Calls C++ function: QBrush QTextFormat::foreground() const.

C++ documentation:

Returns the brush used to render foreground details, such as text, frame outlines, and table borders.

See also setForeground(), clearForeground(), and background().

pub unsafe fn has_property(&self, property_id: c_int) -> bool

Returns true if the text format has a property with the given propertyId; otherwise returns false.

Calls C++ function: bool QTextFormat::hasProperty(int propertyId) const.

C++ documentation:

Returns true if the text format has a property with the given propertyId; otherwise returns false.

See also properties() and Property.

pub unsafe fn int_property(&self, property_id: c_int) -> c_int

Returns the value of the property specified by propertyId. If the property is not of QTextFormat::Integer type, 0 is returned instead.

Calls C++ function: int QTextFormat::intProperty(int propertyId) const.

C++ documentation:

Returns the value of the property specified by propertyId. If the property is not of QTextFormat::Integer type, 0 is returned instead.

See also setProperty(), boolProperty(), doubleProperty(), stringProperty(), colorProperty(), lengthProperty(), lengthVectorProperty(), and Property.

pub unsafe fn is_block_format(&self) -> bool

Returns true if this text format is a BlockFormat; otherwise returns false.

Calls C++ function: bool QTextFormat::isBlockFormat() const.

C++ documentation:

Returns true if this text format is a BlockFormat; otherwise returns false.

pub unsafe fn is_char_format(&self) -> bool

Returns true if this text format is a CharFormat; otherwise returns false.

Calls C++ function: bool QTextFormat::isCharFormat() const.

C++ documentation:

Returns true if this text format is a CharFormat; otherwise returns false.

pub unsafe fn is_empty(&self) -> bool

Returns true if the format does not store any properties; false otherwise.

Calls C++ function: bool QTextFormat::isEmpty() const.

C++ documentation:

Returns true if the format does not store any properties; false otherwise.

This function was introduced in Qt 5.3.

See also propertyCount() and properties().

pub unsafe fn is_frame_format(&self) -> bool

Returns true if this text format is a FrameFormat; otherwise returns false.

Calls C++ function: bool QTextFormat::isFrameFormat() const.

C++ documentation:

Returns true if this text format is a FrameFormat; otherwise returns false.

pub unsafe fn is_image_format(&self) -> bool

Returns true if this text format is an image format; otherwise returns false.

Calls C++ function: bool QTextFormat::isImageFormat() const.

C++ documentation:

Returns true if this text format is an image format; otherwise returns false.

pub unsafe fn is_list_format(&self) -> bool

Returns true if this text format is a ListFormat; otherwise returns false.

Calls C++ function: bool QTextFormat::isListFormat() const.

C++ documentation:

Returns true if this text format is a ListFormat; otherwise returns false.

pub unsafe fn is_table_cell_format(&self) -> bool

Returns true if this text format is a TableCellFormat; otherwise returns false.

Calls C++ function: bool QTextFormat::isTableCellFormat() const.

C++ documentation:

Returns true if this text format is a TableCellFormat; otherwise returns false.

This function was introduced in Qt 4.4.

pub unsafe fn is_table_format(&self) -> bool

Returns true if this text format is a TableFormat; otherwise returns false.

Calls C++ function: bool QTextFormat::isTableFormat() const.

C++ documentation:

Returns true if this text format is a TableFormat; otherwise returns false.

pub unsafe fn is_valid(&self) -> bool

Returns true if the format is valid (i.e. is not InvalidFormat); otherwise returns false.

Calls C++ function: bool QTextFormat::isValid() const.

C++ documentation:

Returns true if the format is valid (i.e. is not InvalidFormat); otherwise returns false.

pub unsafe fn layout_direction(&self) -> LayoutDirection

Returns the document's layout direction.

Calls C++ function: Qt::LayoutDirection QTextFormat::layoutDirection() const.

C++ documentation:

Returns the document’s layout direction.

See also setLayoutDirection().

pub unsafe fn length_property(&self, property_id: c_int) -> CppBox<QTextLength>

Returns the value of the property given by propertyId.

Calls C++ function: QTextLength QTextFormat::lengthProperty(int propertyId) const.

C++ documentation:

Returns the value of the property given by propertyId.

See also setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(), colorProperty(), lengthVectorProperty(), and Property.

pub unsafe fn length_vector_property( &self, property_id: c_int ) -> CppBox<QVectorOfQTextLength>

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.

Calls C++ function: QVector<QTextLength> QTextFormat::lengthVectorProperty(int propertyId) const.

C++ documentation:

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.

See also setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(), colorProperty(), lengthProperty(), and Property.

pub unsafe fn merge(&self, other: impl CastInto<Ref<QTextFormat>>)

Merges the other format with this format; where there are conflicts the other format takes precedence.

Calls C++ function: void QTextFormat::merge(const QTextFormat& other).

C++ documentation:

Merges the other format with this format; where there are conflicts the other format takes precedence.

pub unsafe fn object_index(&self) -> c_int

Returns the index of the format object, or -1 if the format object is invalid.

Calls C++ function: int QTextFormat::objectIndex() const.

C++ documentation:

Returns the index of the format object, or -1 if the format object is invalid.

See also setObjectIndex().

pub unsafe fn object_type(&self) -> c_int

Returns the text format's object type.

Calls C++ function: int QTextFormat::objectType() const.

C++ documentation:

Returns the text format’s object type.

See also ObjectTypes and setObjectType().

pub unsafe fn pen_property(&self, property_id: c_int) -> CppBox<QPen>

Returns the value of the property given by propertyId; if the property isn't of QVariant::Pen type, Qt::NoPen is returned instead.

Calls C++ function: QPen QTextFormat::penProperty(int propertyId) const.

C++ documentation:

Returns the value of the property given by propertyId; if the property isn’t of QVariant::Pen type, Qt::NoPen is returned instead.

See also setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(), lengthProperty(), lengthVectorProperty(), and Property.

pub unsafe fn properties(&self) -> CppBox<QMapOfIntQVariant>

Returns a map with all properties of this text format.

Calls C++ function: QMap<int, QVariant> QTextFormat::properties() const.

C++ documentation:

Returns a map with all properties of this text format.

pub unsafe fn property(&self, property_id: c_int) -> CppBox<QVariant>

Returns the property specified by the given propertyId.

Calls C++ function: QVariant QTextFormat::property(int propertyId) const.

C++ documentation:

Returns the property specified by the given propertyId.

See also setProperty() and Property.

pub unsafe fn property_count(&self) -> c_int

Returns the number of properties stored in the format.

Calls C++ function: int QTextFormat::propertyCount() const.

C++ documentation:

Returns the number of properties stored in the format.

This function was introduced in Qt 4.3.

pub unsafe fn set_background(&self, brush: impl CastInto<Ref<QBrush>>)

Sets the brush use to paint the document's background to the brush specified.

Calls C++ function: void QTextFormat::setBackground(const QBrush& brush).

C++ documentation:

Sets the brush use to paint the document’s background to the brush specified.

See also background(), clearBackground(), and setForeground().

pub unsafe fn set_foreground(&self, brush: impl CastInto<Ref<QBrush>>)

Sets the foreground brush to the specified brush. The foreground brush is mostly used to render text.

Calls C++ function: void QTextFormat::setForeground(const QBrush& brush).

C++ documentation:

Sets the foreground brush to the specified brush. The foreground brush is mostly used to render text.

See also foreground(), clearForeground(), and setBackground().

pub unsafe fn set_layout_direction(&self, direction: LayoutDirection)

Sets the document's layout direction to the specified direction.

Calls C++ function: void QTextFormat::setLayoutDirection(Qt::LayoutDirection direction).

C++ documentation:

Sets the document’s layout direction to the specified direction.

See also layoutDirection().

pub unsafe fn set_object_index(&self, object: c_int)

Sets the format object's object index.

Calls C++ function: void QTextFormat::setObjectIndex(int object).

C++ documentation:

Sets the format object’s object index.

See also objectIndex().

pub unsafe fn set_object_type(&self, type_: c_int)

Sets the text format's object type to type.

Calls C++ function: void QTextFormat::setObjectType(int type).

C++ documentation:

Sets the text format’s object type to type.

See also ObjectTypes and objectType().

pub unsafe fn set_property_int_q_variant( &self, property_id: c_int, value: impl CastInto<Ref<QVariant>> )

Sets the property specified by the propertyId to the given value.

Calls C++ function: void QTextFormat::setProperty(int propertyId, const QVariant& value).

C++ documentation:

Sets the property specified by the propertyId to the given value.

See also property() and Property.

pub unsafe fn set_property_int_q_vector_of_q_text_length( &self, property_id: c_int, lengths: impl CastInto<Ref<QVectorOfQTextLength>> )

Sets the value of the property given by propertyId to value.

Calls C++ function: void QTextFormat::setProperty(int propertyId, const QVector<QTextLength>& lengths).

C++ documentation:

Sets the value of the property given by propertyId to value.

See also lengthVectorProperty() and Property.

pub unsafe fn string_property(&self, property_id: c_int) -> CppBox<QString>

Returns the value of the property given by propertyId; if the property isn't of QVariant::String type, an empty string is returned instead.

Calls C++ function: QString QTextFormat::stringProperty(int propertyId) const.

C++ documentation:

Returns the value of the property given by propertyId; if the property isn’t of QVariant::String type, an empty string is returned instead.

See also setProperty(), boolProperty(), intProperty(), doubleProperty(), colorProperty(), lengthProperty(), lengthVectorProperty(), and Property.

pub unsafe fn swap(&self, other: impl CastInto<Ref<QTextFormat>>)

Swaps this text format with other. This function is very fast and never fails.

Calls C++ function: void QTextFormat::swap(QTextFormat& other).

C++ documentation:

Swaps this text format with other. This function is very fast and never fails.

This function was introduced in Qt 5.0.

pub unsafe fn to_block_format(&self) -> CppBox<QTextBlockFormat>

Returns this format as a block format.

Calls C++ function: QTextBlockFormat QTextFormat::toBlockFormat() const.

C++ documentation:

Returns this format as a block format.

pub unsafe fn to_char_format(&self) -> CppBox<QTextCharFormat>

Returns this format as a character format.

Calls C++ function: QTextCharFormat QTextFormat::toCharFormat() const.

C++ documentation:

Returns this format as a character format.

pub unsafe fn to_frame_format(&self) -> CppBox<QTextFrameFormat>

Returns this format as a frame format.

Calls C++ function: QTextFrameFormat QTextFormat::toFrameFormat() const.

C++ documentation:

Returns this format as a frame format.

pub unsafe fn to_image_format(&self) -> CppBox<QTextImageFormat>

Returns this format as an image format.

Calls C++ function: QTextImageFormat QTextFormat::toImageFormat() const.

C++ documentation:

Returns this format as an image format.

pub unsafe fn to_list_format(&self) -> CppBox<QTextListFormat>

Returns this format as a list format.

Calls C++ function: QTextListFormat QTextFormat::toListFormat() const.

C++ documentation:

Returns this format as a list format.

pub unsafe fn to_q_variant(&self) -> CppBox<QVariant>

Returns the text format as a QVariant

Calls C++ function: QVariant QTextFormat::operator QVariant() const.

C++ documentation:

Returns the text format as a QVariant

pub unsafe fn to_table_cell_format(&self) -> CppBox<QTextTableCellFormat>

Returns this format as a table cell format.

Calls C++ function: QTextTableCellFormat QTextFormat::toTableCellFormat() const.

C++ documentation:

Returns this format as a table cell format.

This function was introduced in Qt 4.4.

pub unsafe fn to_table_format(&self) -> CppBox<QTextTableFormat>

Returns this format as a table format.

Calls C++ function: QTextTableFormat QTextFormat::toTableFormat() const.

C++ documentation:

Returns this format as a table format.

pub unsafe fn type_(&self) -> c_int

Returns the type of this format.

Calls C++ function: int QTextFormat::type() const.

C++ documentation:

Returns the type of this format.

See also FormatType.

Trait Implementations

impl CppDeletable for QTextTableFormat

unsafe fn delete(&self)

The QTextTableFormat class provides formatting information for tables in a QTextDocument.

Calls C++ function: [destructor] void QTextTableFormat::~QTextTableFormat().

C++ documentation:

The QTextTableFormat class provides formatting information for tables in a QTextDocument.

A table is a group of cells ordered into rows and columns. Each table contains at least one row and one column. Each cell contains a block. Tables in rich text documents are formatted using the properties defined in this class.

Tables are horizontally justified within their parent frame according to the table's alignment. This can be read with the alignment() function and set with setAlignment().

Cells within the table are separated by cell spacing. The number of pixels between cells is set with setCellSpacing() and read with cellSpacing(). The contents of each cell is surrounded by cell padding. The number of pixels between each cell edge and its contents is set with setCellPadding() and read with cellPadding().

The table's background color can be read with the background() function, and can be specified with setBackground(). The background color of each cell can be set independently, and will control the color of the cell within the padded area.

The table format also provides a way to constrain the widths of the columns in the table. Columns can be assigned a fixed width, a variable width, or a percentage of the available width (see QTextLength). The columns() function returns the number of columns with constraints, and the columnWidthConstraints() function returns the constraints defined for the table. These quantities can also be set by calling setColumnWidthConstraints() with a vector containing new constraints. If no constraints are required, clearColumnWidthConstraints() can be used to remove them.

impl Deref for QTextTableFormat

fn deref(&self) -> &QTextFrameFormat

Calls C++ function: QTextFrameFormat* static_cast<QTextFrameFormat*>(QTextTableFormat* ptr).

type Target = QTextFrameFormat

The resulting type after dereferencing.

impl StaticDowncast<QTextTableFormat> for QTextFormat

unsafe fn static_downcast(ptr: Ptr<QTextFormat>) -> Ptr<QTextTableFormat>

Calls C++ function: QTextTableFormat* static_cast<QTextTableFormat*>(QTextFormat* ptr).

impl StaticDowncast<QTextTableFormat> for QTextFrameFormat

unsafe fn static_downcast(ptr: Ptr<QTextFrameFormat>) -> Ptr<QTextTableFormat>

Calls C++ function: QTextTableFormat* static_cast<QTextTableFormat*>(QTextFrameFormat* ptr).

impl StaticUpcast<QTextFormat> for QTextTableFormat

unsafe fn static_upcast(ptr: Ptr<QTextTableFormat>) -> Ptr<QTextFormat>

Calls C++ function: QTextFormat* static_cast<QTextFormat*>(QTextTableFormat* ptr).

impl StaticUpcast<QTextFrameFormat> for QTextTableFormat

unsafe fn static_upcast(ptr: Ptr<QTextTableFormat>) -> Ptr<QTextFrameFormat>

Calls C++ function: QTextFrameFormat* static_cast<QTextFrameFormat*>(QTextTableFormat* ptr).