Материал из Wiki.crossplatform.ru

Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

[править] QTextTableCell Class Reference
^{[модуль QtGui ]}

The QTextTableCell class represents the properties of a cell in a QTextTable. Далее...

 #include <QTextTableCell>

• Список всех членов, включая унаследованные

[править] Открытые функции

• QTextTableCell ()
• QTextTableCell ( const QTextTableCell & other )
• ~QTextTableCell ()
• QTextFrame::iterator begin () const
• int column () const
• int columnSpan () const
• QTextFrame::iterator end () const
• QTextCursor firstCursorPosition () const
• QTextCharFormat format () const
• bool isValid () const
• QTextCursor lastCursorPosition () const
• int row () const
• int rowSpan () const
• void setFormat ( const QTextCharFormat & format )
• bool operator!= ( const QTextTableCell & other ) const
• QTextTableCell & operator= ( const QTextTableCell & other )
• bool operator== ( const QTextTableCell & other ) const

[править] Подробное описание

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.

See also QTextTable and QTextTableFormat.

[править] Описание функций-членов

[править]

QTextTableCell::QTextTableCell ()

Constructs an invalid table cell.

Смотрите также isValid().

[править]

QTextTableCell::QTextTableCell ( const QTextTableCell & other )

Copy constructor. Creates a new QTextTableCell object based on the other cell.

[править]

QTextTableCell::~QTextTableCell ()

Destroys the table cell.

[править]

QTextFrame::iterator QTextTableCell::begin () const

Returns a frame iterator pointing to the beginning of the table's cell.

See also end().

[править]

int QTextTableCell::column () const

Returns the number of the column in the table that contains this cell.

See also row().

[править]

int QTextTableCell::columnSpan () const

Returns the number of columns this cell spans. The default is 1.

See also rowSpan().

[править]

QTextFrame::iterator QTextTableCell::end () const

Returns a frame iterator pointing to the end of the table's cell.

See also begin().

[править]

QTextCursor QTextTableCell::firstCursorPosition () const

Returns the first valid cursor position in this cell.

See also lastCursorPosition().

[править]

QTextCharFormat QTextTableCell::format () const

Returns the cell's character format.

See also setFormat().

[править]

bool QTextTableCell::isValid () const

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

[править]

QTextCursor QTextTableCell::lastCursorPosition () const

Returns the last valid cursor position in this cell.

See also firstCursorPosition().

[править]

int QTextTableCell::row () const

Returns the number of the row in the table that contains this cell.

See also column().

[править]

int QTextTableCell::rowSpan () const

Returns the number of rows this cell spans. The default is 1.

See also columnSpan().

[править]

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.

Эта функция была введена в Qt 4.2.

See also format().

[править]

bool QTextTableCell::operator!= ( const QTextTableCell & other ) const

Returns true if this cell object and the other cell object describe different cells; otherwise returns false.

[править]

QTextTableCell & QTextTableCell::operator= ( const QTextTableCell & other )

Assigns the other table cell to this table cell.

[править]

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.