Класс QTextTableCell

Класс QTextTableCell представляет свойства ячейки в QTextTable. Подробнее...

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

Примечание: Все функции в этом классе являются реентерабельными.

Открытые функции

Подробное описание

Класс QTextTableCell представляет свойства ячейки в QTextTable.

Ячейки таблицы — это элементы структуры документа, принадлежащие таблице. Таблица упорядочивает ячейки в определённые строки и столбцы; ячейки также могут охватывать несколько столбцов и строк.

Ячейки обычно создаются при вставке таблицы в документ с помощью QTextCursor::insertTable(), но они также создаются и уничтожаются при изменении размеров таблицы.

Ячейки содержат информацию о их расположении в таблице; вы можете получить номера строки (row()) и столбца (column()) ячейки, а также её диапазон строк (rowSpan()) и столбцов (columnSpan()).

Формат (format()) ячейки описывает формат символов по умолчанию её содержимого. Функции firstCursorPosition() и lastCursorPosition() используются для получения области ячейки в документе.

См. также QTextTable и QTextTableFormat.

Документация по членам-функциям

QTextTableCell::QTextTableCell()

Конструктор, создающий недействительную ячейку таблицы.

См. также isValid().

QTextTableCell::QTextTableCell(const QTextTableCell &other)

Копирующий конструктор. Создаёт новый объект QTextTableCell на основе ячейки other.

QTextTableCell::~QTextTableCell()

Уничтожает ячейку таблицы.

QTextFrame::iterator QTextTableCell::begin() const

Возвращает итератор QTextFrame, указывающий на начало ячейки таблицы.

См. также end().

int QTextTableCell::column() const

Возвращает номер столбца в таблице, содержащий эту ячейку.

См. также row().

int QTextTableCell::columnSpan() const

Возвращает количество столбцов, охватываемых этой ячейкой. По умолчанию — 1.

См. также rowSpan().

QTextFrame::iterator QTextTableCell::end() const

Возвращает итератор QTextFrame, указывающий на конец ячейки таблицы.

См. также begin().

QTextCursor QTextTableCell::firstCursorPosition() const

Возвращает первое допустимое положение курсора в этой ячейке.

См. также lastCursorPosition().

QTextCharFormat QTextTableCell::format() const

Возвращает формат символов ячейки.

См. также setFormat().

bool QTextTableCell::isValid() const

Возвращает true , если это действительная ячейка таблицы; в противном случае возвращает false.

QTextCursor QTextTableCell::lastCursorPosition() const

Возвращает последнее допустимое положение курсора в этой ячейке.

См. также firstCursorPosition().

int QTextTableCell::row() const

Возвращает номер строки в таблице, содержащий эту ячейку.

См. также column().

int QTextTableCell::rowSpan() const

Возвращает количество строк, охватываемых этой ячейкой. По умолчанию — 1.

См. также columnSpan().

void QTextTableCell::setFormat(const QTextCharFormat &format)

Устанавливает формат символов ячейки на format. Это, например, может быть использовано для изменения цвета фона всей ячейки:

QTextTableCell cell = table->cellAt(2, 3); QTextCharFormat format = cell.format(); format.setBackground(Qt::blue); cell.setFormat(format);

Обратите внимание, что размах строк или столбцов ячейки нельзя изменить с помощью этой функции. Используйте QTextTable::mergeCells и QTextTable::splitCell вместо этого.

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

См. также format().

int QTextTableCell::tableCellFormatIndex() const

Возвращает индекс формата ячейки таблицы в внутреннем списке форматов документа.

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

См. также QTextDocument::allFormats().

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

Возвращает true , если этот объект ячейки и объект ячейки other описывают разные ячейки; в противном случае возвращает false.

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

Присваивает ячейку таблицы other текущей ячейке таблицы.

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

Возвращает true , если этот объект ячейки и объект ячейки other описывают одну и ту же ячейку; в противном случае возвращает false.