Класс QTableWidgetItem

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

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

Типы

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

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

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

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

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

Класс 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(int type = Type)

Создаёт элемент таблицы заданного type, не относящийся ни к какой таблице.

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

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

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

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

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

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

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

QTableWidgetItem::QTableWidgetItem(const QTableWidgetItem &other)

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

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

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

См. также 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::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().

[virtual] void QTableWidgetItem::write(QDataStream &out) const

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

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

[virtual] bool QTableWidgetItem::operator<(const QTableWidgetItem &other) const

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

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

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

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

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