Класс QTableWidgetItem

Класс QTableWidgetItem предоставляет элемент для использования с классом QTableWidget. Подробнее...

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

Типы public

Функции public

Связанные нечлены

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

Элементы таблицы используются для хранения фрагментов информации для виджетов таблиц. Элементы обычно содержат текст, значки или флажки.

Класс QTableWidgetItem является классом-оберткой, который заменяет класс QTableItem в Qt 3. Он предоставляет элемент для использования с классом QTableWidget.

Элементы верхнего уровня создаются без родителя, затем вставляются в позицию, заданную парой номера строки и номера столбца:

    QTableWidgetItem *newItem = new QTableWidgetItem(tr("%1").arg(
        pow(row, column+1)));
    tableWidget->setItem(row, column, newItem);

Каждый элемент может иметь свою собственную кисть фона, которая устанавливается с помощью функции setBackground(). Текущую кисть фона можно найти с помощью background(). Метка текста для каждого элемента может отображаться с собственным шрифтом и кистью. Эти параметры задаются с помощью функций setFont() и setForeground(), и считываются с помощью font() и foreground().

По умолчанию элементы включены, редактируемы, выбираемы, изменяемы и могут использоваться как в качестве источника, так и в качестве пункта назначения операции перетаскивания. Флаги каждого элемента могут быть изменены путем вызова setFlags() с соответствующим значением (см. Qt::ItemFlags). Изменяемые элементы могут быть отмечены и сняты с отметки с помощью функции setCheckState(). Соответствующая функция checkState() указывает, помечен ли элемент в данный момент.

Наследование

При наследовании от QTableWidgetItem для предоставления настраиваемых элементов, можно определять новые типы для них, чтобы отличать их от стандартных элементов. Конструкторы подклассов, требующих этой функции, должны вызывать конструктор базового класса со значением нового типа, равным или большим, чем UserType.

См. также QTableWidget, Моделирование/Программирование представления, QListWidgetItem и QTreeWidgetItem.

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

enum QTableWidgetItem::ItemType

Этот перечисление описывает типы, используемые для описания элементов виджета таблицы.

Вы можете определить новые пользовательские типы в подклассах QTableWidgetItem, чтобы гарантировать, что настраиваемые элементы обрабатывались специально.

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

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

QTableWidgetItem::QTableWidgetItem(const QTableWidgetItem &other)

Создает копию other. Обратите внимание, что type() и tableWidget() не копируются.

Эта функция полезна при реализации clone().

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

См. также data() и flags().

QTableWidgetItem::QTableWidgetItem(const QIcon &icon, const QString &text, int type = Type)

Создает элемент таблицы с заданным icon и text.

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

QTableWidgetItem::QTableWidgetItem(const QString &text, int type = Type)

Создает элемент таблицы с заданным text.

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

QTableWidgetItem::QTableWidgetItem(int type = Type)

Создает элемент таблицы заданного type, который не принадлежит ни одной таблице.

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

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

Присваивает данные и флаги other этому элементу. Обратите внимание, что type() и tableWidget() не копируются.

Эта функция полезна при реализации clone().

См. также data() и flags().

[virtual] QTableWidgetItem::~QTableWidgetItem()

Удаляет элемент таблицы.

QBrush QTableWidgetItem::background() const

Возвращает кисть, используемую для отрисовки фона элемента.

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

См. также setBackground() и foreground().

Qt::CheckState QTableWidgetItem::checkState() const

Возвращает состояние выделения элемента таблицы.

См. также setCheckState() и flags().

[virtual] QTableWidgetItem *QTableWidgetItem::clone() const

Создает копию элемента.

int QTableWidgetItem::column() const

Возвращает номер столбца элемента в таблице. Если элемент не находится в таблице, эта функция вернет -1.

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

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

[virtual] QVariant QTableWidgetItem::data(int role) const

Возвращает данные элемента для заданного role.

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

Qt::ItemFlags QTableWidgetItem::flags() const

Возвращает флаги, используемые для описания элемента. Они определяют, можно ли проверять, редактировать и выбирать элемент.

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

QFont QTableWidgetItem::font() const

Возвращает шрифт, используемый для отображения текста элемента.

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

QBrush QTableWidgetItem::foreground() const

Возвращает кисть, используемую для отрисовки переднего плана элемента (например, текста).

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

См. также setForeground() и background().

QIcon QTableWidgetItem::icon() const

Возвращает значок элемента.

См. также setIcon() и iconSize.

bool QTableWidgetItem::isSelected() const

Возвращает true , если элемент выделен, в противном случае возвращает false.

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

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

[virtual] void QTableWidgetItem::read(QDataStream &in)

Считывает элемент из потока in.

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

int QTableWidgetItem::row() const

Возвращает номер строки элемента в таблице. Если элемент не находится в таблице, эта функция вернет -1.

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

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

void QTableWidgetItem::setBackground(const QBrush &brush)

Устанавливает кисть фона элемента на заданную brush.

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

См. также background() и setForeground().

void QTableWidgetItem::setCheckState(Qt::CheckState state)

Устанавливает состояние выбора элемента таблицы в state.

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

[virtual] void QTableWidgetItem::setData(int role, const QVariant &value)

Устанавливает данные элемента для заданного role на указанное value.

Примечание: В реализации по умолчанию Qt::EditRole и Qt::DisplayRole считаются ссылками на одни и те же данные.

См. также Qt::ItemDataRole и data().

void QTableWidgetItem::setFlags(Qt::ItemFlags flags)

Устанавливает флаги элемента на заданные flags. Они определяют, можно ли выбрать или изменить элемент.

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

void QTableWidgetItem::setFont(const QFont &font)

Устанавливает шрифт для отображения текста элемента на заданный font.

См. также font(), setText() и setForeground().

void QTableWidgetItem::setForeground(const QBrush &brush)

Устанавливает кисть переднего плана элемента на заданную brush.

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

См. также foreground() и setBackground().

void QTableWidgetItem::setIcon(const QIcon &icon)

Устанавливает значок элемента на заданный icon.

См. также icon(), setText() и iconSize.

void QTableWidgetItem::setSelected(bool select)

Устанавливает состояние выделения элемента на select.

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

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

void QTableWidgetItem::setSizeHint(const QSize &size)

Устанавливает размер подсказки для элемента таблицы на size. Если подсказка размера не задана, делегат элемента вычислит подсказку размера на основе данных элемента.

Эта функция была представлена в Qt 4.1.

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

void QTableWidgetItem::setStatusTip(const QString &statusTip)

Устанавливает подсказку состояния для элемента таблицы на текст, указанный в statusTip. Для работы этой функции необходимо включить отслеживание нажатий мыши в QTableWidget.

См. также statusTip(), setToolTip() и setWhatsThis().

void QTableWidgetItem::setText(const QString &text)

Устанавливает текст элемента на указанный text.

См. также text(), setFont() и setForeground().

void QTableWidgetItem::setTextAlignment(int alignment)

Устанавливает выравнивание текста элемента на указанное alignment.

См. также textAlignment() и Qt::Alignment.

void QTableWidgetItem::setToolTip(const QString &toolTip)

Устанавливает всплывающую подсказку элемента на указанную строку toolTip.

См. также toolTip(), setStatusTip() и setWhatsThis().

void QTableWidgetItem::setWhatsThis(const QString &whatsThis)

Устанавливает подсказку справки элемента "Что это?" на строку, указанную в whatsThis.

См. также whatsThis(), setStatusTip() и setToolTip().

QSize QTableWidgetItem::sizeHint() const

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

Эта функция была представлена в Qt 4.1.

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

QString QTableWidgetItem::statusTip() const

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

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

QTableWidget *QTableWidgetItem::tableWidget() const

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

QString QTableWidgetItem::text() const

Возвращает текст элемента.

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

int QTableWidgetItem::textAlignment() const

Возвращает выравнивание текста элемента.

См. также setTextAlignment() и Qt::Alignment.

QString QTableWidgetItem::toolTip() const

Возвращает всплывающую подсказку элемента.

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

int QTableWidgetItem::type() const

Возвращает тип, переданный конструктору QTableWidgetItem.

QString QTableWidgetItem::whatsThis() const

Возвращает подсказку справки элемента "Что это?".

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

void QTableWidgetItem::write(QDataStream &out) const

Записывает элемент в поток out.

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

bool QTableWidgetItem::operator<(const QTableWidgetItem &other) const

Возвращает true, если элемент меньше, чем элемент other; в противном случае возвращает false.