Struct qt_gui::QTextTableCell
source · #[repr(C)]pub struct QTextTableCell { /* private fields */ }
Expand description
The QTextTableCell class represents the properties of a cell in a QTextTable.
C++ class: QTextTableCell
.
The QTextTableCell class represents the properties of a cell in a QTextTable.
Table cells are pieces of document structure that belong to a table. The table orders cells into particular rows and columns; cells can also span multiple columns and rows.
Cells are usually created when a table is inserted into a document with QTextCursor::insertTable(), but they are also created and destroyed when a table is resized.
Cells contain information about their location in a table; you can obtain the row() and column() numbers of a cell, and its rowSpan() and columnSpan().
The format() of a cell describes the default character format of its contents. The firstCursorPosition() and lastCursorPosition() functions are used to obtain the extent of the cell in the document.
Implementations§
source§impl QTextTableCell
impl QTextTableCell
sourcepub unsafe fn begin(&self) -> CppBox<Iterator>
pub unsafe fn begin(&self) -> CppBox<Iterator>
Returns a frame iterator pointing to the beginning of the table's cell.
Calls C++ function: QTextFrame::iterator QTextTableCell::begin() const
.
Returns a frame iterator pointing to the beginning of the table’s cell.
See also end().
sourcepub unsafe fn column(&self) -> c_int
pub unsafe fn column(&self) -> c_int
Returns the number of the column in the table that contains this cell.
Calls C++ function: int QTextTableCell::column() const
.
Returns the number of the column in the table that contains this cell.
See also row().
sourcepub unsafe fn column_span(&self) -> c_int
pub unsafe fn column_span(&self) -> c_int
Returns the number of columns this cell spans. The default is 1.
Calls C++ function: int QTextTableCell::columnSpan() const
.
Returns the number of columns this cell spans. The default is 1.
See also rowSpan().
sourcepub unsafe fn copy_from(
&self,
o: impl CastInto<Ref<QTextTableCell>>
) -> Ref<QTextTableCell>
pub unsafe fn copy_from( &self, o: impl CastInto<Ref<QTextTableCell>> ) -> Ref<QTextTableCell>
Assigns the other table cell to this table cell.
Calls C++ function: QTextTableCell& QTextTableCell::operator=(const QTextTableCell& o)
.
Assigns the other table cell to this table cell.
sourcepub unsafe fn end(&self) -> CppBox<Iterator>
pub unsafe fn end(&self) -> CppBox<Iterator>
Returns a frame iterator pointing to the end of the table's cell.
Calls C++ function: QTextFrame::iterator QTextTableCell::end() const
.
Returns a frame iterator pointing to the end of the table’s cell.
See also begin().
sourcepub unsafe fn first_cursor_position(&self) -> CppBox<QTextCursor>
pub unsafe fn first_cursor_position(&self) -> CppBox<QTextCursor>
Returns the first valid cursor position in this cell.
Calls C++ function: QTextCursor QTextTableCell::firstCursorPosition() const
.
Returns the first valid cursor position in this cell.
See also lastCursorPosition().
sourcepub unsafe fn first_position(&self) -> c_int
pub unsafe fn first_position(&self) -> c_int
Calls C++ function: int QTextTableCell::firstPosition() const
.
sourcepub unsafe fn format(&self) -> CppBox<QTextCharFormat>
pub unsafe fn format(&self) -> CppBox<QTextCharFormat>
Returns the cell's character format.
Calls C++ function: QTextCharFormat QTextTableCell::format() const
.
Returns the cell’s character format.
See also setFormat().
sourcepub unsafe fn is_valid(&self) -> bool
pub unsafe fn is_valid(&self) -> bool
Returns true
if this is a valid table cell; otherwise returns false.
Calls C++ function: bool QTextTableCell::isValid() const
.
Returns true
if this is a valid table cell; otherwise returns false.
sourcepub unsafe fn last_cursor_position(&self) -> CppBox<QTextCursor>
pub unsafe fn last_cursor_position(&self) -> CppBox<QTextCursor>
Returns the last valid cursor position in this cell.
Calls C++ function: QTextCursor QTextTableCell::lastCursorPosition() const
.
Returns the last valid cursor position in this cell.
See also firstCursorPosition().
sourcepub unsafe fn last_position(&self) -> c_int
pub unsafe fn last_position(&self) -> c_int
Calls C++ function: int QTextTableCell::lastPosition() const
.
sourcepub unsafe fn new() -> CppBox<QTextTableCell>
pub unsafe fn new() -> CppBox<QTextTableCell>
Constructs an invalid table cell.
Calls C++ function: [constructor] void QTextTableCell::QTextTableCell()
.
Constructs an invalid table cell.
See also isValid().
sourcepub unsafe fn new_copy(
o: impl CastInto<Ref<QTextTableCell>>
) -> CppBox<QTextTableCell>
pub unsafe fn new_copy( o: impl CastInto<Ref<QTextTableCell>> ) -> CppBox<QTextTableCell>
Copy constructor. Creates a new QTextTableCell object based on the other cell.
Calls C++ function: [constructor] void QTextTableCell::QTextTableCell(const QTextTableCell& o)
.
Copy constructor. Creates a new QTextTableCell object based on the other cell.
sourcepub unsafe fn row(&self) -> c_int
pub unsafe fn row(&self) -> c_int
Returns the number of the row in the table that contains this cell.
Calls C++ function: int QTextTableCell::row() const
.
Returns the number of the row in the table that contains this cell.
See also column().
sourcepub unsafe fn row_span(&self) -> c_int
pub unsafe fn row_span(&self) -> c_int
Returns the number of rows this cell spans. The default is 1.
Calls C++ function: int QTextTableCell::rowSpan() const
.
Returns the number of rows this cell spans. The default is 1.
See also columnSpan().
sourcepub unsafe fn set_format(&self, format: impl CastInto<Ref<QTextCharFormat>>)
pub unsafe fn set_format(&self, format: impl CastInto<Ref<QTextCharFormat>>)
Sets the cell's character format to format. This can for example be used to change the background color of the entire cell:
Calls C++ function: void QTextTableCell::setFormat(const QTextCharFormat& format)
.
Sets the cell’s character format to format. This can for example be used to change the background color of the entire cell:
QTextTableCell cell = table->cellAt(2, 3); QTextCharFormat format = cell.format(); format.setBackground(Qt::blue); cell.setFormat(format);
Note that the cell's row or column span cannot be changed through this function. You have to use QTextTable::mergeCells and QTextTable::splitCell instead.
This function was introduced in Qt 4.2.
See also format().
sourcepub unsafe fn table_cell_format_index(&self) -> c_int
pub unsafe fn table_cell_format_index(&self) -> c_int
Returns the index of the tableCell's format in the document's internal list of formats.
Calls C++ function: int QTextTableCell::tableCellFormatIndex() const
.
Returns the index of the tableCell’s format in the document’s internal list of formats.
This function was introduced in Qt 4.5.
See also QTextDocument::allFormats().
Trait Implementations§
source§impl Begin for QTextTableCell
impl Begin for QTextTableCell
source§impl CppDeletable for QTextTableCell
impl CppDeletable for QTextTableCell
source§impl End for QTextTableCell
impl End for QTextTableCell
source§impl PartialEq<Ref<QTextTableCell>> for QTextTableCell
impl PartialEq<Ref<QTextTableCell>> for QTextTableCell
source§fn eq(&self, other: &Ref<QTextTableCell>) -> bool
fn eq(&self, other: &Ref<QTextTableCell>) -> bool
Returns true
if this cell object and the other cell object describe the same cell; otherwise returns false
.
Calls C++ function: bool QTextTableCell::operator==(const QTextTableCell& other) const
.
Returns true
if this cell object and the other cell object describe the same cell; otherwise returns false
.